Domains
Overview
Deployed workloads can be accessed using any domain names you own. Domains are scoped to an org.
GVCs can only be assigned to one domain name which are used by all workloads within the GVC.
If a domain is not selected, the default domain names are:
- Global and canonical endpoints:
cpln.app - Individual location endpoints:
controlplane.us
The GVC to domain name mapping can be changed at any time.
To deploy workloads with different domains, place them into multiple GVCs.
Configure a Domain
Refer to the Configure a Domain guide for additional details.
Configuration Notes
When initially adding a custom domain, the console will display the required DNS entries and verify that they were created and can be resolved.
If the DNS entries need to be recreated, the configuration page will show the required DNS entries. The system will not perform another verification.
Workload Endpoint Naming
When a custom domain is assigned to a GVC, the associated workload's global endpoint will follow the format:
WORKLOAD_NAME.SUB_DOMAIN.DOMAIN.EXTENSION
The system offers the ability to have a workload resolve to only the custom subdomain.
To accomplish this:
- The workload must be named
index. - The global endpoint of this workload will resolve to:
SUB_DOMAIN.DOMAIN.EXTENSTION.
Permissions
The permissions below are used to define policies together with one or more of the four principal types:
| Permission | Description | Implies |
|---|---|---|
| create | Create new domain | |
| delete | Delete a domain | |
| edit | Modify existing domains (only tags can be changed) | view, use |
| manage | Full access | create, delete, edit, manage, use, view |
| use | Allow a principal to use this domain | view |
| view | Read-only access |
Access Report
Displays the permissions granted to principals for the domain.
CLI
To view the CLI documentation for domains, click here