mirror of
https://github.com/openshift/openshift-docs.git
synced 2026-02-05 12:46:18 +01:00
101 lines
3.3 KiB
Plaintext
101 lines
3.3 KiB
Plaintext
// Module included in the following assemblies:
|
|
//
|
|
// installing/installing_ibm_cloud/installing-ibm-cloud-account.adoc
|
|
// installing/installing_ibm_powervs/installing-ibm-cloud-account-power-vs.adoc
|
|
|
|
ifeval::["{context}" == "installing-ibm-cloud-account-power-vs"]
|
|
:ibm-power-vs:
|
|
endif::[]
|
|
|
|
:_mod-docs-content-type: PROCEDURE
|
|
[id="installation-cis-ibm-cloud_{context}"]
|
|
= Using {ibm-cloud-title} Internet Services for DNS resolution
|
|
|
|
The installation program uses {ibm-cloud-name} Internet Services (CIS) to configure cluster DNS resolution and provide name lookup for a public cluster.
|
|
|
|
[NOTE]
|
|
====
|
|
This offering does not support IPv6, so dual stack or IPv6 environments are not possible.
|
|
====
|
|
|
|
You must create a domain zone in CIS in the same account as your cluster. You must also ensure the zone is authoritative for the domain. You can do this using a root domain or subdomain.
|
|
|
|
.Prerequisites
|
|
|
|
* You have installed the link:https://www.ibm.com/cloud/cli[{ibm-cloud-name} CLI].
|
|
* You have an existing domain and registrar. For more information, see the {ibm-name} link:https://cloud.ibm.com/docs/dns?topic=dns-getting-started[documentation].
|
|
|
|
.Procedure
|
|
|
|
. Create a CIS instance to use with your cluster:
|
|
|
|
.. Install the CIS plugin:
|
|
+
|
|
[source,terminal]
|
|
----
|
|
$ ibmcloud plugin install cis
|
|
----
|
|
|
|
ifdef::ibm-power-vs[]
|
|
.. Log in to {ibm-cloud-name} by using the CLI:
|
|
+
|
|
[source,terminal]
|
|
----
|
|
$ ibmcloud login
|
|
----
|
|
endif::ibm-power-vs[]
|
|
|
|
.. Create the CIS instance:
|
|
+
|
|
[source,terminal]
|
|
----
|
|
$ ibmcloud cis instance-create <instance_name> standard-next <1>
|
|
----
|
|
<1> At a minimum, you require a `Standard Next` plan for CIS 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.
|
|
====
|
|
|
|
. Connect an existing domain to your CIS instance:
|
|
|
|
.. Set the context instance for CIS:
|
|
ifndef::ibm-power-vs[]
|
|
+
|
|
[source,terminal]
|
|
----
|
|
$ ibmcloud cis instance-set <instance_name> <1>
|
|
----
|
|
<1> The instance cloud resource name.
|
|
endif::ibm-power-vs[]
|
|
ifdef::ibm-power-vs[]
|
|
+
|
|
[source,terminal]
|
|
----
|
|
$ ibmcloud cis instance-set <instance_CRN> <1>
|
|
----
|
|
<1> The instance CRN (Cloud Resource Name).
|
|
For example: `ibmcloud cis instance-set crn:v1:bluemix:public:power-iaas:osa21:a/65b64c1f1c29460d8c2e4bbfbd893c2c:c09233ac-48a5-4ccb-a051-d1cfb3fc7eb5::`
|
|
endif::ibm-power-vs[]
|
|
|
|
.. Add the domain for CIS:
|
|
+
|
|
[source,terminal]
|
|
----
|
|
$ ibmcloud cis domain-add <domain_name> <1>
|
|
----
|
|
<1> The fully qualified domain name. You can use either the root domain or subdomain value as the domain name, depending on which you plan to configure.
|
|
+
|
|
[NOTE]
|
|
====
|
|
A root domain uses the form `openshiftcorp.com`. A subdomain uses the form `clusters.openshiftcorp.com`.
|
|
====
|
|
|
|
. Open the link:https://cloud.ibm.com/catalog/services/internet-services[CIS web console], navigate to the *Overview* page, and note your CIS name servers. These name servers will be used in the next step.
|
|
|
|
. Configure the name servers for your domains or subdomains at the domain's registrar or DNS provider. For more information, see the {ibm-cloud-name} link:https://cloud.ibm.com/docs/cis?topic=cis-getting-started#configure-your-name-servers-with-the-registrar-or-existing-dns-provider[documentation].
|
|
|
|
ifeval::["{context}" == "installing-ibm-cloud-account-power-vs"]
|
|
:!ibm-power-vs:
|
|
endif::[] |