執筆者：Handbook編集部
gcloudの使い方
gcloud ツールとは
gcloud コマンドライン ツールは、Google Cloud リソースの作成と管理を行う基本的な CLI（コマンドラインインターフェス）ツールです。このツールを使用すると、コマンドラインから、またはスクリプトや他の自動化により、多くの一般的なプラットフォームタスクを実行できます。
また、gcloud ツールを使用して、App Engine アプリケーションのデプロイ、認証の管理、ローカル構成のカスタマイズ、その他のタスクの実行もできます。
gcloud ツールを使用するには、システムに Cloud SDK をインストールし、Cloud SDK を初期化する必要があります。この記事は、インストールから使い方まで書いていきます。
インストール手順
-
Cloud SDK のインストーラをダウンロードします。
-
Next を押下します。
- I Agree を押下します。
- All users を選択し、Next を押下します。
- インストールする場所を選択します。特に変更がなければこのまま Next を押下でよいです。
- インストールするコンポーネントを選択し、このまま Install を押下でよいです。
- インストールが完了しました。Next を押下します。
- 「Run ‘gcloud init’ to configure the Cloud SDK」のチェックを外し、Finish を押下します。
- インストールが完了したらコマンドプロンプトが開きますので、下記コマンドを実行します。
gcloud init
- 下記が出ましたら、
1を入力し、Enterを押します。
Pick configuration to use:
[1] Re-initialize this configuration [default] with new settings
[2] Create a new configuration
Please enter your numeric choice:
- 下記が出ましたら、
Yを入力します。
You must log in to continue. Would you like to log in (Y/n)?
-
google アカウントの認証画面がブラウザで開くので、認証を進めます。プロジェクトの作成を行った google アカウントが表示されている場合は、選択します。表示されていない場合は「アカウントの追加」を行ってください。
-
「許可」ボタンを押下し、認証を完了させます。
- 認証が完了するとコマンドラインに google アカウントに紐付けされているプロジェクトの ID 一覧が表示されます。プロジェクト ID の番号を選択します。
Pick cloud project to use:
[番号] プロジェクトIDPlease enter numeric choice or text value (must exactly match list
item):
- 今回は Google Compute Engine の設定は行わないので、
nを選択します。これで初期設定が完了しました。
Do you want to configure Google Compute Engine
(https://cloud.google.com/compute) settings (Y/n)?
gcloud の使い方
GCP 認証
個人の権限（＝ユーザアカウント）を用いて、プログラミング言語のクライアントライブラリから GCP を利用する場合はターミナルなどで以下のコマンドを実行します
$ gcloud auth application-default login
そうすると Web ブラウザに飛ばされ、そこで個人の権限で GCP の認証をすれば、ローカルの ~/.config/gcloud/application_default_credentials.json にトークンが保存されます。
これがあればGOOGLE_APPLICATION_CREDENTIALSの環境変数がなくても、プログラミング言語のクライアントライブラリから GCP を利用できます。
認証されたアカウント一覧表示
$ gcloud auth list
Credentialed Accounts
ACTIVE ACCOUNT
* xxx.yyy@example.com
アクティブな gcloud CLI 構成のプロパティ一覧表示
$ gcloud config list
[core]
account = xxx.yyy@example.com
disable_usage_reporting = True
project = my-project
Your active configuration is: [default]
プロジェクトの一覧表示
$ gcloud projects list
PROJECT_ID NAME PROJECT_NUMBER
project1 project1 111111111111
project2 project2 222222222222
プロジェクトの切り替え
$ gcloud config set project <YOUR PROJECT ID>
コマンドの詳細を確認
$ gcloud help <COMMAND>
（例：gcloud help compute)
GCE （Google Compute Engine） に関する主要コマンド
インスタンス一覧表示
$ gcloud compute instances list
利用可能なインスタンスイメージ一覧表示
$ gcloud compute images list
インスタンス作成
$ gcloud compute instances create <YOUR INSTANCE NAME> --project <YOUR PROJECT NAME> --image-family <IMAGE FAMILY>
インスタンス起動
$ gcloud compute instances start <YOUR INSTANCE NAME>
インスタンス停止
$ gcloud compute instances stop <YOUR INSTANCE NAME>
インスタンスに ssh 接続
$ gcloud compute ssh <YOUR INSTANCE NAME>
参考
- gcloud の概要
- Google Cloud SDK をインストール（公式）
- Google Cloud SDK をインストール（for Mac）
- Cloud SDK を mac, Linux, Windows にインストール・初期設定までの導入手順徹底解説！！
Hakky ではエンジニアを募集中です！まずは話してみたいなどでも構いませんので、ぜひお気軽に採用ページからお問い合わせくださいませ。
