Skip to main contentIBM Garage for Cloud

Prerequisites

Install and configure these tools needed to use the Developer Environment

To install and use the Cloud-Native Toolkit Developer Environment, first setup the following prerequisites. Both developers and administrators will need these tools.

This guide assumes that you have some basic knowledge of Kubernetes, Docker , and modern software delivery techniques including CI/CD. To learn more about these topics, after installing the environment, consult the educational materials listed in the Activation section Cloud Native Deployment .

Create accounts

You’ll need these accounts to use the Developer Environment.

Configure Github Personal Access Token

For your CI pipeline (Jenkins, Tekton, etc.) to connect to and use your GitHub repo, it will need a GitHub personal access token with public_repo and write:repo_hook scopes. The Personal Access Token only needs to be generated once because it is associated with the GitHub organization and can be used to access any of the organization’s repos.

  • Navigate to Developer Settings and generate a new token; name it something like “CI pipeline”
  • Select public_repo scope to enable git clone
  • Select write:repo_hook scope so the pipeline can create a web hook Pipeline OAuth scopes
  • The GitHub UI will never again let you see this token, so be sure to save the token in your password manager or somewhere safe that you can access later on

Install CLIs and tools

The following is a list of desktop tools required to help with installation and development.

  • Git Client: Needs to be installed in your development operating system, it comes as standard for Mac OS

  • IBM Cloud CLI: Required for management of IBM Cloud Account and management of your managed IBM Kubernetes and Red Hat OpenShift clusters

  • OpenShift OC CLI: Required for Red Hat OpenShift management and development

    • Download the appropriate client tar ball

    • Unpack the tar ball

    • Copy the oc and kubectl from the unpacked folder into your Terminal PATH (e.g. /usr/local/bin)

    • MacOS/Linux

    • Once downloaded navigate to Download folder

      cd ~/Downloads/openshift-origin-client-tools-v3/
    • Then copy oc and kubectl to the system-wide available scripts folder (which is already in your PATH)

      cp kubectl /usr/local/bin/kubectl
      cp oc /usr/local/bin/oc
  • Docker Desktop: Required for running common tools and Developer Tools Image

    • Installed and running on your local machine
  • Node: Required for running the IBM Garage for Cloud CLI

    • Installed on your local machine
    • Recommended v12.x LTS
  • IBM Garage for Cloud CLI: Used to help make working with the development tools as easy as possible

    npm i -g @ibmgaragecloud/cloud-native-toolkit-cli
  • Tekton CLI: Used to help control Tekton pipelines from the command line.

    brew tap tektoncd/tools
    brew install tektoncd/tools/tektoncd-cli