Install dependencies

To create a cluster using the Cluster Toolkit, you can use either Cloud Shell, or a workstation that is running Linux or macOS.

If you use Cloud Shell, then you don't need to install the dependencies in this document. Proceed to the instructions in Set up Cluster Toolkit.

If you want to work from a Linux or macOS client or workstation, then complete the steps in this document.

Install Cluster Toolkit dependencies

Important: If you use Cloud Shell, the Cluster Toolkit dependencies are already pre-installed. If you are using an alternative to Cloud Shell, such as using a workstation that is running Linux or macOS, you must follow the instructions in Install dependencies.

Linux

1. Install the Google Cloud CLI, see Installing the gcloud CLI.

2. Install Terraform version 1.12.2 or later. For instructions, see Download Terraform.

   Note: Terraform versions 1.6.0 and later (including version 1.12.2) are distributed under the Business Source License (BSL) and have usage restrictions. Versions 1.5.7 and earlier were distributed as open source under the Mozilla Public License (MPL) and don't have these restrictions. Before you upgrade to Terraform version 1.6.0 or later, you must ensure that you can adhere to the HashiCorp Terraform License terms.

3. Install Packer version 1.15.3 or later. For instructions, see Download Packer.

4. Install a supported Go release. For install instructions, see Download and install Go.

   Also set up a GOPATH by running the following command:

   export PATH=$PATH:$(go env GOPATH)/bin

5. Install Git. For instructions, see Install Git.

6. Check that a Python 3 release of pip is installed by running pip3. If pip3 is not available, review the Python documentation.

7. Install Make.

   CentOS/RHEL

   yum install -y make

   Debian/Ubuntu

   apt-get -y install make

macOS

1. Install the Google Cloud CLI, see Installing the gcloud CLI.

2. Install Terraform version 1.12.2 or later. For instructions, see Download Terraform.

   Note: Terraform versions 1.6.0 and later (including version 1.12.2) are distributed under the Business Source License (BSL) and have usage restrictions. Versions 1.5.7 and earlier were distributed as open source under the Mozilla Public License (MPL) and don't have these restrictions. Before you upgrade to Terraform version 1.6.0 or later, you must ensure that you can adhere to the HashiCorp Terraform License terms.

3. Install Packer version 1.15.3 or later. For instructions, see Download Packer.

4. Install a supported Go release. For install instructions, see Download and install Go.

   Also set up a GOPATH by running the following command:

   export PATH=$PATH:$(go env GOPATH)/bin

5. Install Git. For instructions, see Install Git.

6. Check that a Python 3 release of pip is installed by running pip3. If pip3 is not available, download and install the package.

7. Install Make. On macOS, make is packaged with the Xcode command line developer tools. To install Xcode, run the following command:

   xcode-select --install

What's next

• Set up Cluster Toolkit.
• Review Deploy a cluster with blueprints.