gcloud CLIのインストールとGoogle Cloudの管理方法

Google Cloud Platform(GCP)のユーザーとして、Webコンソールを介してリソースやアプリケーションを管理できます。しかし、タスクを自動化したり、コマンドラインからGoogle Cloudを管理したい場合はどうでしょうか?心配しないでください! gcloudコマンドラインインターフェイス(gcloud CLI)ツールが必要です。

このチュートリアルでは、gcloud CLIをマシンにインストールし、GCPリソースの管理に関する基本的なコマンドを開始する方法について学びます。

お楽しみに、そしてGCPリソース管理を向上させてください!

前提条件

このチュートリアルは実演形式で行われます。一緒に進むために、次のものを確認してください:

A Google Cloud account with active billing – A free trial will suffice if you do not have one yet.

A Windows 10 machine with an internet connection. This tutorial uses the 21H2 version.

あなたのマシンにインストールされている

gcloud CLIのダウンロードとインストール

よりCLI志向のユーザーの場合、Google Cloud SDKインストーラーを使用してgcloud CLIをインストールできます。このクロスプラットフォームインストーラーは、他のGoogle Cloud SDKツールと共にgcloud CLIをインストールします。

1. 好きなウェブブラウザを開き、Google Cloudからインストーラーをダウンロードします。

または、管理者としてPowerShellを開き、以下のコマンドを実行して最新の安定版のgcloud CLIインストーラーをダウンロードします。このコマンドは出力を提供せず、自動的にGoogle Cloud CLIセットアップウィザードを開始します。

(New-Object Net.WebClient).DownloadFile("https://dl.google.com/dl/cloudsdk/channels/rapid/GoogleCloudSDKInstaller.exe", "$env:Temp\GoogleCloudSDKInstaller.exe")

& $env:Temp\GoogleCloudSDKInstaller.exe

2. ダウンロードが完了したら、インストーラーを開きます。これにより、Google Cloud CLIセットアップウィザード(ステップ3)が表示されます。インストーラーを開けない場合は、管理者として実行してください。

3. Google Cloud CLIセットアップウィザードで、下図のように最初のチェックボックスにチェックを入れ、次へをクリックします。このオプションにより、スクリーンリーダーモードがオンになります。

このオプションを有効にすると、インストール中にプロセスバーの表示など、インストール中のスクリーンリーダーの使用がスムーズになります。

Turning on the screen reader mode

4. ライセンス条件を読み、同意するために「同意する」をクリックします。

Accepting the license agreement

5. 同意したら、インストールタイプ(シングルユーザー)を選択し、次へをクリックします。

Selecting the install type

6. 次に、インストール先を選択し、次へをクリックします。

Selecting the installation location

7. 全てのチェックボックスにチェックを入れ、Python v3およびCloud Tools for PowerShellを含む必要な依存関係をインストールするために「インストール」をクリックします。

Selecting components to install

以下のように、インストーラーは必要なすべての依存関係とCLIコアをダウンロードしてインストールします。このプロセスには数分かかる場合があります。

Viewing installation progress

8. インストールが完了したら、[次へ] をクリックして続行します。

Confirming gcloud CLI has been installed

9. 最後に、以下のすべてのチェックボックスをオンにし、[完了] をクリックしてインストールを完了します。

Completing the gcloud CLI installation

A command prompt window opens automatically after the installation, as shown below. This prompt is where you will later configure the gcloud CLI.

Viewing the command prompt window for diagnostics

gcloud CLI の設定

gcloud CLI をインストールした後も、SDK の初期化と資格情報の設定を行う必要があります。

1. コマンドプロンプトウィンドウで Y を入力し、Enter キーを押します。

このプロンプトを受け入れると、デフォルトのウェブブラウザで新しいタブが開き、Google アカウントにログインするように求められます(ステップ 2)。

Confirming logging into Google Cloud

2. 続行するには、Google アカウントにログインします。

Logging in to Google

3. 必要な権限を与えるために [許可] をクリックします。

Granting the Google Cloud SDK the required permissions

ウェブブラウザで以下のようなページが表示されます。このページは、GCP アカウントに正常にログインし、gcloud CLI を使用するために認証されたことを確認します。

Verifying authentication is successful

4. 今度は、コマンドプロンプトウィンドウで 3 を入力し、Enter キーを押して新しいプロジェクトを作成します。このプロジェクトは、GCP リソースをホストするために使用されます。

Creating a new project

5. プロジェクトの Project ID(GCP アカウント全体で一意のもの)を入力し、Enter キーを押します。このチュートリアルでは、Project ID に gcp-gcloud-cli-demo という名前を使用します。

プロジェクトIDは、6〜30文字で、小文字のアルファベット、数字、およびハイフンを含めることができます。

