AlloyDB クイック設定ラボ

1. 概要

この Codelab では、AlloyDB を設定する簡単でシンプルな方法を説明します。

作成するアプリの概要

この一環として、AlloyDB インスタンスとクラスタ、および必要なすべてのネットワーク構成をワンクリックでインストールします。また、今後のプロジェクトで迅速に設定する方法も学びます。

要件

• ブラウザ（Chrome、Firefox など）
• 課金を有効にした Google Cloud プロジェクト

2. 始める前に

プロジェクトを作成

1. Google Cloud コンソールのプロジェクト選択ページで、Google Cloud プロジェクトを選択または作成します。
2. Cloud プロジェクトに対して課金が有効になっていることを確認します。詳しくは、プロジェクトで課金が有効になっているかどうかを確認する方法をご覧ください。

Google Cloud サービスを試用していて、まずトライアル クレジットが必要な場合は、GCP トライアル請求先クレジット リンク（https://bit.ly/ez-alloydb1）を使用してトライアル請求先アカウントを設定できます。

このリンクを使用してクレジットを利用するにはどうすればよいですか？こちらからご登録ください。

Cloud Shell をアクティブにする

3. Google Cloud 上で動作するコマンドライン環境の Cloud Shell を使用します。Google Cloud コンソールの上部にある [Cloud Shell をアクティブにする] をクリックします。

• Cloud Shell に接続したら、次のコマンドを使用して、すでに認証済みであることと、プロジェクトがプロジェクト ID に設定されていることを確認します。

gcloud auth list

• 認証されていない場合は、次のコマンドを実行します。

gcloud auth login

• Cloud Shell で次のコマンドを実行して、gcloud コマンドがプロジェクトを認識していることを確認します。

gcloud config list project

• プロジェクトが設定されていない場合は、次のコマンドを使用して設定します。

gcloud config set project <YOUR_PROJECT_ID>

API を有効にして権限を付与する

4. 必要な API を有効にします。

リンクにアクセスして、API を有効にします。

別の方法として、この操作に gcloud コマンドを使用することもできます。gcloud コマンドとその使用方法については、ドキュメントをご覧ください。

5. AlloyDB インスタンスの作成と構成に必要なロールを付与する

独自の開発環境を使用している場合や、プロジェクトに対するオーナー / 管理者権限がある場合は、プリンシパル（オーナー）にすでにこれらの権限が付与されているため、この手順は必要ありません。表示されていない場合は、次の手順を行います。

AlloyDB データベースの作成と接続に必要な権限を取得するには、プロジェクトに対する次の IAM ロールを付与します。

• Compute ネットワーク管理者（roles/compute.networkAdmin）
• AlloyDB 管理者（roles/alloydb.admin）

操作:

IAM のページに移動し、プロジェクトを選択して、プリンシパル アカウントに移動し、右上の鉛筆アイコンを使用して編集します（鉛筆アイコンがない場合は、[アクセス権を付与] ボタンをクリックして新しいプリンシパルを追加します）。上記のロールを 1 つずつ選択して割り当て、変更を保存します。権限が同期されたら、準備完了です。

AlloyDB データベースの作成と接続にバックグラウンドで必要な権限は次のとおりです。

• compute.networks.list
• compute.networks.addPeering
• compute.addresses.create
• servicenetworking.services.addPeering
• Alloydb.clusters.create
• Alloydb.instances.create
• Alloydb.instances.login

それでは、セットアップに進みましょう。

3. AlloyDB の設定

ネットワーク構成とともに AlloyDB クラスタとインスタンスを作成しましょう。

1. Google Cloud Shell ターミナルから次のコマンドを実行して、ルート ディレクトリにリポジトリのクローンを作成し、クローンされたプロジェクト フォルダに移動します。

# 1. Clone the repository
git clone https://github.com/GoogleCloudPlatform/devrel-demos.git

# 2. Navigate to the project directory
cd devrel-demos/infrastructure/easy-alloydb-setup

2. この手順が完了すると、リポジトリがローカルの Cloud Shell エディタにクローンされます。プロジェクト フォルダ内から次のコマンドを実行できます（プロジェクト ディレクトリにいることを確認することが重要です）。

sh run.sh

3. UI を使用します（リンクはターミナルのログにあります。クリックするか、ターミナルの [ウェブでプレビュー] リンクをクリックして移動することもできます）。
4. プロジェクト ID、クラスタ名、インスタンス名の詳細を入力して、開始します。

UI に [Link Trial Billing Account] タブが表示されます。これは、Codelab のステップ 2（「始める前に」）の「プロジェクトを作成する」セクションで提供されているトライアル クレジット リンクを使用して、有効なトライアルの請求先アカウントを Google Cloud プロジェクトにリンクする場合に便利です。

5. ログがスクロールしている間にコーヒーを飲んで、裏で何が行われているかについてはこちらをご覧ください。

ローカルまたは任意の場所からテストする場合は、AlloyDB インスタンスに移動して [編集] をクリックし、[パブリック IP を有効にする] または [パブリック IP 接続]（アウトバウンドではない方）をクリックして、開発目的で [承認済み外部ネットワーク] に「0.0.0.0/0」と入力します。完了したら、パブリック IP 接続を削除して無効にします。

4. 完了

これで準備完了です。

AlloyDB を使用して、データをすばやく簡単に設定しましょう。始める