Skip to content

Coherence custom domain setup

Coherence supports two types of domain configurations depending on the reference architecture you choose:

  1. Per-service domains
  2. Per-environment domains with service routing via load balancer

In both cases, Coherence provides a valid domain with an SSL certificate.

Per-Service Domains

Per-service domains are supported by the following CNC architectures:

  • Lambda-lite (AWS)
  • Run-lite (GCP)

You will see the domain for each service on the environment details page: per service domains

For these architectures, each service gets its own domain. However, Coherence does not directly support custom domains for per-service configurations. To set up custom domains:

Per-Environment Domains

Per-environment domains are supported by:

  • ECS (AWS)
  • Cloud Run (GCP)
  • GKE (GCP)

For these architectures, each environment gets a domain, and service routing is done using a load balancer based on URL path. You can also add custom domains:

  • For GCP: Coherence provides a CNAME record to set in your DNS provider.
  • For AWS: Coherence creates a new Route 53 hosted zone and provides 4 NS records to set in your DNS provider.

Here's what the UI looks like: You will see the domain for each service on the environment details page: per service domains

Common Issues

  1. DNS Propagation: Changes to DNS records can take time to propagate globally. This may cause delays in domain availability after configuration.

  2. CAA Records: Certificate Authority Authorization (CAA) records can prevent the cloud issuer from validating and issuing your certificate. Ensure your CAA records allow the necessary certificate authorities.

  3. Wildcard Subdomains:

  4. AWS: Wildcard subdomains will have a valid certificate.
  5. GCP: Wildcard subdomains will not have a valid certificate by default.

For GCP, you can provide the name of a self-managed certificate in your cnc.yml to add a wildcard cert. Contact Coherence support if you need assistance with this.

If you encounter any issues or need further clarification on domain configuration, please reach out to Coherence support.