Developer Tools Setup

To enable the best working experience through the hands-on exercises, you need to select the environment you plan to use for development and the required tools for integration with your OpenShift development environment.

• If you plan to use your desktop/laptop for hands-on exercises, follow the instructions in the Desktop/Laptop tab. You will need a recent macOS or Windows 10 operating system for this option.
• If you cannot install tools on your desktop/laptop, follow the Web Terminal instructions.

Once you have fulfilled these setup requirements you will be ready to start the Developer Intermediate agenda.

Open Web Terminal¶

To be able to run CLI commands to drive common operations on the cluster you will first need to open your web terminal instance. - Click on the >_ icon in the header of the OpenShift Console. You should see a terminal open at the bottom of the console screen. - Validate that you can run oc commands, run the following command

oc sync --version

Log in to IBM Cloud¶

• Use the ibmcloud command to log in to the cloud account. Replace the user_id, password and team name with the sandbox ones:

  $ ibmcloud login -u <user_id> -p <password> -g <workshop-team> -r us-south
  

• Select the account number you have been assigned to:

  $ ibmcloud login -u email@company.com -p XXX -g workshop-team-one -r us-south
  API endpoint: https://cloud.ibm.com
  Authenticating...
  OK
  
  Select an account:
  1. GSI Labs - IBM
  Enter a number> 1
  Targeted account GSI Labs
  
  Targeted resource group workshop-team-one
  
  Targeted region us-south
  
  API endpoint:      https://cloud.ibm.com
  Region:            us-south
  User:              email@company.com
  Account:           GSI Labs
  Resource group:    workshop-team-one
  CF API endpoint:
  Org:
  Space:
  

Log in to OpenShift Cluster¶

• Access the OpenShift console by clicking on the button:

  

• Get the OpenShift login command, which includes a token:

• Run the login command in the terminal:

  $ oc login --token=<token> --server=https://c103-e.us-south.containers.cloud.ibm.com:<port>
  Logged into "https://c103-e.us-south.containers.cloud.ibm.com:<port>" as "IAM#email@company" using the token provided.
  
  You have access to 71 projects, the list has been suppressed. You can list all projects with 'oc projects'
  
  Using project "dev-ab".
  

Configure git¶

• Execute the following commands replacing the email and short name:

$ git config --global user.email "<email>"
$ git config --global user.name "<short_name>"

Optional: Use Gitpod for development¶

Gitpod is an open-source Kubernetes application for ready-to-code developer environments that spins up fresh, automated dev environments for each task, in the cloud, in seconds.

If you want to use Gitpod as the tool to write code for this journey, complete the following steps to get you started:

• Head over to gitpod.io, login with your github account by clicking Continue with GitHub.

• If you have been invite to a GitHub organization or want to use a specific one to complete this journey, Gitpod is going to need to have access to the repositories in that organization. Grant access to gitpod to your GitHub organization by going to account Settings on the top right corner, navigate to Integrations, select GitHub and click Manage on GitHub.

• You should be redirected to GitHub, search the organization you are using for the journey and click grant to allow Gitpod to access repositories in that organization.

There you go! Back to gitpod.io, navigate to workspaces and click New Workspace to create workspaces as you go through the labs.