Terraformを用いたGKE構築 #Docker

目的

Kubernetes(以下、k8s)環境をサクッと体験してみたい
k8sもコードで 管理 したい
etc...

使用するアプリケーション

GCP
- Google社が提供しているクラウドプラットフォーム
- このサービスの中のKubernetes Engineを使います
Terraform
- HashiCorp社製のコード管理ツール
- k8sのスペック管理や構築に使います
Docker
- 言わずとしれた仮想化コンテナ技術
  - 詳しくは他の記事を参考にして下さい
- 今回はDocker for Macを用いて、Terraformの実行環境をコード化します
git
- コードの管理・受け渡しに使います

準備

GCPの準備・開設

他に詳しく書いてる方が沢山いますので割愛します。

GCP上のサービスアカウントキー取得

[https://console.cloud.google.com/home/]

APIとサービス > [認証情報]をクリック
- [認証情報を作成]をクリック
  - [サービスアカウントキー]をクリック
下記のように新しくサービスアカウントを作成する
- 役割は適宜変更して下さい

json形式のサービスアカウントをダウンロード

ソースのclone

お手元の環境にソースをcloneします

cd ${作業ディレクトリ}
git clone https://github.com/iganari/try-gke.git
cd try-gke

認証情報の設置

先程ダウンロードした認証情報のjsonを service-account.json という名前に変更します

## 例
mv hogehoge.json service-account.json

リネームしたjsonを先程cloneしたディレクトリにコピーします

$ ls -1 try-gke/
Dockerfile
docker-build-run.sh
etc/
main.tf
operation-tf-build.sh
operation-tf-remove.sh
readme.md
service-account.json        <--------- これ
service-account.json.sample
terraform/
variables.tf

起動設定の変更

variables.tf の中にGCP上のプロジェクト名やk8sクラスターの名前やノードの数、バージョンを記入するとこがあるので適宜編集しましょう

vim variables.tf

最低限変更が必要な項目
- project
- master_auth_password
- min_master_version(※ 古いバージョンになった場合)
- node_version(※ 同上)

dockerの起動

dockerコマンドがsudo無しで起動出来る環境を想定していますので適宜環境にあわせて sudo 等をつけて下さい

sh docker-build-run.sh

起動するとコンテナの中にログインしています
- 以下の作業でがあるものは上記のコンテナ内での作業(コマンド)です

Terraformの初期作業

Terraformを使用するための初期作業が必要になるのでコマンドで実施します。

terraformの初期設置

./terraform/terraform init

結果

Terraform has been successfully initialized!

Terraformを使って、GKE上にk8sクラスターを起動

terraformの実施

sh operation-tf-build.sh

しばらくすると、GKE上に任意のK8sが作成出来きてます

k8sにアクセスしてみる

このままだと外からk8sを見ているだけなので、k8sの内部にアクセスしてみる

環境変数を抜き出す

export client_email=`cat service-account.json | grep client_email | awk -F\" '{print $4}'`

export project_id=`cat service-account.json | grep project_id | awk -F\" '{print $4}'`

export myid=`cat terraform.tfstate | jq -r '.modules[].resources[].primary.attributes.id''`

export myzone=`cat terraform.tfstate | jq -r '.modules[].resources[].primary.attributes.zone'`

GCPに対してgoogle authを通す

gcloud auth activate-service-account \
            ${client_email} \
            --key-file ./service-account.json \
            --project ${project_id}

今回作成したk8sに対して、kubectl コマンドのアクセスを作成する

gcloud container clusters get-credentials \
                 ${myid} \
                 --zone ${myzone} \
                 --project ${project_id}

Kubernetes コントロールプレーンへのプロキシを開始する

kubectl proxy --address='0.0.0.0' &

ブラウザで確認する
- http://127.0.0.1:8001/ui

これで手元のとGKE上のk8sを繋ぐことが出来ました

破棄

作業が終わったら、各リソースを削除しておきましょう

terraformによるk8sの削除

sh operation-tf-remove.sh

コンテナの破棄

exit

注意点

clusterの数を変更する場合、一度全てのnodeが破棄されるためサービス維持に難有り。

Terraformを用いたGKE構築

目的