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¶

Create an OpenShift Cluster for example:

The 8 hours free Cluster on IBM Open Labs select lab 6 Bring Your Own Application
Deploy a Cluster on IBM Cloud VPC2 using the Toolkit
On other Clouds using docs from cloudnativetoolkit.dev/multi-cloud
IBM internal DTE Infrastructure access via IBM VPN or IBM CSPLAB

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 -
```
Note
- 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 b y 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
```
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.
```
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 variable 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.