Providing a Project ID

この時点で、gcloud CLIが正常にインストールされ、以下に示すように使用準備ができています。これで、このツールを使用して、コマンドラインからGCPリソースを管理できます。

Confirming gcloud CLI is ready

6. 次に、以下のコマンドを実行して、gcloud CLIを使用して–helpを取得します。

gcloud --help

すべてがうまくいけば、以下の出力と同じになります。

Getting help in using the gcloud CLI tool

バージョン別アーカイブを使用したgcloud CLIのインストール

特定のバージョンのgcloud CLIをインストールしたい場合は、バージョン別アーカイブを使用できます。この方法は、古いバージョンのCLIをインストールしたり、CI/CDパイプラインのスクリプトでgcloud CLIを使用したい場合に役立ちます。

バージョン別アーカイブは、gcloud CLIのポータブルバージョンのようなものです。これらのアーカイブをダウンロードして、マシンの任意の場所に展開できます。これらのアーカイブは自己完結型なので、追加の依存関係は必要ありません。

A list of versioned archives of the gcloud CLI is available for Linux, macOS, and Windows.

バージョン別アーカイブを使用してgcloud CLIをインストールするには、以下の手順に従ってください:

1. 公式ページのgcloud CLIバージョン別アーカイブのリストに移動します。

2. gcloud CLIの互換性のあるバージョンのアーカイブをダウンロードします。オペレーティングシステムとアーキテクチャに基づいて他のアーカイブを選択できます。ただし、このチュートリアルでは、Windows 64ビット(x86_64)にPythonがバンドルされたアーカイブを選択しました。

Downloading a compatible version archive of the gcloud CLI installer

3. ダウンロードが完了したら、zipアーカイブを任意の場所に展開します。

コマンドプロンプトウィンドウを開き、展開したアーカイブがある場所に移動し、以下のコマンドを実行してgcloud CLIをインストールします。

.\install.bat

Yを入力してEnterキーを押すと、このツールの改善にGoogleが役立ちます。Nを入力してEnterキーを押すと、このプロンプトをスキップします。

Opting in/out of Google data collecting.

5. 今、Yを入力してEnterキーを押すと、gcloud CLIをすべてのコマンドプロンプトウィンドウで使用できるようにします。または、Nを入力してEnterキーを押して、このツールを現在のコマンドプロンプトウィンドウでのみ使用します。

選択に関係なく、シェルを再起動する必要がある場合があります。

Updating the %PATH% environment variable.

最後に、以下のコマンドを実行して(gcloud init)、SDKを初期化し、資格情報を構成します。

資格情報の構成を完了するには、「gcloud CLIの構成」セクションの手順3から5を繰り返します。

.\bin\gcloud init

この時点で、gcloud CLIが正常にマシンにインストールされました。

Initializing the SDK and configuring your credentials

dockerを使用してgcloud CLIをインストール

Dockerはアプリケーションをパッケージ化してデプロイできるコンテナ化プラットフォームです。Dockerは新しいテクノロジを試したい開発者にとって、ローカルの開発環境に影響を与えることなく便利なツールです。

Googleはgcloud CLIを含むDockerイメージを提供しており、週ごとに最新のgcloud CLIバージョンで更新されています。

gcloud CLIをDockerを使ってインストールするには:

1. 以下のdocker pullコマンドをPowerShellで実行して、gcloud CLI Dockerイメージの最新バージョンを取得およびインストールします。

docker pull gcr.io/google.com/cloudsdktool/google-cloud-cli:latest
Pulling the latest version of the gcloud CLI Docker image

あるいは、利用可能なgcloud CLI Dockerイメージの一覧を確認し、以下のコマンドを実行して対応するイメージをGCRから取得します。この例では、以下のコマンドでgcloud CLIバージョン370.0.0をインストールします。

docker pull gcr.io/google.com/cloudsdktool/google-cloud-cli:370.0.0
Installing a specific gcloud CLI version

2. 次に、次のdocker runコマンドを実行して、gcloud CLIのインストールを確認します。このコマンドは、gcloud CLI Dockerイメージを使用してコンテナを実行し、コンテナ内でgcloud CLIのバージョンを表示します。

おそらく、特定のバージョンのgcloud CLIをインストールしています。その場合は、以下のコマンドを実行してくださいが、latest タグをインストールしたgcloud CLIの実際のバージョンに変更してください(つまり、370.0.0)。

docker run --rm gcr.io/google.com/cloudsdktool/google-cloud-cli:latest gcloud version

以下に、gcloud SDKおよびCLIの最新バージョンが表示されます。ただし、画像が更新されるため、バージョンが異なる可能性があります。

Verifying the installation

以下に、インストールされた特定のバージョンのgcloud CLIを確認できます。

