To use the domain name of your choice to access your Banzai Cloud Pipeline installation, create a DNS record. The Pipeline installer creates a Kubernetes service for the ingress controller responsible for forwarding HTTPS requests to the different components of the platform. The DNS record should point to this service.

The installer will find out a hostname or IP address to use for accessing Pipeline, but the use of a custom hostname is essential for a real production setup.

As the first step, choose a hostname, and set it as the externalHost key of the values.yaml file in your workspace (usually ~/.banzai/pipeline/default):

externalHost: your.domain.example.com

After that, you can run banzai pipeline up to deploy the changes. Note that this will cause a service interruption until the DNS record is ready.

If this is a concern, you may create and check the DNS record before applying the changes. Simply create an A or CNAME record pointing to the current address of the control plane.

At the end of the output, you will find the DNS record that you have to create. Once your DNS record has been propagated (depending on your settings, this may take for hours), you will be able to access the control plane using your host name.

Further reading 🔗︎

Your next step may be to supply a proper TLS certificate. Check the advanced configuration section for the other options.