Skip to main contentIBM Garage for Cloud

Getting Started - Day 0

Provides information for provisioning an environment using the IBM Cloud-Native Toolkit. It describes the available options and associated considerations for how the environment can be structured. Additionally, this section provides step-by-step guides to get an environment up and running using repeatable Infrastructure as Code components.

Paths to Installation

The IBM Cloud-Native Toolkit environment can be hosted in any Kubernetes or Red Hat OpenShift cluster, including those managed by IBM Cloud. The environment is provisioned using infrastructure-as-code Terraform scripts that make the process declarative, automated, and repeatable.

The scripts are composed of a number of Terraform modules that have been organized into different stages. The first stage is responsible for establishing the connection to the cluster (if using an existing cluster) or provisions the cluster in IBM Cloud before establishing the connection (if provisioning a new cluster). After establishing the connection, the subsequent stages can connect and perform their activities.

If a managed IBM Cloud cluster is not used, then the cluster can be provisioned by other means, and the first stage will just expose the cluster configuration values. In this case, we would highly recommend provisioning the cluster using other Terraform scripts.


The installation process is organized into three activities:

Planning the installation

Explains the planning and configuration required to prepare for the installation of the Toolkit.

Installing with the toolkit

Explains the end-to-end process for provisioning the environment with the Toolkit. Within that process, there two primary installation options. Select the approach that best suites your requirements:

  • Install in IBM Cloud-managed cluster: Create a new environment in IBM Cloud, optionally creating a new cluster in the process.

  • Install in existing OpenShift: Create a new environment in an OpenShift cluster running anywhere.

Completing the configuration

Explains the steps to finalize the setup of the environment and begin on-boarding developers.