プライベート IP を使用して Cloud SQL for MySQL インスタンスに接続する

プライベート IP を使用して Cloud SQL for MySQL インスタンスに接続する

MySQL   |  PostgreSQL   |  SQL Server

ここでは、MySQL インスタンスを作成し、プライベート IP を使用してそのインスタンスに接続する方法を説明します。このクイックスタートで作成されるリソースにかかる費用は、クリーンアップを含む手順を適切なタイミングで完了した場合、通常 1 ドル未満です。

---

このタスクを Google Cloud コンソールで直接行う際の順を追ったガイダンスについては、「ガイドを表示」をクリックしてください。

ガイドを表示

---

始める前に

注: プロジェクトに使用する名前は 4～30 文字にする必要があります。名前を入力すると、フォームにプロジェクト ID の候補が示されます。これは編集できます。プロジェクト ID は 6～30 文字で、先頭を小文字にします。残りの文字には、ダッシュ、小文字、数字を使用できますが、最後の文字にダッシュは使えません。

アカウントにログインします Google Cloud を初めて使用する場合は、 アカウントを作成して、実際のシナリオで Google プロダクトのパフォーマンスを評価してください。 Google Cloud新規のお客様には、ワークロードの実行、テスト、デプロイができる無料クレジット $300 分を差し上げます。

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

1. このクイックスタートを完了するために必要な権限があることを 確認します。
2. 必要な Google Cloud API を有効にします。

   コンソール

   Google Cloud コンソールで、[API] ページに移動します。

   [API] に移動

   Cloud SQL Admin API を有効にします。この API を有効にすると、Cloud SQL Auth Proxy を実行できます。

   gcloud

   次のボタンをクリックして Cloud Shell を開きます。これにより、ブラウザから Google Cloud リソースにコマンドラインで直接アクセスできます。Cloud Shell を使用することで、このクイックスタートで紹介する gcloud コマンドを実行できます。

   Cloud Shell を開く

   Cloud Shell を使用して、次のように gcloud services enable コマンドを実行し、このクイックスタートに必要な API を有効にします。

   gcloud services enable sqladmin.googleapis.com

   このコマンドにより、次の API が有効になります。

   • Cloud SQL Admin API。この API を有効にすると、 Cloud SQL Auth Proxy を実行できます。

必要なロール

プライベート IP アドレスを使用して Cloud SQL を設定するために必要な権限を取得するには、設定して接続するプロジェクトに対する次の IAM ロールを付与するよう管理者に依頼してください。

• インスタンス、データベース、ユーザーの作成または削除: Cloud SQL 管理者ロール（roles/cloudsql.admin）。
• IAM サービス アカウントの作成または削除: IAM サービス アカウント管理者ロール（roles/iam.serviceAccountAdmin）。
• コンピューティング インスタンスの作成または削除:
  • Compute 管理者ロール （roles/compute.admin）
  • Compute インスタンス管理者のロール（roles/compute.instanceAdmin.v1）。
• 接続を作成する:
  • Service Networking 管理者 （roles/servicenetworking.networksAdmin)）
  • Service Usage 管理者（roles/serviceusage.serviceUsageAdmin）。

ロールの付与については、プロジェクト、フォルダ、組織へのアクセス権の管理をご覧ください。

必要な権限は、カスタムロールや他の事前定義ロールから取得することもできます。

概要

プライベート IP アドレスを使用して Cloud SQL インスタンスに接続する際には、ソースが配置されている場所に応じて多くの方法が存在します。重要な要素は、ソースマシンが Cloud SQL インスタンスと同じ VPC ネットワーク内に存在する必要があることです。ソースが Google Cloud プロジェクトに存在しない場合、または同じ Google Cloud プロジェクトに存在しない場合は、ここで示すのとは異なる接続を構成する必要があります。

