Skip to main contentCloud-Native Toolkit

Setup Workshop Environment

Provides the steps to install the Cloud-Native Toolkit and setting up the Cloud-Native Toolkit Workshop hands on labs.

1. Create OpenShift Cluster

2. Install IBM Cloud Native Toolkit

  • Use one of the install options for example the Quick Install
    curl -sfL get.cloudnativetoolkit.dev | sh -

3. Setup IBM Cloud Native Toolkit Workshop

  • Install the foundation for the workshops

    curl -sfL workshop.cloudnativetoolkit.dev | sh -

    Notes:

    • The username and password for Git Admin is toolkit toolkit.
    • Usernames user01 through user15 are configured with a password of password.
    • Username userdemo is configured with the password password. You can use this username if using the workshop environment for self study or giving a demo. If you are preparing the environment for a workshop you can remove userdemo by running the uninstall-userdemo.sh script which is part of the workshop scripts.

4. (Optional) Customization of the IBM Cloud Native Toolkit Workshop

  • You can customize the Workshop environment by cloning the workshop repo

  • Some of the most common customizations are:

    • You can create more than 15 users by setting a USER_COUNT environment variable. For example to configure 30 users use the command

      export USER_COUNT=30
    • You can create more than 15 projects by setting a PROJECT_COUNT environment variable. For example to configure 30 projects use the command

      export PROJECT_COUNT=30
  • Once you have finished configuring your customizations, login to the cluster from the cli and run the scripts/install.sh script to perform the install.

  • You can also add additional users to the workshop clusters.

    • Create a file with one user id per line. IMPORTANT: there needs to be newline after the last entry. For example a users.txt file with content.

      additionaluserID
      anotheruserID
      someuserID

      Note: For Openshift clusters on IBM Cloud (ROKS) the user ids are their IBM IDs (email address) all lowercase with an uppercase IAM# prefix added to the beginning. For example.

      IAM#additionaluserid@email.com
      IAM#anotheruserid@email.com
      IAM#someuserid@email.com
    • Create a ADDITIONAL_USERS_FILE environment variable with the path and name of the file.

      export ADDITIONAL_USERS_FILE=users.txt
    • The additional users will be granted the self-provisioner role, meaning they can create new Openshift Projects. If you wish to remove this permission set an environment varable ADDITIONAL_USERS_SELF_PROVISIONER with a value of N

      export ADDITIONAL_USERS_SELF_PROVISIONER=N
  • Once you have finished configuring the additional users, login to the cluster from the cli and run the scripts/13-ocp-additional-users.sh script.