Chapter 2. Configuring an IBM Cloud account

Procedure

1. Create a CIS instance to use with your cluster:

   1. Install the CIS plugin:

      $ ibmcloud plugin install cis

   2. Create the CIS instance:

      $ 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.

2. Connect an existing domain to your CIS instance:

   1. Set the context instance for CIS:

      $ ibmcloud cis instance-set <instance_name> 1

      1

      The instance cloud resource name.

   2. Add the domain for CIS:

      $ 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.

3. Open the CIS web console, navigate to the Overview page, and note your CIS name servers. These name servers will be used in the next step.
4. Configure the name servers for your domains or subdomains at the domain’s registrar or DNS provider. For more information, see the IBM Cloud® documentation.

Procedure

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

   1. Install the DNS Services plugin by running the following command:

      $ ibmcloud plugin install cloud-dns-services

   2. Create the DNS Services instance by running the following command:

      $ ibmcloud dns instance-create <instance-name> standard-dns 1

      1

      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.

2. Create a DNS zone for the DNS Services instance:

   1. Set the target operating DNS Services instance by running the following command:

      $ ibmcloud dns instance-target <instance-name>

   2. Add the DNS zone to the DNS Services instance by running the following command:

      $ ibmcloud dns zone-create <zone-name> 1

      1

      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.

3. 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.

1. The policy access scope should be set based on how granular you want to assign access. The scope can be set to All resources or Resources based on selected attributes.
2. Optional: This access policy is only required if you want the installation program to create a resource group. For more information about resource groups, see the IBM® documentation.