Follow the steps below to configure your Org with a custom domain name. Domains are scoped to an Org and available to be used by all GVCs within the Org.
Workloads created within a GVC will automatically use the configured domain name for their endpoint URLs.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 subdomain (e.g., sub.example.com). Click Next
.
The required DNS entries will be displayed. These entries will need to be added by the person who is responsible
for maintaining the DNS for the domain. Once the DNS entries are added
and the changes have propagated across the Internet, click on the acceptance checkbox and click Create
.
The platform will verify the DNS entries and, if successful, add the Domain to your Org.
GVC
in the left menu. If you have multiple GVCs, verify that you are on the desired GVC.Domain
control. The list of available Domains will be shown.
Select the desired Domain and click Save
. All Workloads associated with this GVC
will now be deployed using this domain.Workloads
in the left menu and choose the Workload that was configured with the new Domain.Info
page. Notice that the Global Endpoint
URL is now using your domain and the Workload
name is the subdomain. This URL is automatically secured using TLS, load balanced, and DNS geo-routed to the nearest healthy location.
Clicking the Open
link will load the Workload in a new tab.The Canonical Endpoint
uses the default Control Plane domain cpln.app
and behaves the same as the Global Endpoint
. This URL can be
used for troubleshooting.
A workload can be configured to resolve directly to the subdomain by explicitly naming the workload index
. Refer to the Domain reference page for details.
Deployments
. This page shows the locations this Workload is
deployed to. Next to each location is the location specific URL for your Workload. Clicking the Open
link will load the Workload only in that location. This can be used for troubleshooting.Configuring your custom Domain name allows your Workload to be called using your branding in only a few steps. Once configured and associated with a GVC, the domain is used by all the Workloads within the GVC.