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

このステップでは、シェル環境を設定し、Google Cloud Platform（GCP）プロジェクトで Kubernetes クラスタを作成する方法を説明します。

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

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

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

GKE クラスタを作成する

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

次のコマンドを実行してクラスタを作成します。コマンドで指定したマシンタイプ、ノード数、その他の設定により、トライアル 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.13.11-gke.9   35.222.54.89  n1-standard-4  1.13.11-gke.9  3          RUNNING

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

コンテキストとは、アクセスパラメータのグループのことです。各コンテキストには 1 つの Kubernetes クラスタ、1 人のユーザー、1 つの名前空間が含まれます。現在のコンテキストは、現在 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