itzcli

README

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 products that you can install in TechZone.
• Install or deploy products outside of TechZone using infrastructure as code.

Quickstart

See the QUICKSTART.

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

Architecture

For an architecture overview, see docs/ARCHITECTURE.md.

Installing itz

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

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, 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 auth login --sso

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.