3.7. Managing Custom Domain Aliases

Developers can designate custom domain aliases for applications to use DNS entries other than the domains generated by OpenShift Enterprise. By default, developers cannot create aliases that are in the cloud domain where the applications are created. For example, a developer could not create the alias app.example.com or my-app.example.com for an application that was created in the cloud domain example.com. This restriction prevents confusion or possible name collisions.

Enabling the ALLOW_ALIAS_IN_DOMAIN setting in the /etc/openshift/broker.conf file on the broker host allows developers to create aliases within the cloud domain, provided the alias does not take the form <name>-<name>.<cloud-domain>. Aliases taking this standard form of application names are rejected to prevent conflicts. For example, while a developer could now create the alias app.example.com for an application that was created in the cloud domain example.com, they still could not create the alias my-app.example.com because it takes the standard form.