Installing the GKE Enterprise CLI

Note: The GKE Enterprise CLI is no longer supported.

Beta

This product or feature is subject to the "Pre-GA Offerings Terms" in the General Service Terms section of the Service Specific Terms. Pre-GA products and features are available "as is" and might have limited support. For more information, see the launch stage descriptions.

The GKE Enterprise command-line interface (CLI) lets you easily install Anthos Service Mesh on new or existing Google Kubernetes Engine (GKE) clusters. Similar to Kubernetes, the GKE Enterprise CLI operates on a declarative model. You specify the desired state in a set of YAML configuration resource files (also referred to as manifests) that contain the specification for one or more objects. The GKE Enterprise CLI uses several Kubernetes APIs described in the Config Connector resources documentation.

This page explains how to install the GKE Enterprise CLI and the tools that it uses. In addition to the GKE Enterprise CLI, you need to install the following tools:

• kpt: You use kpt to download, manage, and customize the Anthos Service Mesh resource configuration files that are stored in the anthos-service-mesh-packages GitHub repo. The configuration files contain placeholders for your specific Google Cloud project and GKE cluster information.

• kustomize: To use the GKE Enterprise CLI to install Anthos Service Mesh on an existing cluster, you need to install kustomize.

Before you begin

This guide assumes that you already have:

• A Google Cloud project.
• A Cloud Billing account.

Before you start the installation:

• Set up your environment.

Install the Anthos CLI

To install the GKE Enterprise CLI and required tools:

If you are using Cloud Shell, add sudo to the following commands.

1. Install kpt:

   gcloud components install kpt
   

2. Install the GKE Enterprise CLI:

   gcloud components install anthoscli beta
   

3. Get the version that works with Anthos Service Mesh 1.5:

   gcloud components update anthoscli --version 298.0.0
   

4. If you want to install Anthos Service Mesh on an existing cluster, install kustomize to any location on your file system. For example, to install kustomize to the current working directory:

   curl -s "https://raw.githubusercontent.com/\
   kubernetes-sigs/kustomize/master/hack/install_kustomize.sh"  | bash
   

   For more additional installation options, see the kustomize installation documentation.

5. Add the directory where you installed kustomize to your PATH:

   export PATH=$PWD:$PATH
   

What's next

• Install Anthos Service Mesh on a new cluster
• Install Anthos Service Mesh on an existing cluster