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 .
You’ll need these accounts to use the Developer Environment.
GitHub account (public, not enterprise): Create one if you do not have one aleady. If you have not logged in for a while, make sure your login is working.
IBM Cloud Account: Create one if needed, make sure you can log in.
For your CI pipeline (Jenkins, Tekton, etc.) to connect to and use your GitHub repo, it will need a GitHub personal access token with
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”
public_reposcope to enable git clone
write:repo_hookscope so the pipeline can create a web hook
- 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
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
- Don’t install just the IBM Cloud CLI, install the IBM Cloud CLI and Developer Toolscurl -sL https://ibm.biz/idt-installer | bash
- Note: If you log in to the web UI using SSO, you’ll need to create an API key for logging into the CLI. (You can also use this API key for installing the Developer Environment.)
- Don’t install just the IBM Cloud CLI, install the IBM Cloud CLI and Developer Tools
OpenShift OC CLI: Required for Red Hat OpenShift management and development
Download the appropriate client tar ball
Unpack the tar ball
kubectlfrom the unpacked folder into your Terminal
Once downloaded navigate to Download foldercd ~/Downloads/openshift-origin-client-tools-v3/
kubectlto the system-wide available scripts folder (which is already in your PATH)cp kubectl /usr/local/bin/kubectlcp oc /usr/local/bin/oc
- Installed and running on your local machine
- Installed on your local machine
IBM Garage for Cloud CLI: Used to help make working with the development tools as easy as possiblenpm i -g @ibmgaragecloud/cloud-native-toolkit-cli
Tekton CLI: Used to help control Tekton pipelines from the command line.brew tap tektoncd/toolsbrew install tektoncd/tools/tektoncd-cli