Skip to main content

Domain names

There can be several domain names mapped to application components in Radix. In general you will want to use the public name, but you should understand all options.

tip

Some domain names include a clusterEnvNamepace component. This varies depending on the type of cluster. In Radix there are two(three) cluster types; these are the values for clusterEnvNamepace in each type

  • platform (blank) - (eu-"weeknumber")
  • playground (playground) - (playground-"weeknumber")
  • (dev (dev))

Canonical name​

[componentName]-[appName]-[envName].[clusterName].[clusterEnvNamepace].radix.equinor.com

The authoritative name for a specific component in a specific cluster. The canonical name can be useful when debugging, however.

  • Always allocated
  • Automatically allocated
  • One per component

Examples:

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

Public name​

[componentName]-[appName]-[envName].[clusterEnvNamepace].radix.equinor.com
  • Automatically allocated
  • One per component

Examples:

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

App default alias​

[appName].app.[clusterEnvNamepace].radix.equinor.com

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 without the hassle of setting up external aliases.

Examples:

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

App alias​

[appName].[clusterEnvNamepace].radix.equinor.com

dnsAlias creates one or several DNS aliases in the form of <alias>.radix.equinor.com for the specified environment and component. There are few reserved aliases which cannot be used:

  • Difference from App default alias - it does not have app. domain before radix.equinor.com and there can be multiple aliases per application, per environment, per component
  • Defined in radixconfig.yaml

Examples:

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

External alias​

[whatever]

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:

  • cowabunga.equinor.com
  • cheap-domains-r-us.net
  • go0gle.com