diff --git a/public-site/docs/src/guides/external-alias/index.md b/public-site/docs/src/guides/external-alias/index.md index 9b59e697..de1528d1 100644 --- a/public-site/docs/src/guides/external-alias/index.md +++ b/public-site/docs/src/guides/external-alias/index.md @@ -3,16 +3,12 @@ title: Configure External DNS Alias --- # Configure External DNS Alias - -An application can be configured to use external DNS aliases, in addition to the automatically generated [domain names](../../docs/topic-domain-names), provided you register the DNS record and bring the corresponding TLS certificate into Radix. Traffic routing is configured in [`dnsExternalAlias`](../../references/reference-radix-config/#dnsexternalalias) in `radixconfig.yaml`. The external DNS record must point to the [public name](../../docs/topic-domain-names/#public-name) of a component, to the [app default alias](../../docs/topic-domain-names/#app-default-alias) or to the [app alias](../../docs/topic-domain-names/#app-alias). - + ## Acquire a DNS record in the equinor.com zone The process for setting up the DNS record depends on the service used to register and manage the DNS zone. This guide assumes registration of a DNS record in the `equinor.com` zone, but you should be able to adapt the instructions to a third-party provider. @@ -49,11 +45,8 @@ frontend-myapp-prod.radix.equinor.com Add the alias to `dnsExternalAlias` in radixconfig.yaml. You can add multiple entries as long as the `alias` value is unique. The referenced environment must be re-deployed in order for the changes to take effect. - - -``` yaml -apiVersion: radix.equinor.com/v1 -kind: RadixApplication -metadata: - name: myapp -spec: - ... - dnsExternalAlias: - - alias: myapp.equinor.com - component: frontend - environment: prod -``` ## Acquire an Equinor TLS certificate - + 1. Start by getting familiar with the appropriate procedures about handling keys and certificates in Equinor, as they are considered to be sensitive information. 1. Create a _Certificate Signing Request_ on you local pc using the [openssl](https://www.openssl.org/) command: ```sh diff --git a/public-site/docs/src/references/reference-radix-config/index.md b/public-site/docs/src/references/reference-radix-config/index.md index 52035c24..1f094742 100644 --- a/public-site/docs/src/references/reference-radix-config/index.md +++ b/public-site/docs/src/references/reference-radix-config/index.md @@ -1060,7 +1060,6 @@ In the example above, the component **frontend** hosted in environment **prod** ## `dnsExternalAlias` - -```yaml -spec: - dnsExternalAlias: - - alias: some.alias.com - environment: prod - component: frontend - - alias: another.alias.com - environment: prod - component: frontend -``` - It is possible to have multiple custom DNS aliases (i.e. to choose your own custom domains) for the application. The `dnsExternalAlias` needs to point to a component marked as public. It can be any domain name, which can in turn be used for public URLs to access the application. In the example above, the component **frontend** hosted in environment **prod** will be accessible from both `some.alias.com` and `another.alias.com`, as long as the correct certificate has been set. - There is a [detailed guide](../../guides/external-alias/) on how to set up external aliases.