IBM Technology Zone Command Line Interface (itz)

The itz command line interface is a command line interface that provides CLI access to IBM Technology Zone.

Introduction

Using itz, you can:

• List your existing reservations and get their status.
• List the available pipelines that you can install in a Red Hat OpenShift cluster that you reserved in TechZone.
• Install or deploy products outside of TechZone using infrastructure as code in your own OpenShift cluster.

Quickstart

See the QUICKSTART.

For usage documentation, see the documentation in the docs folder.

Installing itz

Release packages for your OS can be found at https://github.com/cloud-native-toolkit/itzcli/releases.

Installing on Linux

To install itz on Linux, use the install.sh script as shown here:

$ curl https://raw.githubusercontent.com/cloud-native-toolkit/itzcli/main/scripts/install.sh | bash -

Verify the installation by using the itz version command to view the current version.

By default, the script installs itz in /usr/local/bin. If you would like this to be in a different location, you can set the ITZ_INSTALL_HOME environment variable, like this:

$ export ITZ_INSTALL_HOME=~/bin
$ curl https://raw.githubusercontent.com/cloud-native-toolkit/itzcli/main/scripts/install.sh | bash -

Installing on Mac

Note: if you have version 1.24 and installed itz with brew, you must use brew to uninstall itz and then re-install it.

If you have itz already installed

If you have itz already installed and itz version outputs 1.24 (or a lower version), you must follow these steps first:

1. Use brew to uninstall the existing itz.

   brew uninstall itz

2. Untap the existing repository.

   brew untap cloud-native-toolkit/techzone

Once you have uninstalled itz, you can proceed to "Installing itz using brew".

Installing itz using brew

To install itz using Homebrew, follow these steps:

1. Tap the cask.

   brew tap cloud-native-toolkit/homebrew-techzone

2. Install ITZ with brew.

   brew install itz

Signing on to IBM Technology Zone

Version v0.1.245 and higher of itz supports IBM's Single Sign On (SSO) to authenticate against the TechZone APIs. To log in, type the following:

$ itz login

This command will automatically open a browser. You can log into IBM Verify with your IBM ID. When you are done, you can close the browser window.

Signing on without a browser

For headless VMs or scripts, the itz login command also supports authentication using the token stored in a file. Log in at https://techzone.ibm.com and view your profile using the My profile page. Copy the value from the API token field and store the value in a file (e.g., ~/token.txt). Then use the command as shown to store the value:

$ itz login --from-file ~/token.txt