ステップ 1: クラスタを作成する

始める前に:

以下の説明では、前の手順で環境変数を作成していることを前提としています。次のコマンドで確認します。

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

クリックすると、変数の定義とコマンドが表示されます。

これらの手順では、次の環境変数を使用します。

PROJECT_ID: Google Cloud プロジェクトの ID。ハイブリッドクイックスタート - ステップ 2: Google Cloud プロジェクトを作成するをご覧ください。
```
export PROJECT_ID=your_project_ID
```
ANALYTICS_REGION: GKE プロジェクトが実行されているリージョン。組織の分析リージョンです。ハイブリッドクイックスタート - ステップ 4: 組織を作成するをご覧ください。
```
export ANALYTICS_REGION=your_analytics region
```
ORG_NAME: 組織の名前。Google Cloud プロジェクト ID と一致する必要があります。ハイブリッドクイックスタート - ステップ 4: 組織を作成するをご覧ください。
```
export ORG_NAME=your_organization_name
```
ENV_NAME: ハイブリッド環境の名前。ハイブリッドクイックスタート - ステップ 6: 環境グループを作成するをご覧ください。
```
export ENV_NAME=your_environment_name
```

このステップでは、シェル環境を設定し、Google Cloud プロジェクトで GKE クラスタを作成する方法について説明します。

ターミナルシェルを設定する

gcloud ツールは Google Cloud の主要なコマンドラインインターフェースを提供し、kubectl は Kubernetes クラスタに対してコマンドを実行するための主要なコマンドラインインターフェースを提供します。

gcloud と kubectl がローカルシェルにインストールされていることを確認してください。gcloud ツールは Google Cloud の主要なコマンドラインインターフェースを提供し、kubectl は Kubernetes クラスタに対してコマンドを実行するための主要なコマンドラインインターフェースを提供します。
```
gcloud -h
kubectl -h
```
これらのユーティリティがインストールされていない場合は、次の手順に従って今すぐインストールしてください。
1. Cloud SDK をインストールします。これには、gcloud コマンドラインツールが含まれています。
2. Cloud SDK をインストールしたら、次のコマンドを実行して kubectl コマンドラインツールをインストールします。
gcloud ツールを使用して 2 つのデフォルト設定を構成します。1 つはデフォルトのプロジェクト、もう 1 つはコンピューティングリージョンです。gcloud コマンドを実行するには、使用するプロジェクトとコンピューティングリージョンを指定する必要があるため、これらの設定を行うと gcloud コマンドをより簡単に実行できます。
現在の設定を一覧表示するには、次のコマンドを実行します。
```
gcloud config list
```
プロジェクトやコンピューティングリージョンがリストにない場合は、次のコマンドを使用して追加する必要があります。リスト出力から、プロジェクトとコンピューティングリージョンを反映するために現在の設定を切り替える必要があると判断した場合には、次のコマンドも使用できます。
```
gcloud config set project $PROJECT_ID
gcloud config set compute/region $ANALYTICS_REGION
```
各要素の意味は次のとおりです。
- PROJECT_ID は Google Cloud プロジェクトの名前です。
- ANALYTICS_REGION は Google Cloud コンピューティングリージョンの名前です。

GKE クラスタを作成する

この手順では、Google Cloud プロジェクト（gcloud config コマンドで設定した PROJECT_ID で表されるプロジェクト）で Kubernetes クラスタを作成します。

注: 次のコマンドでは、前の手順で説明したようにコンピューティングリージョンの gcloud 構成が設定されていることを前提としています。この構成を設定していない場合は、--region "compute-region" パラメータをコマンドに追加する必要があります。

注: デフォルトの Kubernetes のバージョンを確認し、対応プラットフォームに記載されているバージョン要件を満たしていることを確認してください。デフォルトの Kubernetes バージョンを確認するには、次のコマンドを使用します。

gcloud container get-server-config

デフォルトを使用しない場合は、クラスタ作成コマンドに --cluster-version フラグを追加できます。詳細については、gcloud container clusters create をご覧ください。

クラスタを作成する

次のコマンドを使用して、CLUSTER_NAME 環境変数を作成します（省略可）。
```
export CLUSTER_NAME=cluster-name
```
ここで、cluster-name はクラスタに付ける名前です。
次のコマンドを実行してクラスタを作成します。コマンドで指定されているマシンタイプ、ノード数、その他の設定により、トライアルの Apigee ハイブリッドインストールに適した最小構成のクラスタが作成されます。
注: この手順で作成するクラスタのサイズでは、トライアルまたはテストのみに適した最小限のリソース量になります。本番環境と非本番環境のクラスタリソース要件の詳細については、以下をご覧ください。
- GKE 本番環境クラスタの要件
- GKE 非本番環境クラスタの要件
```
gcloud container clusters create $CLUSTER_NAME \
--machine-type "e2-standard-4" --num-nodes "4" --enable-autoscaling --min-nodes "3" --max-nodes "6"
```
クラスタの作成には数分かかることがあります。正常に作成されるとステータスが RUNNING になり、次のような出力が表示されます。
```
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
```

現在のコンテキストを設定する

コンテキストとは、アクセスパラメータのグループのことです。各コンテキストには 1 つの Kubernetes クラスタ、1 人のユーザー、1 つの名前空間が含まれます。現在のコンテキストとは、現在 kubectl のデフォルトとなっているクラスタです。すべての kubectl コマンドはこのクラスタに対して実行されます。

現在の gcloud コンテキストが、先ほど作成したクラスタに設定されていることを確認します。

まず、現在のコンテキストを判別するコンテキストを一覧表示します。次の例では、現在のコンテキストは gke_hybrid-project_us-central1_apigee-hybrid です。名前には、Google Cloud プロジェクトの名前（hybrid-project）、リージョン（us-central1）、クラスタ名（apigee-hybrid）が含まれます。

kubectl config get-contexts

結果は次の例のようになります。

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

必要に応じて、先ほど作成したクラスタ（Apigee ハイブリッドをインストールするクラスタ）に現在のコンテキストを設定します。上記の get-contexts 出力を使用して、次のように正しいコンテキストに切り替えることができます。
```
kubectl config use-context context
```
ここで、context は、上記の get-contexts コマンドで出力されたクラスタの完全なコンテキスト名です。例: gke_apigee-project_us-west1_apigee-cluster。
次のコマンドを使用して、現在のコンテキストが意図したクラスタに設定されていることを確認します。
```
kubectl config current-context
```
次に例を示します。
```
gke_apigee-project_us-west1_apigee-cluster
```

クラスタ認証情報を付与する

クラスタ認証情報によって、クラスタで実行中のコンテナにアクセスできるようになります。認証情報を取得し、自分自身に cluster-admin ロールを付与します。

次のコマンドを入力して、認証情報を取得します。
```
gcloud container clusters get-credentials $CLUSTER_NAME
```
ここで、CLUSTER_NAME は作成したクラスタ（Apigee ハイブリッドをインストールするクラスタ）の名前です。

次のような結果が表示されます。
```
Fetching cluster endpoint and auth data.
kubeconfig entry generated for example-cluster.
```

クラスタロールバインディングを設定します。示されているとおりに次のコマンドを実行します。

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

次のような結果が表示されます。

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

まとめ

これで、Google Cloud プロジェクトで Kubernetes クラスタが実行されるようになりました。シェル環境が設定され、Apigee ハイブリッドが必要とする cert-manager サービスと istio サービスをローカルマシンにインストールする準備ができました。

1 （次）ステップ 2: cert-manager と ASM をインストールする 3 4 5