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

以下では、シェル環境を設定し、Google Cloud Platform（GCP）プロジェクトで GKE クラスタを作成する方法について説明します。

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

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

gcloud と kubectl がローカルシェルにインストールされていることを確認してください。gcloud ツールは GCP への主要なコマンドラインインターフェースを提供し、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 compute-region
gcloud config set compute/zone compute-zone
```
ここで、project-id は GCP プロジェクトの名前、compute-region は GCP コンピューティングリージョンの名前、compute-zone は GCP コンピューティングゾーンの名前です。例: compute/region us-central1。コンピューティングリージョンとコンピューティングゾーンの一覧については、使用可能なリージョンとゾーンをご覧ください。

GKE クラスタを作成する

ここでは、GCP プロジェクト（gcloud config コマンドで設定したプロジェクト）で Kubernetes クラスタを作成します。

注: 次のコマンドでは、前のステップで説明したように、コンピューティングリージョンやコンピューティングゾーンに gcloud 構成を設定していることが前提となっています。この構成を設定していない場合は、--region "compute-region" パラメータまたは --zone "compute-zone" パラメータ（あるいはその両方）をコマンドに追加する必要があります。

次のコマンドを実行してクラスタを作成します。コマンドで指定されているマシンタイプ、ノード数、その他の設定により、トライアルの Apigee ハイブリッドインストールに適した最小限の構成のクラスタが作成されます。

gcloud container clusters create cluster-name \
--machine-type "n1-standard-4" --num-nodes "3" --enable-autoscaling --min-nodes "3" --max-nodes "6"

ここで、cluster-name はクラスタに付ける名前です。

クラスタの作成には数分かかることがあります。正常に完了すると、ステータスが RUNNING である次のような出力が表示されます。

NAME           LOCATION       MASTER_VERSION  MASTER_IP     MACHINE_TYPE   NODE_VERSION   NUM_NODES  STATUS
apigee-hybrid  us-central1-a  1.14.10-gke.27   35.222.54.89  n1-standard-4  1.14.10-gke.27          RUNNING

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

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

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

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

kubectl config get-contexts
CURRENT   NAME                                             CLUSTER                                          AUTHINFO                                           NAMESPACE
*         gke_hybrid-project_us-central1-a_apigee-hybrid   gke_hybrid-project_us-central1-a_apigee-hybrid   gke_hybrid-project_us-central1-a_apigee-hybrid
          gke_apigee-project_us-west1-a_apigee-cluster     gke_apigee-project_us-west1-a_apigee-cluster     gke_apigee-project_us-west1-a_apigee-cluster

必要に応じて、先ほど作成したクラスタ（Apigee ハイブリッドをインストールするクラスタ）に現在のコンテキストを設定します。前述の get-contexts の出力で、作成したクラスタ名がリージョン us-west1 の apigee-cluster である場合、次のように gke_apigee-project_us-west1-a_apigee-cluster コンテキストに切り替えます。
```
kubectl config use-context gke_apigee-project_us-west1-a_apigee-cluster
```
ここで gke_apigee-project_us-west1-a_apigee-cluster は、切り替え先のコンテキストの名前です。
現在のコンテキストが、意図したクラスタに設定されていることを確認します。次に例を示します。
```
kubectl config current-context
 gke_apigee-project_us-west1-a_apigee-cluster
```

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

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

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

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

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

まとめ

これで、GCP プロジェクトで Kubernetes クラスタが実行されている状態になりました。シェル環境が設定され、ローカルマシンに Apigee ハイブリッドランタイムプレーンソフトウェアをインストールする準備ができました。

1 （次）ステップ 2: apigeectl をインストールする 3 4