// Module included in the following assemblies:
//
// installing/installing_ibm_cloud/installing-ibm-cloud-account.adoc

:_mod-docs-content-type: PROCEDURE
[id="installation-dns-ibm-cloud_{context}"]
= Using {ibm-cloud-title} DNS Services for DNS resolution

[role="_abstract"]
The installation program uses {ibm-cloud-name} DNS Services to configure cluster DNS resolution and provide name lookup for a private cluster.

You configure DNS resolution by creating a DNS services instance for the cluster, and then adding a DNS zone to the DNS Services instance. Ensure that the zone is authoritative for the domain. You can do this using a root domain or subdomain.

[NOTE]
====
{ibm-cloud-name} does not support IPv6, so dual stack or IPv6 environments are not possible.
====

.Prerequisites

* You have installed the {ibm-cloud-name} CLI. For more information, see "{ibm-cloud-name} CLI".
* You have an existing domain and registrar. For more information, see the "{ibm-name} DNS documentation".

.Procedure

. Create a DNS Services instance to use with your cluster:

.. Install the DNS Services plugin by running the following command:
+
[source,terminal]
----
$ ibmcloud plugin install cloud-dns-services
----

.. Create the DNS Services instance by running the following command:
+
[source,terminal]
----
$ ibmcloud dns instance-create <instance-name> standard-dns
----
+
At a minimum, you require a `Standard DNS` plan for DNS Services to manage the cluster subdomain and its DNS records.
+
[NOTE]
====
After you have configured your registrar or DNS provider, it can take up to 24 hours for the changes to take effect.
====

. Create a DNS zone for the DNS Services instance:

.. Set the target operating DNS Services instance by running the following command:
+
[source,terminal]
----
$ ibmcloud dns instance-target <instance-name>
----

.. Add the DNS zone to the DNS Services instance by running the following command:
+
[source,terminal]
----
$ ibmcloud dns zone-create <zone-name>
----
+
Replace `<zone-name>` with the fully qualified zone name. You can use either the root domain or subdomain value as the zone name, depending on which you plan to configure. A root domain uses the form `openshiftcorp.com`. A subdomain uses the form `clusters.openshiftcorp.com`.

. Record the name of the DNS zone you have created. As part of the installation process, you must update the `install-config.yaml` file before deploying the cluster. Use the name of the DNS zone as the value for the `baseDomain` parameter.

[NOTE]
====
You do not have to manage permitted networks or configure an "A" DNS resource record. As required, the installation program configures these resources automatically.
====

[role="_additional-resources"]
.Additional resources
* link:https://www.ibm.com/cloud/cli[{ibm-cloud-name} CLI ({ibm-cloud-name} documentation)]
* link:https://cloud.ibm.com/docs/dns?topic=dns-getting-started[{ibm-name} DNS documentation]
