Creating a 2 node OpenShift cluster on VPC infrastructure by using Schematics

Audience

This tutorial is designed for account administrators who want to learn about Red Hat OpenShift on IBM Cloud and Schematics.

Alternatively, you can use this tutorial to set up a small testing environment for administrators who are already familiar with OpenShift, VPC, and Schematics.

To complete this tutorial, you must have the at least the following permissions in IAM. For more information, see IAM roles and actions.

• Administrator or Compliance Management for IBM Cloud Kubernetes Service.
• Administrator or Editor for VPC.
• Manager for Schematics.
• Manager for Cloud Object Storage.

What you'll get

In this tutorial, you create the following resources. There are optional steps to delete these resources if you do not want to keep them after completing the tutorial.

• 1 Virtual Private Cloud (VPC)
• 1 Subnet
• 1 Public gateway
• 1 Cloud Object Storage (COS) bucket
• 1 single zone OpenShift cluster with 2 worker nodes.

Create a Schematics workspaces

1. Navigate to the Schematics console.
2. Click Create workspace.
3. In the GitHub, GitLab or Bitbucket repository URL field, enter the following URL.

   https://github.com/IBM-Cloud/kube-samples/tree/master/ez-ibm-openshift-vpc
   

4. Uncheck the Use Full Repository box.
5. Make sure the Branch, Folder, and Personal Access Token fields are empty.
6. Use the default Terraform version and click Next.
7. In the Workplace Details section, give your workspace a name and fill out the remaining fields as desired.
8. Click Next, then review the information you entered.
9. Click Create, then wait a few minutes while the Schematics template populates.

Generate, review, and apply the Schematics plan

1. Click Generate plan to create a Terraform execution plan. Generating a plan lets you review the resources that will be deployed in your account and the associated cost estimate.
2. After reviewing the plan details and the cost estimate, click Apply plan.
3. Wait a few minutes while Schematics creates the resources in your account.

Access your OpenShift cluster

1. Navigate to the Red Hat OpenShift clusters console.
2. Select your cluster. The cluster name is ez-ibm-openshift-vpc-XXX.
3. Click OpenShift web console to access your cluster. For more information, see Connecting to the cluster from the console.

Optional: Clean up the resources

1. Navigate to your Schematics workspace.
2. From the Actions dropdown menu, click Destroy resources.
3. Wait a few minutes while Schematics deletes the resources from your account.
4. From the Actions menu, click Delete workspace.