This repository provides the tools and configuration needed to deploy and manage Red Hat OpenShift Container Platform clusters on Oracle Cloud Infrastructure (OCI). It includes:
- Terraform stacks for provisioning the required OCI infrastructure.
- OpenShift and Kubernetes manifest files for installing and configuring clusters.
Installing OpenShift clusters on OCI involves two main stages:
1. Provisioning Infrastructure
Before installing OpenShift clusters, you must set up the required OCI infrastructure including Virtual Cloud Networks (VCNs), public and private subnets, compute instances (control plane and worker nodes), load balancers, IAM policies, and object storage buckets. You can provision infrastructure in two ways:
-
Using Terraform: Create OCI resources using the Terraform stack provided in this repo or available via the OCI Console. This method is recommended for connected environments.
-
Manual Provisioning: Manually create the resources using OCI Console and CLI. Use this method for disconnected or air-gapped environments, or if you can't use the OCI-provided Terraform due to policy restrictions.
2. Installing and Configuring Cluster
Deploying an OpenShift cluster on OCI combines actions performed in the Red Hat Hybrid Cloud Console and the OCI Console. You can install and configure OpenShift clusters on OCI using either the Red Hat's Assisted Installer or Agent-based Installer.
Before you begin, ensure you have:
- A Red Hat account and access to either the Assisted Installer or the Agent-based Installer.
- An OCI account with the required permissions to create and manage resources.
- An internet domain to serve the OpenShift Container Platform console that runs on cluster resources in OCI.
- An SSH key pair for cluster installation.
- A pull secret provided from the Red Hat Hybrid Cloud Console. See Using image pull secrets in the Red Hat documentation for details.
- (Optional) A dedicated compartment for the cluster resources. You can also use an existing compartment.
- (Optional) An Object Storage bucket to store the discovery ISO image. You can also use an existing bucket.
- Access to the required configuration files, including the custom manifests and terraform stacks.
Follow the installation instructions for your preferred method:
- Assisted Installer: An automated installation method using the Red Hat Assisted Installer for connected environments.
- Agent-based Installer: An advanced installation method that requires you to provision the infrastructure in one of the two ways:
- Terraform Provisioning - For connected environments.
- Manual Provisioning - For disconnected or air-gapped environments.
first cluster deployment. Subsequent cluster deployments will not require this step, as the tags will already exist.
Verify that your cluster is installed and running smoothly. For instructions see the following Red Hat documentation:
- Verifying successful cluster installation for Assisted Installer
- Verifying successful cluster installation for Agent-based Installer
Oracle Documentation
Red Hat Documentation
- Installing a cluster on Oracle Cloud Infrastructure (OCI) by using the Assisted Installer
- Installing a cluster on Oracle Cloud Infrastructure (OCI) by using the Agent-based Installer
This project welcomes contributions from the community. Before submitting a pull request, please review our contribution guide
Please consult the security guide for our responsible security vulnerability disclosure process
Copyright (c) 2022 Oracle and/or its affiliates.
Released under the Universal Permissive License v1.0 as shown at https://oss.oracle.com/licenses/upl/.