Route traffic for your domain to a Lightsail container service - Amazon Lightsail
PrerequisiteGet the default domain of your container serviceAdd a record to your domain's DNS zone

Route traffic for your domain to a Lightsail container service

You must point your registered domain names to your Amazon Lightsail container service after you enabled custom domains for your service. You do this by adding an alias record to the DNS zone of each of the domains specified on the certificates that you're using with your container service. All of the records that you add should point to the default domain (e.g., https://<ServiceName>.<RandomGUID>.<AWSRegion>.cs.amazonlightsail.com) of your container service.

In this guide, we provide you with the procedure to point your domains to your container service using a Lightsail DNS zone. For more information about Lightsail DNS zones, see DNS in Amazon Lightsail.

For more information about container services, see Container services.

Note

If you're using Route 53 to host the DNS of your domain, then you should add the alias record to the hosted zone of your domain in Route 53. For more information, see Routing traffic for a domain in Route 53 to an Amazon Lightsail container service.

Prerequisite

Before you get started, you should enable custom domains for your Lightsail container service. For more information, see Enabling and managing custom domains for your Amazon Lightsail container services.

Get the default domain of your container service

Complete the following procedure to get default domain name of your container service, which you specify when you add an alias record to the DNS of your domain.

  1. Sign in to the Lightsail console.

  2. On the Lightsail home page, choose the Containers tab.

  3. Choose the name of a container service for which want get the default domain name.

  4. In the header section of your container service management page, make note of your default domain name. Your container service default domain name is similar to <ServiceName>.<RandomGUID>.<AWSRegion>.cs.amazonlightsail.com.

    You must add this value as part of a canonical name (CNAME) record in the DNS of your domains. We recommend that you copy and paste this value into a text file that you can refer to later. For more information, see the following Add the CNAME records to your domain's DNS zone section of this guide.

Add a record to your domain's DNS zone

Complete the following procedure to add an address (A for IPv4 or AAAA for IPv6) record, or canonical (CNAME) record to your domain's DNS zone.

  1. On the Lightsail home page, choose the Domains & DNS tab.

  2. Under the DNS zones section of the page, choose the domain name to which you want to add the record that will direct traffic for your domain to your container service.

  3. Choose the DNS records tab.

  4. Complete one of the following steps depending on the current state of your DNS zone:

    • If you haven't added an A, AAAA, or CNAME record, choose Add record.

    • If you previously added an A, AAAA, or CNAME record, choose the edit icon next to the existing A, AAAA, or CNAME record listed on the page, and then skip to step 5 of this procedure.

  5. Choose A record, AAAA record, or CNAME record in the Record type dropdown menu.

    • Add an A record to map the apex of your domain (e.g., example.com) or a subdomain (e.g., www.example.com) to your container service under the IPv4 network.

    • Add an AAAA record to map the apex of your domain (e.g., example.com) or a subdomain (e.g., www.example.com) to your container service under the IPv6 network.

    • Add a CNAME record to map a subdomain (e.g., www.example.com) to the public domain (default DNS) of your container service.

  6. In the Record name text box, enter one of the following options:

    • For an A record or AAAA record, enter @ to route traffic for the apex of your domain (e.g., example.com) to your container service, or enter a subdomain (e.g., www) to route traffic for a subdomain (e.g., www.example.com) to your container service.

    • For a CNAME record, enter a subdomain (e.g., www) to route traffic for a subdomain (e.g., www.example.com) to your container service.

  7. Complete one of the following steps depending on the record you're adding:

    • For an A record or AAAA record, choose the name of your container service in the Resolves to text box.

    • For a CNAME record, enter the default domain name of your container service into the Maps to text box.

  8. Choose the save icon to save the record to your DNS zone.

    Repeat these steps to add additional DNS records for domains on your certificate that you are using with your container service. Allow time for changes to propagate through the Internet’s DNS. After a few minutes, you should see if your domain is pointing to your container service.