Skip to main content

Domain names

There can be several domain names mapped to application components in Radix.

The domain names are composed with information from the application, and the Radix cluster where the application is hosted:

  • component-name: The name of the component, e.g. frontend.
  • app-name: The name of the application, e.g. myapp.
  • env-name: The name of the environment where the component is deployed to, e.g. production.
  • cluster-name: Exists only in canonical name. The name of the underlying Kubernetes cluster used for hosting a specific Radix cluster, e.g. eu-18. This value can change, for example during upgrade of a Radix cluster. Domain names using this value should only be used for debugging purposes, and should never be used by end users/services.
  • cluster-dns-zone: The DNS zone for the Radix cluster where the application is hosted, e.g. radix.equinor.com, playground.radix.equinor.com.

Public name​

[component-name]-[app-name]-[env-name].[cluster-dns-zone]
  • Automatically allocated
  • Unique for each component in each environment

Examples:

  • serializer-oneapp-qa.radix.equinor.com
  • frontend-myapp-production.c2.radix.equinor.com
  • backend-myapp-production.playground.radix.equinor.com

App default alias​

[app-name].app.[cluster-dns-zone]

The app default alias is a convenience domain name to make it easier to publish and use your application. It points to a specific component and environment in your application, and allows a reasonable URL to be distributed to end users/services without the hassle of setting up external aliases.

Examples:

  • oneapp.app.radix.equinor.com
  • otherapp.app.c2.radix.equinor.com
  • myapp.app.playground.radix.equinor.com

App alias​

[subdomain].[cluster-dns-zone]

The app alias allows you to configure a custom subdomain in the [cluster-dns-zone] where the application is hosted. With the exception of a few reserved names, the rule is "first come, first served".

Examples:

  • oneapp.radix.equinor.com
  • otherapp.c2.radix.equinor.com
  • myapp.playground.radix.equinor.com

External alias​

[a valid external DNS name]

For ultimate customisation of your domain names, you can "bring your own" domain into Radix with an external alias. There is a detailed guide on how to configure this.

Examples:

  • myapp.equinor.com
  • www.mydomain.com

Canonical name​

[component-name]-[app-name]-[env-name].[cluster-name].[cluster-dns-zone]

The authoritative name for a specific component in a specific Kubernetes- and Radix-cluster.

  • Automatically allocated
  • One per component
warning

The canonical name should never be used by end users/services because [cluster-name] is not considered stable, and can change without warning.

Examples:

  • serializer-oneapp-qa.eu-18.radix.equinor.com
  • frontend-myapp-production.c2-11.c2.radix.equinor.com
  • backend-myapp-production.playground-92.playground.radix.equinor.com