このクイックスタートでは、最も直接的な方法で接続を構成します。ソースとターゲットは同じ Google Cloud プロジェクトに属し、同じ VPC ネットワーク上に存在します。プライベート IP アドレス（ターゲット）と Compute Engine VM（ソース）を使用して、Cloud SQL インスタンスを作成します。VM から Cloud SQL インスタンスに接続するために必要なツールをインストールして使用します。

次の操作を行います。

1. プライベート IP アドレスを使用して Cloud SQL インスタンスを作成します。

   後で使用するため、インスタンスの connection name を見つけて保存します。

2. Compute Engine VM を作成します。
3. Compute Engine VM に対して 2 つの SSH 接続を開きます。

   最初のウィンドウで mysql をインストールし、Cloud SQL Auth Proxy をインストールして起動します。2 つ目のウィンドウで Cloud SQL Auth Proxy に接続し、Cloud SQL インスタンスに接続します。

4. SSH ウィンドウ #1 で、次の操作を行います。
   1. mysql クライアントをインストールします。
   2. Cloud SQL Auth Proxy をインストールします。

      Cloud SQL Auth Proxy は、mysql クライアントと Cloud SQL インスタンスの間のコネクタとして機能します。

   3. Cloud SQL Auth Proxy を起動します。

      成功すると、Cloud SQL Auth Proxy が接続リクエストをリッスンします。

5. SSH ウィンドウ #2 で、mysql クライアントから Cloud SQL Auth Proxy に接続して、Cloud SQL インスタンスに接続します。

   成功すると、このウィンドウには mysql プロンプトが表示されます。SSH ウィンドウ #1 には、Cloud SQL Auth Proxy が実行されていることを示す接続成功メッセージが表示されます。

6. クリーンアップします。

プライベート IP アドレスを使用して Cloud SQL インスタンスを作成する

プライベート IP 接続を使用するインスタンスを作成するには、次の操作を行います。

1. コンソールで、[Cloud SQL のインスタンス] ページに移動します。 Google Cloud

   Cloud SQL の [インスタンス] に移動

2. [MySQL] タブを選択し、[サンドボックス インスタンスを作成] を [サンドボックス] ボックスでクリックします。または、[**インスタンスを作成**] をクリックして、次の操作を行います。
1. [MySQL を選択] をクリックします。
2. [Enterprise] エディションを選択します。
3. [サンドボックス] プリセットを選択します。
3. [Compute API] を有効にするように求められたら、 [API を有効にする] ボタンをクリックします。
4. [インスタンスの情報] セクションにインスタンス ID の名前を入力します。
5. root ユーザーのパスワードを入力して後で必要になるため、作成したパスワード をメモしておきます。
6. In the [Choose region and zonal availability] section, select the [Single zone] option.
7. [構成オプションを表示] を開きます。
8. [接続] を開きます。
9. [パブリック IP] をクリアします。
10. [プライベート IP] を選択します。
11. [プライベート サービス アクセス（PSA）] を選択します。
12. [VPC ネットワーク] プルダウンで [デフォルト] を選択します。
13. 新しいプロジェクトを使用している場合は、 [ネットワーク接続が設定されていません] というメッセージが表示され、[ネットワーク 設定の確認が必要です] というボックスが表示されます。このボックスから、 [PSA の設定に関する VPC ドキュメント] に移動できます。
1. コンソールで [**VPC ネットワーク**] ページに移動します。 Google Cloud

   [VPC ネットワーク] に移動