Verifying the specific gcloud CLI version installation

3. SDKを初期化し、資格情報を構成するには、以下のコマンドを実行してください。

資格情報は、将来のセッションで使用できるgcloud-configコンテナに保存されます。

docker run -ti --name gcloud-config gcr.io/google.com/cloudsdktool/google-cloud-cli gcloud auth login

4. 最後に、「gcloud CLIの構成」セクションの手順に従って、資格情報を構成してください。

gcloudコンポーネントの管理

これで、マシンにgcloud CLIがインストールされましたので、このツールを使用してGoogle Cloudを管理するいくつかの例を探索してください。

gcloud CLIの重要な機能の1つは、Cloud SDKコンポーネントを管理できることです。これらのコンポーネントは、Cloud SDKを構成する個々のツールとライブラリです。

1. コマンドプロンプトウィンドウで以下のgcloudコマンドを実行して、利用可能なすべてのコンポーネントとそのバージョン番号をリストアップしてください。

gcloud components list

インストールするコンポーネントのIDを選択してください。

Listing all available components

2. 次に、以下のコマンドを実行して新しいコンポーネントをダウンロードしてインストールしてください。このチュートリアルの選択は、コンポーネントIDがbigtableのCloud Bigtable Emulatorです。

gcloud components install bigtable

Yを入力してEnterキーを押して続行してください。

Installing the Cloud Bigtable Emulator component

3. インストールしたら、すべてのインストールされたコンポーネントを最新バージョンに更新するには、以下のコマンドを実行してください。

gcloud components update
Updating all installed components to their latest version

4. 次に、不要なコンポーネントを削除するために以下のコマンドを実行してください。この例では、Google Cloud CRC32C ハッシュツールコンポーネント (gcloud-crc32c) を削除するコマンドが以下に示されています。

gcloud components remove gcloud-crc32c
Removing an unneeded component

gcloud CLI を使用して仮想マシンインスタンスを作成する

コンピュータに損傷を与えないように簡単なテスト環境を作成するか、独自のサーバーを設定するかどうかにかかわらず、仮想マシン(VM)を使用することができます。幸いなことに、gcloud CLI でできる最も重要なタスクの1つは、新しい VM インスタンスを作成することです。

gcloud CLI を使用して VM を作成するには、以下の手順を実行します。

1. 以下のコマンドを実行して、利用可能なすべての公開コンピューティングイメージをリストします。

gcloud compute images list

使用したいイメージのイメージファミリとプロジェクトに注意してください。

Listing all public images available

2. 次に、以下のコマンドを実行して、リージョン内で利用可能なすべてのマシンタイプと各タイプの CPU 数とメモリをリストします。

gcloud compute machine-types list

使用したいマシンタイプの名前に注意してください。

Listing all machine types

3. 以下のコマンドを実行して、ステップ1とステップ2で注意した詳細に基づいて、新しい VM インスタンス(コンピューティングインスタンス)を gcloud-cli-demo-vm として作成します。

Image Family –image-family=centos-7
Image Project –image-project=centos-cloud
Machine Type –machine-type=t2d-standard-4
gcloud compute instances create gcloud-cli-demo-vm --image-family=centos-7 --image-project=centos-cloud --machine-type=t2d-standard-4

VM インスタンスの作成には数分かかります。作成されると、インスタンスのステータス(実行中)が表示されます。

Creating a VM instance

4. 以下の gcloud compute コマンドを実行して、VM インスタンス(gcloud-cli-demo-vm)を詳細に説明します。

gcloud compute instances describe gcloud-cli-demo-vm

最後に、次のコマンドを実行して、VM インスタンス(gcloud-cli-demo-vm)を削除します。

gcloud compute instances delete gcloud-cli-demo-vm

Y を入力して Enter キーを押して、指定された VM インスタンスの削除を確認してください。

Deleting a VM instance

結論

Google Cloud リソースの管理は、特に多くの場合には挑戦的なものになることがあります。しかし、このチュートリアルでは、gcloud CLI がリソースの管理にどれほど強力かを学びました。gcloud CLI のインストールと設定方法、および Google Cloud でのコンポーネントの管理と VM インスタンスの作成方法を学びました。

このチュートリアルでは、氷山の一角しかカバーしていません。gcloud CLI にはさらに多くの機能があります。この新たな知識を活かして、いくつかの機能を自分で試してみるのはいかがでしょうか?たとえば、gcloud CLI を使用してストレージバケットを管理したり、ユーザーに IAM ロールを設定したり、さらにはアプリケーションをデプロイしたりすることができます。IAM ロール を設定したり、さらには アプリケーションをデプロイ したりすることができます。可能性は無限大です!

Source:
https://adamtheautomator.com/gcloud-cli-install/