GCP(Google Cloud Platform)
エンジニアのためのWebチートシート

Google Cloud Platform(GCP)とは、Googleが提供しているクラウドコンピューティングサービスです。Google検索やYouTubeなどのサービスでも利用されています。GCPが提供するCLIツールのコマンドをチートシートにまとめてみました。

一般

SDKの更新

```
gcloud components update
```

アカウントの確認

```
gcloud auth list
```

設定の確認

gcloud config list

補足

pecoと組み合わせてプロジェクト/アカウント切り替えをするスクリプトを用意しておくと便利です。gcloudコマンド（GCP）で複数のプロジェクトとアカウントの使い分けを便利に

function gconf() {
  projData=$(gcloud config configurations list | peco)
  if echo "${projData}" | grep -E "^[a-zA-Z].*" > /dev/null ; then
    config=$(echo ${projData} | awk '{print $1}')
    gcloud config configurations activate ${config}

    echo "=== The current account is as follows ==="
    gcloud config configurations list | grep "${config}"
  fi
}

デフォルトプロジェクトの切り替え

gcloud config set project <project name>

実行プロジェクトの指定

```
gcloud --project <project id>
```

リージョン毎のクォータ

```
gcloud compute regions list
```

GCE(Google Compute Engine)

インスタンス一覧を取得

```
gcloud compute instances list
```

インスタンスの作成

gcloud compute instances create <instance-name> --project <project name> --zone <region>

Firewallのルール参照

```
gcloud compute routes list
```

GAE(Google App Engine)

ブラウザでプロジェクトを開く

```
gcloud app browse
```

デプロイ

```
gcloud app deploy
```
補足
GAEはデプロイ後、古いバージョンを保持します。gcloud app deployを実行するとトラフィックが新しいバージョンに自動で振り分けられます。デプロイ後、マイグレーションの実行が必要などの理由がある場合、トラフィックは変更せずに新しいバージョンをデプロイすることができます。
```
gcloud app deploy --no-promote
bundle exec rake appengine:exec -- bundle exec rake db:migrate
gcloud app versions list    # confirm default version
[YOUR-VERSION]-dot-[PROJECT-NAME].appspot.com
gcloud app services set-traffic default --splits [YOUR-VERSION]=1
```
GAEのデプロイはとても長く、さらに、よくデプロイに失敗します。gcloud app deployはapp.yamlからDockerfileを生成し、Dockerイメージの作成、Container Registryにpushしてビルドといった一連の流れを行います。デプロイに失敗した際に、Dockerイメージ自体の生成は完了していた場合、DockerイメージのURLを指定してデプロイすることができます。
```
gcloud app deploy app.yaml --image-url [DockerImageURL]
```

サービスの詳細を確認

```
gcloud app describe
```

サービスリストを取得

```
gcloud app services list
```

デフォルトのサービスの取得

```
gcloud app services describe default
```

バージョンリストの取得（トラフィックの分割状況）

```
gcloud app versions list
```

バージョンの詳細を取得

```
gcloud app versions describe --service default <VERSION>
```
補足
バージョンの詳細な情報を取得することができます。app.yamlで設定した内容が反映されているかも確認することができます。YAML

ログの確認

```
gcloud app logs read
```

指定したバージョンの削除

```
gcloud app versions delete <VERSION>
```
補足
バージョンの一覧は下記コマンドで取得することができます。
```
gcloud app versions list
```

指定したバージョンの停止

```
gcloud app versions stop <VERSION>
```

指定したバージョンの開始

```
gcloud app versions start <VERSION>
```

cronジョブ（定期実行）

```
gcloud app deploy cron.yaml    #deploy

# cron.yaml
cron:
- description: "daily summary job"
  url: /tasks/summary
  schedule: every 24 hours
- description: "monday morning mailout"
  url: /mail/weekly
  schedule: every monday 09:00
  timezone: Australia/NSW
- description: "new daily summary job"
  url: /tasks/summary
  schedule: every 24 hours
  target: beta
```
補足
GAEを使用して定期実行するには、cron.yamlを作成してジョブを登録します。コマンドの実行はできないためルーティングを用意してURLに定期的にアクセスする形で実行されます。詳しい設定方法は下記リンクを参照ください。cron.yaml を使用したジョブのスケジューリング

リソースの設定

app.yamlに設定を記述することで、コンピューティングリソースを制御することができます。Google App Engineは、指定したCPUとメモリの量に基づいて、マシンタイプを割り当てます。マシンは少なくとも指定したリソースレベルは確実に満たし、それ以上のリソースを持つこともあります。
```
resources:
  cpu: 2
  memory_gb: 2.3
  disk_size_gb: 10
  volumes:
  - name: ramdisk1
    volume_type: tmpfs
    size_gb: 0.5
```
補足
設定値の詳細は公式サイトを参照してください。app.yaml 構成ファイル

GCS(Google Cloud Storage)

Cloud SQL Proxyの設定

# install cloud_sql_proxy
curl -o cloud_sql_proxy https://dl.google.com/cloudsql/cloud_sql_proxy.darwin.amd64

# permission setting
chmod +x cloud_sql_proxy

# execute proxy
~/path/to/cloud_sql_proxy -instances=<INSTANCE_NAME>=tcp:3306