2. デフォルト の VPC ネットワークを選択します。
3. TCP ポート 22 へのアクセスを許可するファイアウォール ルールを設定します。
1. [ファイアウォール] タブを選択します。
2. [VPC ファイアウォール ルール] で、[VPC ファイアウォール ルールを作成] を選択します。
3. ファイアウォール ルールに名前を付けます。
4. [ターゲット] で、[ネットワーク上のすべてのインスタンス] を選択します。
5. [送信元 IPv4 範囲] に 0.0.0.0/0 と入力します。
6. [プロトコルとポート] で、[TCP] をオンにして、 すぐ下の [ポート] ボックスに「22」と入力します。
7. [作成] を選択します。
4. IP アドレス範囲を割り振ります。
1. [プライベート サービス アクセス] タブを選択します。
2. [**プライベート サービス アクセス**] タブで、[**サービスに割り当てられた IP 範囲**] タブを選択します。
3. [IP 範囲の割り当て] をクリックします。
4. 割り当て範囲の名前 と説明 （省略可）を入力します。
5. 利用可能な範囲を Google に選択させるには、[自動] を選択します。
6. 16～ 124 のプレフィックス長を入力します（割り振られるアドレスの数は 2 の（32 - プレフィックス長）乗になります）。
7. [割り当て] をクリックして、割り振る範囲を作成します。
5. プライベート接続を作成します：
1. [**プライベート サービス アクセス**] タブで、[**サービスへのプライベート接続**] タブに切り替えます。
2. [接続を作成] ボタンをクリックします。
3. [割り当て] プルダウンで、[プライベート接続を作成] ボックスの先ほど作成した IP アドレス範囲の名前を選択します。
4. [接続] をクリックします。
6. 接続が作成されたら、Cloud SQL インスタンスを作成していた場所に戻り、[接続を確認] をクリックします。
14. PSA 接続が正常に作成されたら、 [インスタンスを作成] をクリックします。

新しいインスタンスが作成されると、インスタンスの概要ページが表示されます。

インスタンスの作成が完了したら、[このインスタンスに接続] セクションまでスクロールし、インスタンスの接続名 を保存します。connection name の形式は projectID:region:instanceID です。この connection name は、後で Cloud SQL Auth Proxy を起動するときに使用します。

Compute Engine VM を作成する

VM を作成する手順は次のとおりです。

1. コンソールで、[VM インスタンス] ページに移動します。 Google Cloud

   [VM インスタンス] に移動

2. [インスタンスを作成] をクリックします。
3. インスタンスの名前 を入力します。
4. ナビゲーション パネルで [データ保護] を選択し、[バックアップなし] を選択します。
5. ナビゲーション パネルで [セキュリティ] を選択し、[アクセス スコープ] で [すべての Cloud API に完全アクセス権を許可] を選択します。
6. [作成] をクリックして、VM の作成が完了するまで待ちます。

Compute Engine VM への 2 つの SSH 接続を開く

VM で 2 つのウィンドウを使用します。最初のウィンドウは、mysql クライアントと Cloud SQL Auth Proxy のインストール、インスタンス接続名の取得とプロキシの起動に使用されます。2 つ目のウィンドウは、プロキシ経由で Cloud SQL インスタンスに接続するために使用されます。

1. Compute Engine VM インスタンスの [接続] 列で [SSH] メニューを開きます。
2. [ブラウザ ウィンドウで開く] を選択して、SSH ウィンドウ #1 を開きます。

   ウィンドウ内に利用可能というプロンプトが表示されるまでに数秒かかる場合があります。

3. プロンプトが表示されたら、「pwd」と入力して /home/$USER ディレクトリにいることを確認します。

   このウィンドウで、mysql クライアントと Cloud SQL Auth Proxy をインストールし、さらに Cloud SQL Auth Proxy を起動します。

4. もう一度 [ブラウザ ウィンドウで開く] を選択して、SSH ウィンドウ #2 を開きます。

   このウィンドウを使用して Cloud SQL インスタンスに接続します。

mysql クライアントをインストールする

この手順では SSH ウィンドウ #1 を使用します。

MySQL クライアントをパッケージ マネージャーからインストールし、mysqld サーバーを停止します。

sudo apt-get update
sudo apt-get install default-mysql-client
  

Cloud SQL Auth Proxy をインストールする

この手順では SSH ウィンドウ #1 を使用します。

