> [!CAUTION]
> You are currently viewing version 1.3 of the Apigee hybrid documentation. **This version is end of life.** You should upgrade to a newer version. For more information, see [Supported versions](https://docs.cloud.google.com/apigee/docs/hybrid/supported-platforms.md.txt#supported-versions).

<button class="button button-with-icon cloud-select-dropdown__button button-primary" aria-haspopup="true">Version 1.3 (unsupported)</button>

- Supported versions:
- [v1.17 (latest)](https://docs.cloud.google.com/apigee/docs/hybrid/v1.17/install-create-cluster.md.txt)
- [v1.16](https://docs.cloud.google.com/apigee/docs/hybrid/v1.16/install-create-cluster.md.txt)
- [v1.15](https://docs.cloud.google.com/apigee/docs/hybrid/v1.15/install-create-cluster.md.txt)
- [v1.14](https://docs.cloud.google.com/apigee/docs/hybrid/v1.14/install-create-cluster.md.txt)
- [List of supported versions](https://docs.cloud.google.com/apigee/docs/hybrid/supported-platforms.md.txt#supported-versions)
- Unsupported versions:
- [v1.13](https://docs.cloud.google.com/apigee/docs/hybrid/v1.13/install-create-cluster.md.txt)
- [v1.12](https://docs.cloud.google.com/apigee/docs/hybrid/v1.12/install-create-cluster.md.txt)
- [v1.11](https://docs.cloud.google.com/apigee/docs/hybrid/v1.11/install-create-cluster.md.txt)
- [v1.10](https://docs.cloud.google.com/apigee/docs/hybrid/v1.10/install-create-cluster.md.txt)
- [v1.9](https://docs.cloud.google.com/apigee/docs/hybrid/v1.9/install-create-cluster.md.txt)
- [v1.8](https://docs.cloud.google.com/apigee/docs/hybrid/v1.8/install-create-cluster.md.txt)
- [v1.7](https://docs.cloud.google.com/apigee/docs/hybrid/v1.7/install-create-cluster.md.txt)
- [v1.6](https://docs.cloud.google.com/apigee/docs/hybrid/v1.6/install-create-cluster.md.txt)
- [v1.5](https://docs.cloud.google.com/apigee/docs/hybrid/v1.5/install-create-cluster.md.txt)
- [v1.4](https://docs.cloud.google.com/apigee/docs/hybrid/v1.4/install-create-cluster.html)
- [v1.3](https://docs.cloud.google.com/apigee/docs/hybrid/v1.3/install-create-cluster.md.txt)
- [v1.2](https://docs.cloud.google.com/apigee/docs/hybrid/v1.2/install-create-cluster.md.txt)
- [v1.1](https://docs.cloud.google.com/apigee/docs/hybrid/v1.1/install-create-cluster.md.txt)

> [!WARNING]
> **Upgrading:** If you are upgrading to Apigee hybrid v1.3.6, see [Upgrading Apigee hybrid](https://docs.cloud.google.com/apigee/docs/hybrid/v1.3/upgrade.md.txt) for instructions. If you are performing a new installation, continue with the configurations described below.

## Before you begin:


These steps assume you have created environment variables in the previous steps. Check them with
the following commands:

    echo $PROJECT_ID
    echo $ANALYTICS_REGION
    echo $ORG_NAME
    echo $ENV_NAME

### *Click for descriptions and commands to define the variables.*


These steps use the following environment variables:

- <var translate="no">PROJECT_ID</var>: The ID of your Google Cloud project. See [Hybrid
  quickstart - Step 2: Create a Google Cloud project](https://docs.cloud.google.com/apigee/docs/hybrid/v1.3/precog-gcpproject)

  ```
  export PROJECT_ID=your_project_ID
  ```
- <var translate="no">ANALYTICS_REGION</var>: The region in which your GKE project is running.The analytics region for your org. See [Hybrid
  quickstart - Step 4: Create an organization](https://docs.cloud.google.com/apigee/docs/hybrid/v1.3/precog-provision)

  ```
  export ANALYTICS_REGION=your_analytics region
  ```
- <var translate="no">ORG_NAME</var>: The name of your org. This must match your Google Cloud project ID. See [Hybrid
  quickstart - Step 4: Create an organization](https://docs.cloud.google.com/apigee/docs/hybrid/v1.3/precog-provision)

  ```
  export ORG_NAME=your_organization_name
  ```
- <var translate="no">ENV_NAME</var>: The name of your hybrid environment. See [Hybrid
  quickstart - Step 6: Create an environment group](https://docs.cloud.google.com/apigee/docs/hybrid/v1.3/precog-add-environment)

  ```
  export ENV_NAME=your_environment_name
  ```


This step explains how to set up your shell environment and create a GKE cluster
in your Google Cloud project.

## Set up your terminal shell

The `gcloud` tool provides the primary command-line interface
for Google Cloud, and `kubectl` provides the primary command-line interface for
running commands against Kubernetes clusters.

1. Be sure you have `gcloud` and `kubectl` installed in your
   local shell. The `gcloud` tool provides the primary command-line interface
   for Google Cloud, and `kubectl` provides the primary command-line interface for
   running commands against Kubernetes clusters.

       gcloud -h
       kubectl -h

2. If you do not have these utilities installed, install them now as follows:
   1. [Install the Cloud SDK](https://cloud.google.com/sdk/install), which includes the `gcloud` command-line tool.
   2. After installing Cloud SDK, install the `kubectl` command-line tool by running the following command:

   ```
   gcloud components install kubectl
   ```
3. Use the `gcloud` tool to configure two default settings: your default [project](https://cloud.google.com/resource-manager/docs/creating-managing-projects) and [compute region](https://cloud.google.com/compute/docs/regions-zones/#available). Configuring these settings makes it easier to run `gcloud` commands, because `gcloud` requires that you specify the project and compute region in which you want to work.


   To list the current settings, run the following command:

   ```
   gcloud config list
   ```


   If a project and/or compute region is not listed, then you need to add them with the
   commands shown below. If, from the list output, you determine that you need to switch the current settings
   to reflect your project and compute region, you can also use these commands:

       gcloud config set project $PROJECT_ID
       gcloud config set compute/region $ANALYTICS_REGION


   Where:
   - **<var translate="no">PROJECT_ID</var>** is the name of your Google Cloud project.
   - **<var translate="no">ANALYTICS_REGION</var>** is the name of a Google Cloud compute region

## Create a GKE cluster

> [!CAUTION]
> **Caution:** Apigee does not support [GKE Sandbox](https://cloud.google.com/kubernetes-engine/docs/concepts/sandbox-pods) or [gVisor](https://github.com/google/gvisor).


In this step, you will create a Kubernetes cluster in your Google Cloud project (the project you set
with the `gcloud config` command represented by `PROJECT_ID`).

> [!NOTE]
> **Note:** The following command assumes you set the `gcloud` configuration for the compute region, as explained in the previous steps. If you did not set the configuration, then you will need to add the `--region "compute-region"` parameter to the command.

> [!NOTE]
> **Note:** We recommend you check the default Kubernetes version and make sure it meets the version requirements listed in [Supported platforms](https://docs.cloud.google.com/apigee/docs/hybrid/v1.3/install-before-begin.md.txt#supported-platforms). To determine which Kubernetes version is the default, use the following command:
>
> ```
> gcloud container get-server-config
> ```
>
>
> If you don't want to use the default, you can add the `--cluster-version` flag to the cluster
> creation command. For details, see [gcloud container clusters create.](https://cloud.google.com/sdk/gcloud/reference/container/clusters/create)

### Create the cluster

1. Create the CLUSTER_NAME environment variable with the following command (optional):

   ```
   export CLUSTER_NAME=cluster-name
   ```


   Where <var translate="no">cluster-name</var> is the name you choose for the cluster.
2. Execute the following command to create the cluster. The machine type, number of nodes, and other settings specified in the command create a minimally configured cluster suitable for a trial Apigee hybrid installation.

   > [!NOTE]
   > **Note:** The size of the cluster you will create in this step has a minimal amount of resources suitable for trial or testing only. For more detailed information, about cluster resource requirements for production and non-production environments, see:
   > - [GKE production cluster requirements](https://docs.cloud.google.com/apigee/docs/hybrid/v1.3/gke-cluster-setup)
   > - [GKE non-production cluster requirements](https://docs.cloud.google.com/apigee/docs/hybrid/v1.3/gke-cluster-non-prod-setup)

   ```
   gcloud container clusters create $CLUSTER_NAME \
   --machine-type "e2-standard-4" --num-nodes "4" --enable-autoscaling --min-nodes "3" --max-nodes "6"
   ```


   Cluster creation can take a few minutes. Upon success, output similar to the following, with a
   status of `RUNNING`, is displayed:

   ```
   NAME           LOCATION       MASTER_VERSION  MASTER_IP     MACHINE_TYPE   NODE_VERSION   NUM_NODES  STATUS
   apigee-hybrid  us-central1    1.15.12-gke.2   35.222.54.89  e2-standard-4  1.15.12-gke.2             RUNNING
   ```

## Set the current context


A *context* is a group of access parameters. Each context contains a Kubernetes cluster,
a user, and a namespace. The current context is the cluster that is currently the default for
`kubectl`: all `kubectl` commands run against that cluster.


Make sure the current `gcloud` context is set to the cluster you just created.

1. First, list the contexts to determine which is the *current* context. In the following example, the current context is `gke_hybrid-project_us-central1_apigee-hybrid`. The name includes the name of a Google Cloud project (`hybrid-project`), a region (`us-central1`), and a cluster name (`apigee-hybrid`).

   ```
   kubectl config get-contexts
   ```


   The results should look something like the following example:

   ```
   CURRENT   NAME                                             CLUSTER                                          AUTHINFO                                           NAMESPACE
   *         gke_hybrid-project_us-central1_apigee-hybrid     gke_hybrid-project_us-central1_apigee-hybrid     gke_hybrid-project_us-central1_apigee-hybrid
             gke_apigee-project_us-west1_apigee-cluster       gke_apigee-project_us-west1_apigee-cluster       gke_apigee-project_us-west1_apigee-cluster
   ```
2. If necessary, set the current context to the cluster you just created (the cluster into which you intend to install Apigee hybrid). Using the previous `get-contexts` output, you can switch to the correct context, as follows:

   ```
   kubectl config use-context context
   ```

   Where <var translate="no">context</var> is the full context name for your cluster as output by the
   previous `get-contexts` command. For
   example: `gke_apigee-project_us-west1_apigee-cluster`.
3. Check the current context to be sure it is set to the intended cluster using the following command:

   ```
   kubectl config current-context
   ```


   For example:

   ```
   gke_apigee-project_us-west1_apigee-cluster
   ```

## Grant cluster credentials


[Cluster credentials](https://cloud.google.com/sdk/gcloud/reference/container/clusters/get-credentials) give you access to the containers running in the cluster. Fetch your
credentials and grant yourself the **cluster-admin** role:

1. Fetch the credentials by entering the following command:

   ```
   gcloud container clusters get-credentials $CLUSTER_NAME
   ```

   Where **`CLUSTER_NAME`** is the name is the name of the cluster you
   created (the cluster into which you intend to install Apigee hybrid).


   You should see a result similar to the following:

   ```
   Fetching cluster endpoint and auth data.
   kubeconfig entry generated for example-cluster.
   ```
2. Set the cluster role binding. Execute the following command exactly as shown:

   ```
   kubectl create clusterrolebinding cluster-admin-binding \
   --clusterrole cluster-admin --user $(gcloud config get-value account)
   ```


   You should see a result similar to the following:

   ```
   clusterrolebinding.rbac.authorization.k8s.io/cluster-admin-binding created
   ```

## Summary


You now have a Kubernetes cluster running in your Google Cloud project. Your shell environment is
set up, and you are ready to install the cert-manager and istio services required by
Apigee hybrid on your local machine.
[1](https://docs.cloud.google.com/apigee/docs/hybrid/v1.3/install-create-cluster.md.txt) [(NEXT) Step 2: Install cert-manager and ASM](https://docs.cloud.google.com/apigee/docs/hybrid/v1.3/install-download-cert-manager-istio.md.txt) [3](https://docs.cloud.google.com/apigee/docs/hybrid/v1.3/install-download-install.md.txt) [4](https://docs.cloud.google.com/apigee/docs/hybrid/v1.3/install-copy-overrides.md.txt) [5](https://docs.cloud.google.com/apigee/docs/hybrid/v1.3/install-apply-hybrid.md.txt)

<br />