【GCloud】Google Cloud CLIをインストールしよう！コマンド手順も紹介

20230930_Gcloud クラウドプラットフォーム
2023.09.30

Google Cloud CLI が使えるようになるとコマンドラインから Google Cloud リソースの作成や管理ができます．

画面でも同じような操作ができるため一見不要に思えますが，画面はデザインが変わってしまえば操作手順も変わるでしょう．一方でコマンドラインが変わることはあまりないため，１度覚えたコマンドはずっと役立ちます．

今回は Google Cloud CLI をインストールする手順について紹介します．

インストール環境

インストールする環境：Ubuntu 22.04.2 LTS

$ lsb_release -a
No LSB modules are available.
Distributor ID: Ubuntu
Description:    Ubuntu 22.04.2 LTS
Release:        22.04
Codename:       jammy

事前準備

初めにパッケージを更新しておきます．

$ sudo apt-get update

後の操作で apt-transport-https と curl コマンドを使うため前もってインストールしておきましょう！

$ sudo apt-get install apt-transport-https ca-certificates gnupg curl sudo

CLIを使うためのインストール手順

パッケージソースを追加する

CLIを使うためにパッケージソースを追加します．
追加するファイルは /etc/apt/sources.list.d/google-cloud-sdk.list です．

このときsigned-byオプションが使えるかどうかで実行するコマンドが変わるので注意しましょう！
オプションが使えるかはapt --helpで確認できます．

クリックして拡大できます

私はサポートされていなかったので下のコマンドを実行しました．
ちなみにsinged-byオプションはリポジトリ内のパッケージが信頼できる公開鍵で署名されているか確認する役割があります．

  • signed-byオプションがサポートされている場合に実行する
$ echo "deb [signed-by=/usr/share/keyrings/cloud.google.asc] https://packages.cloud.google.com/apt cloud-sdk main" | sudo tee -a /etc/apt/sources.list.d/google-cloud-sdk.list
  • signed-byオプションがサポートされていない場合に実行する
$ echo "deb https://packages.cloud.google.com/apt cloud-sdk main" | sudo tee -a /etc/apt/sources.list.d/google-cloud-sdk.list

catコマンドでファイルの中身を確認しました．
コマンドを2回実行したなどで cloud-sdkのエントリが重複しているインストールが失敗します．

単一のエントリであることを確認しておきましょう！

クリックして拡大できます

Google Cloud の公開鍵をインポートする

apt-key コマンドが --keyring 引数をサポートしているかどうかでコマンドが変わるため使用可否を確認します．

$ apt-key --help
クリックして拡大できます

--keyring が見当たらないためサポートされていないようです．
また私は Ubuntu 21.10 以降であるため以下のコマンドを実行しました．

  • 使用しているディストリビューション（Debian 11 以降または Ubuntu 21.10 以降）が apt-key をサポートしていない場合
curl https://packages.cloud.google.com/apt/doc/apt-key.gpg | sudo tee /usr/share/keyrings/cloud.google.asc
クリックして拡大できます

--keyring 引数がサポートされているかに合わせてコマンドを変えましょう！

  • 使用しているディストリビューションの apt-key コマンドが --keyring 引数をサポートしている場合
curl https://packages.cloud.google.com/apt/doc/apt-key.gpg | sudo apt-key --keyring /usr/share/keyrings/cloud.google.gpg add -
  • 使用しているディストリビューションの apt-key コマンドで --keyring 引数がサポートされていない場合
curl https://packages.cloud.google.com/apt/doc/apt-key.gpg | sudo apt-key add -

gcloud CLI を更新してインストールする

CLI をインストールする準備が整ったのでインストールします．

$ sudo apt-get update && sudo apt-get install google-cloud-cli
クリックして拡大できます

初期設定をする

Google Cloud CLI のインストールが終了しました．

最後に初期設定をしましょう！

$ gcloud init

このコマンドを実行すると初期設定ができます．

Go to the following link in your browser:に続くURLに遷移しましょう．

クリックして拡大できます

Googleアカウントを選び認証情報をコピーします．

クリックして拡大できます

コピーした認証情報を Enter authorization code:の後にペーストし Enter を実行しましょう！

クリックして拡大できます

これでログインが成功しました．

$ gcloud --version
クリックして拡大できます

バージョンも確認できるようになっていますね．

まとめ

今回は Google Cloud CLI をインストールする手順について紹介しました．

すんなりとインストールできたでしょうか？
私がインストールしたときはパッケージソースの追加でちょっと詰まりました．

singed-byオプションがサポートされていないにも関わらず，オプションを使うコマンドを実行してインストールが失敗しました．さらにエントリは重複するなど後始末が面倒でした．

何をするコマンドなのか理解してから実行すべきだと学びましたね．

今回は公式ドキュメントをもとにインストールしました．
詰まった場合は見返すと良いでしょう．

gcloud CLI をインストールする  |  Google Cloud CLI Documentation
cloud.google.com