Install into Red Hat CodeReady Containers

Prepare to install developer tools into Red Hat CodeReady Containers on your laptop

The IBM Garage for Cloud Developer Tools facilitate development and deployment of cloud-native applications. They can be hosted in any Kubernetes or OpenShift cluster, including the Red Hat CodeReady Containers local OpenShift environment.

These instructions help you install Red Hat CodeReady Containers and explain how to configure and run the Terraform infrastructure-as-code (IasC) scripts to install the Developer Tools into that CodeReady Containers install.

Warning: Red Hat CodeReady Containers (CRC) is based on OpenShift 4.2 and the current installation of IBM Garage for Cloud Developer Tools only installs the Tekton pipeline operator, Jenkins is not installed. Read the Tekton Pipelines and Tasks Guide to understand how to deploy your app into CRC using Tekton.

The following prerequisites are required to support installing CodeReady Containers:

CodeReady Containers Minimum system requirements
A Red Hat account is required

The following prerequisites are required before following the setup instructions:

Install the Prerequisites listed before continuing

Download CodeReady Containers (CRC) and install it

Install and configure CRC as described in Install on Laptop

Remember to take a copy of Pull Secret
CRC executable: Copy the crc binary to your $PATH:
From the directory where you unzipped the download:
```
cp crc /usr/local/bin
```

Follow these steps to complete the installation:

Setup: Run the following command from a terminal session:
```
crc setup
```
Add memory: By default, the CRC VM is set to only use 8 GB of RAM. The more RAM you can give it, the better.
To set the CRC VM to 10 GB of RAM, do this:
```
crc config set memory 10240
```
Start the local CRC Cluster
Run the crc start command in a terminal window:
```
crc start
```
During the start process, you will be prompted for your pull secret. Copy and paste it into the terminal window.
Wait about 5 minutes for the VM initialization to complete. When complete, the kubeadmin password will be displayed. Make note of this password because you will need it to log into the console.

Open the Cluster Admin Console

crc console

Open a web browser and go to the OpenShift console
Login with user id kubeadmin and the password that was displayed after the crc start had completed.

Environment variables

Use the environment.tfvars properties to configure the installation for the Development Tools.

Set the following properties so they match below, all the other properties will be ignored:

# The type of cluster that will be created/used (kubernetes, openshift, or crc)
cluster_type="crc"
# Flag indicating if we are using an existing cluster or creating a new one
cluster_exists="true"
# Enter any value for the resource group name
resource_group_name="crc-resource-group"
# Flag indicating if we are using an existing postgres server or creating a new one
postgres_server_exists="false"

Run Terraform to install the tools into the CRC environment

Having configured the credentials.properties, environment.tfvars properties files, we are now ready to kick off the installation.

Launch a Developer Tools Docker container.
Run the following command to run the Docker container:
```
./launch.sh
```
For more information on the Developer Tools Image see the following guide:
This will install the Cloud Garage Tools Docker image and exec shell into the running container. The container will mount the filesystem’s ./terraform/ directory as /home/devops/src/. Once the Docker container has started and the script has exec shelled into it, you will see an IBM Garage banner. This will help you identify you are running inside the Docker image that has just mounted your file system.
The supplied Terraform scripts are ready to run using the settings in the properties files. You optionally can extend or modify the scripts and tailor them for your project’s specific needs.
From inside the terminal/container run this script:
```
./runTerraform.sh
```
This script will setup the Developer Tools in the CRC environment.
The script will verify some basic settings and prompt if you want to proceed. After you select Y (for yes), the Terraform Apply process will begin to create the infrastructure and services for your environment.
The existing cluster’s contents will be cleaned up to prepare for the terraform process. Any resources in the tools, dev, test, and staging namespaces/projects will be deleted.
Installing the tools into an existing cluster takes about 20 minutes.
You should now have your environment fully provisioned and configured. Enjoy!

Finish

Once the Terraform scripts have finished, you can see the resources that the scripts created.

To see this:

Open the OpenShift web console. You should see:
- Namespaces: tools, dev, test, and staging
- Deployments in the tools namespace: catalyst-dashboard, jenkins, etc.

To get started with code using the following guides:

Possible issues

If you find that that the Terraform provisioning has failed, try re-running the runTerraform.sh script again. The state will be saved and Terraform will try and apply the configuration to match the desired end state.

Edit this page on GitHub