This quick start will demonstrate how to:
An apex domain, also known as a root domain, refers to a domain name that does not have any subdomain prefix (e.g., example.com).
Even if the apex domain isn't served at Control Plane, it needs to be created and configured for verification. This verification is done by adding a TXT record to DNS.
For this quick start guide, we'll set up the apex domain solely for verification, without configuring any routing.
Create a new Domain resource by using one of the following methods:
Domains
in the left menu and click New
, orCreate
dropdown in the upper right corner and select Domain
.The console will prompt for the domain name (e.g., example.com). Enter your apex domain and click Continue
.
The console will display the necessary TXT record to be added to DNS. Once you've added it, wait a few minutes for it to propagate online. Afterward, press the "I Configured DNS, Continue" button to allow Control Plane to verify the apex domain.
After verification, the console will default to show the configuration for Path Based Routing
. Since the apex domain will
not be routed to a workload, click the Edit
button to the right of DNS & ROUTING MODES
, then click Advanced Mode
,
then click Show More Options
.
Select None
for the Routing Mode
, and click Continue
.
The console will show the default setting for advanced mode. Scroll to the bottom of the page and click Create
.
Your APEX domain has been successfully created at Control Plane and sub-domains of the apex domain can now be created.
Control Plane provides two routing modes for directing requests to your domain. Read the descriptions below to determine the best mode for your needs.
Path Routing
Subdomain Routing
Create a new domain resource by using one of the following methods:
Domains
in the left menu and click New
, orCreate
dropdown in the upper right corner and select Domain
.The console will prompt for the desired domain name (e.g., path.example.com). Click Continue
.
The console will display the two routing modes. Click Use CNAME Record & Path Routing
.
The console will prompt you to select the GVC which contains the workload that the domain will be routed to.
Once the GVC is selected, the console will prompt you to select the workload. After the workload is selected, click Continue
.
The required CNAME record will be displayed. This record will need to be added by the person who is responsible for maintaining
DNS for the domain. After adding it, allow a few minutes for propagation across the Internet.
Click the I have created the DNS record
checkbox and then click Create
.
Control Plane won't verify the CNAME record. Certificate generation and routing will only commence once the record is added, and the chosen workload is in a ready state, capable of accepting requests from the Internet.
Tip: When adding the domain using GoDaddy, the minimum TTL is 600.
Your domain has been successfully created at Control Plane and will serve the selected workload on the path "/"
once DNS is updated and the certificates have been
generated.
Additional routes and advanced domain configuration options are available by clicking the Edit
link and clicking
the Advanced Mode
button. For additional details on path based routing, click here.
Create a new domain resource by using one of the following methods:
Domains
in the left menu and click New
, orCreate
dropdown in the upper right corner and select Domain
.The console will prompt for the desired domain name (e.g., sub.example.com). Click Continue
.
The console will display the two routing modes. Click Use NS Records & Subdomain Routing
.
The console will prompt you to select the GVC which contains the workloads that the domain will be routed to. Click Continue
.
The required NS records will be displayed. These records will need to be added by the person who is responsible for maintaining
DNS for the domain. After adding it, allow a few minutes for propagation across the Internet.
Click the I have created the DNS record
checkbox and then click Create
.
Control Plane won't verify the NS records. Certificate generation and routing will only commence once the records are added, and the chosen workload is in a ready state, capable of accepting requests from the Internet.
Tip: When adding the domain using GoDaddy, the minimum TTL is 600.
Your domain has been successfully created at Control Plane and will serve all the workloads within the GVC using the
pattern: https://WORKLOAD_NAME.sub.example.com
.
Advanced domain configuration options are available by clicking the Edit
link and
clicking the Advanced Mode
button. For additional details on subdomain routing, click here.
In the left menu, click on Workloads
and choose the workload specified during the domain configuration. If your org has multiple GVCs, ensure the GVC currently selected matches the one chosen during the domain configuration.
The Workload Info
page will be displayed which includes the list of URLs that will route to this workload.
cpln.app
and is typically used for troubleshooting or when there is no domain serving the workload.Click Deployments
. This page shows the providers this Workload is
deployed to. Next to each provider is the location specific URL. Clicking the Open
link will load the Workload only in that location. These links can be used for troubleshooting.
By taking the step to configure your custom domain name enables a secure and reliable pathway to access your Workload. This not only enhances the integrity and reliability of your operations but also ensures that every interaction is seamlessly aligned with the identity and branding of your organization. This practice fosters trust and consistency, especially when dealing with external stakeholders or customers who recognize and resonate with your brand's identity.