1. wget をインストールします。

   sudo apt-get install wget
       

2. Cloud SQL Auth Proxy をダウンロードします。

   wget https://storage.googleapis.com/cloud-sql-connectors/cloud-sql-proxy/v2.8.2/cloud-sql-proxy.linux.amd64 \
   -O cloud-sql-proxy
     

3. Cloud SQL Auth Proxy を動作可能にします。

   chmod +x cloud-sql-proxy
     

Cloud SQL Auth Proxy を起動する

この手順では SSH ウィンドウ #1 を使用します。

Cloud SQL Auth Proxy を起動して、その出力をモニタリングします。INSTANCE_CONNECTION_NAME は、Cloud SQL インスタンスの作成時にコピーした connection name に置き換えます。

./cloud-sql-proxy --private-ip INSTANCE_CONNECTION_NAME

注:デフォルトでは、Cloud SQL Auth Proxy は、パブリック IPv4 アドレスを使用して Cloud SQL インスタンスへの接続を試行します。インスタンスにプライベート IP しかない場合、またはインスタンスにパブリック IP とプライベート IP の両方が構成されている場合に、Cloud SQL Auth Proxy によってプライベート IP アドレスが使用されるようにするには、Cloud SQL Auth Proxy の起動時に --private-ip オプションを指定する必要があります。

注: アドレスがすでに使用されているというエラーが表示された場合は、データベースのローカル インスタンスが実行されています。このインスタンスを停止する必要があります。 コマンドを実行して SERVICE_NAME を確認し、次のコマンドを実行します。ps -ef | grep mysql

sudo service SERVICE_NAME stop
   

Cloud SQL Auth Proxy が正常に起動すると、SSH ウィンドウに次のようなメッセージが表示されます。

Listening on 127.0.0.1:3306 for myInstance
Ready for new connections

Cloud SQL インスタンスに接続する

この手順では SSH ウィンドウ #2 を使用します。

次のコマンドを実行します。

mysql -u root -p --host 127.0.0.1 --port 3306

Enter password: プロンプトで、MySQL root ユーザー アカウントのパスワードを入力します。

MySQL プロンプトが表示されていることを確認します。mysql クライアントを使用してデータベースに接続しています。

Cloud SQL Auth Proxy を起動したターミナル ウィンドウに戻ります。次のようなメッセージが表示されます。

New connection for myInstance

クリーンアップ

このページで使用したリソースについて、 Google Cloud アカウントに課金されないようにするには、 次の手順を実施します。

1. Google Cloud コンソールで、Cloud SQL の [インスタンス] ページに移動します。

   Cloud SQL の [インスタンス] に移動

2. myinstance インスタンスを選択して [インスタンスの詳細] ページを開きます。
3. ページ上部にあるアイコンバーで、[削除] をクリックします。
4. インスタンスの削除ウィンドウでインスタンスの名前を入力し、[削除] をクリックします。

省略可能なクリーンアップ手順

このクイックスタートで有効にした API を使用しない場合は、無効にすることができます。

• このクイックスタートで有効にした API:
  • Cloud SQL Admin API

1. Google Cloud コンソールで、[API] ページに移動します。

   [API] に移動

2. Cloud SQL Admin API を選択し、[API を無効にする] ボタンをクリックします。

3. Google Cloud コンソールで、[VM インスタンス] ページに移動します。

   [VM インスタンス] に移動

4. インスタンスの名前を選択します。

5. [その他の操作] メニューから [削除] を選択します。

次のステップ

必要に応じて、Cloud SQL インスタンスの作成で詳細をご確認ください。

Cloud SQL インスタンスの MySQL ユーザーとデータベースの作成についても学習できます。

また、他の Google Cloud アプリケーションから Cloud SQL インスタンスへの接続についても確認できます。

• App Engine スタンダード環境で実行されているアプリケーションからの接続
• GKE で実行中のアプリケーションからの接続
• Cloud Run からの接続