このステップでは、シェル環境を設定し、Google Cloud Platform（GCP）プロジェクトで GKE クラスタを作成する方法を説明します。
ターミナル シェルを設定する
gcloud ツールは GCP のプライマリ コマンドライン インターフェースを提供します。kubectl は、Kubernetes クラスタに対してコマンドを実行するためのプライマリ コマンドライン インターフェースを提供します。
gcloudとkubectlがローカルシェルにインストールされていることを確認してください。gcloudツールは GCP のプライマリ コマンドライン インターフェースを提供します。kubectlは、Kubernetes クラスタに対してコマンドを実行するためのプライマリ コマンドライン インターフェースを提供します。gcloud -hkubectl -h- これらのユーティリティがインストールされていない場合は、今すぐインストールしてください。
- Cloud SDK をインストールします。この SDK には
gcloudコマンドライン ツールが含まれています。 - Cloud SDK をインストールしたら、次のコマンドを実行して
kubectlコマンドライン ツールをインストールします。
gcloud components install kubectl
- Cloud SDK をインストールします。この SDK には
-
gcloudツールを使用して、デフォルトのプロジェクトおよびコンピューティング リージョンの 2 つのデフォルト設定を構成します。gcloudでは作業するプロジェクトとコンピューティング ゾーンを指定する必要があるため、これらの設定を構成すると、gcloudコマンドを簡単に実行できるようになります。現在の設定を表示するには:
gcloud config list
プロジェクトやコンピューティング ゾーンがリストにない場合は、次のコマンドを使用してこれらを追加する必要があります。リスト出力から、プロジェクトとコンピューティング リージョン（またはゾーン）を反映するために現在の設定を切り替える必要があると判断した場合には、次のコマンドも使用できます。
gcloud config set project project-idgcloud config set compute/region compute-regiongcloud config set compute/zone compute-zoneここで project-id は GCP プロジェクトの名前、compute-region は GCP コンピューティング リージョンの名前、compute-zone は GCP コンピューティング ゾーンの名前です。例:
compute/region 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.14.10-gke.27 35.222.54.89 n1-standard-4 1.14.10-gke.27 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 ハイブリッド ランタイム プレーン ソフトウェアをインストールする準備ができました。