Compute Engine から接続

1. プライベート IP を使用するようにインスタンスを構成します。

プライベート IP 接続を構成するの手順に沿って進めます。

2. Compute Engine インスタンスに対する Cloud Shell ターミナル接続を開きます。

インスタンスのオペレーティング システムに応じて適切な手順に従います。

• Linux の場合、Linux VM への接続をご覧ください。
• Windows の場合、Windows VM への接続をご覧ください。

Compute Engine インスタンスが RHEL または CentOS 公開イメージを実行する場合、SELinux によりプロキシ接続がブロックされることがあります。これが発生した場合、SELinux 機能を構成して接続が許可されるようにする必要があります。

RHEL の SELinux に関する詳細については、RHEL ドキュメントをご覧ください。CentOS の SELinux に関する詳細については、CentOS ドキュメントをご覧ください。

3. Compute Engine インスタンスに sqlcmd クライアントがまだインストールされていない場合は、インストールします。

4. sqlcmd クライアントに接続します。

sqlcmd -S CLOUD_SQL_PRIVATE_IP_ADDRESS -U USERNAME

プライベート IP アドレスは、Cloud SQL インスタンス ページ、または次の gcloud コマンドを実行することで確認できます。

gcloud sql instances list

1. Compute Engine インスタンスに静的 IPv4 IP アドレスがない場合は、追加します。

IPv6 を使用して Compute Engine に接続することはできません。静的 IP アドレスの追加については、Compute Engine ドキュメントの新しい静的外部 IP アドレスの予約をご覧ください。

2. Compute Engine インスタンスの静的 IP アドレスを、Cloud SQL インスタンスに接続できるネットワークとして承認します。

詳細については、パブリック IP 接続のアクセスを構成するをご覧ください。

3. Cloud Shell ターミナルで Compute Engine インスタンスに接続します。

インスタンスのオペレーティング システムに応じて適切な手順に従います。

• Linux の場合、Linux VM への接続をご覧ください。
• Windows の場合、Windows VM への接続をご覧ください。

Compute Engine インスタンスが RHEL または CentOS 公開イメージを実行する場合、SELinux によりプロキシ接続がブロックされることがあります。これが発生した場合、SELinux 機能を構成して接続が許可されるようにする必要があります。

RHEL の SELinux に関する詳細については、RHEL ドキュメントをご覧ください。CentOS の SELinux に関する詳細については、CentOS ドキュメントをご覧ください。

4. Compute Engine インスタンスに sqlcmd クライアントがまだインストールされていない場合は、インストールします。

5. sqlcmd クライアントに接続します。

sqlcmd -S CLOUD_SQL_PUBLIC_IP_ADDR -U USERNAME

パブリック IP アドレスは、Cloud SQL インスタンス ページ、または次の gcloud コマンドを実行することで確認できます。

gcloud sql instances list

SSL を使用した接続方法については、SSL を使用して接続するをご覧ください。

6. sqlcmd プロンプトが表示されます。

1. Cloud SQL Admin API を有効にします。

Enable the API

2. サービス アカウントを作成します。

1. Google Cloud コンソールで、[サービス アカウント] ページに移動します。

   [サービス アカウント] に移動

2. Cloud SQL インスタンスを含むプロジェクトを選択します。
3. [サービス アカウントを作成] をクリックします。
4. [サービス アカウント名] 欄に、サービス アカウントのわかりやすい名前を入力します。
5. [サービス アカウント ID] を一意のわかりやすい値に変更し、[作成して続行] をクリックします。
6. [ロールを選択] 項目をクリックして、以下のいずれかのロールを選択します。
   • [Cloud SQL] > [Cloud SQL クライアント]
   • [Cloud SQL] > [Cloud SQL 編集者]
   • [Cloud SQL] > [Cloud SQL 管理者]

7. [完了] をクリックして、サービス アカウントの作成を完了します。
8. 新しいサービス アカウントの操作メニューをクリックし、[鍵を管理] を選択します。
9. [鍵を追加] プルダウン メニューをクリックして、[新しい鍵を作成] をクリックします。
10. 鍵のタイプが JSON であることを確認し、[作成] をクリックします。

    秘密鍵ファイルがマシンにダウンロードされます。秘密鍵ファイルは、別の場所に移動できます。安全な場所に鍵ファイルを保管してください。

Compute Engine インスタンスが Cloud SQL インスタンスとは異なるプロジェクトにある場合、そのサービス アカウントに Cloud SQL インスタンスを含むプロジェクトに対する適切な権限があることを確認します。

1. Google Cloud Console の Compute Engine インスタンスの一覧に移動します。

   Compute Engine インスタンスの一覧に移動

2. 必要に応じて、Compute Engine インスタンスに関連付けられたプロジェクトを選択します。
3. Compute Engine インスタンスを選択してプロパティを表示します。
4. Compute Engine インスタンスのプロパティで、サービス アカウントの名前をコピーします。
5. Google Cloud Console の [IAM と管理] ページに移動します。

   [IAM と管理] ページに移動

6. Cloud SQL インスタンスを含むプロジェクトを選択します。
7. サービス アカウント名を検索します。

8. サービス アカウントがすでに存在し、そのアカウントに cloudsql.instances.connect 権限を含むロールが割り当てられている場合は、ステップ 4 に進みます。

   役割 Cloud SQL Client、Cloud SQL Editor、Cloud SQL Adminは、従来のプロジェクト役割 Editor や Owner と同様に、必要な権限を提供します。

9. それ以外の場合、[追加] をクリックしてサービス アカウントを追加します。

10. [プリンシパルの追加] ダイアログで、サービス アカウントの名前を指定し、cloudsql.instances.connect 権限を含むロールを選択します（Cloud SQL の事前定義されたロールのうち、閲覧者以外のロールはこの条件に当てはまります）。

    または、[プロジェクト] > [編集者] の順に選択して、基本的な編集者のロールを使用することもできますが、編集者のロールには Google Cloud 全体に対する権限が含まれています。

    これらの役割が表示されない場合、Google Cloud ユーザーに resourcemanager.projects.setIamPolicy 権限がない可能性があります。権限を確認するには、Google Cloud Console の IAM ページにアクセスし、ご自分のユーザー ID を検索します。

11. [追加] をクリックします。

    指定したロールを持つサービス アカウントが表示されます。

3. Compute Engine インスタンスに対するターミナル接続を開きます。

インスタンスのオペレーティング システムに応じて適切な手順に沿って操作します。

• Linux の場合、Linux インスタンスへの接続をご覧ください。
• Windows の場合、Windows インスタンスへの接続をご覧ください。

Compute Engine インスタンスが RHEL または CentOS 公開イメージを実行する場合、SELinux によりプロキシ接続がブロックされることがあります。これが発生した場合、SELinux 機能を構成して接続が許可されるようにする必要があります。

RHEL の SELinux に関する詳細については、RHEL ドキュメントをご覧ください。CentOS の SELinux に関する詳細については、CentOS ドキュメントをご覧ください。

4. Compute Engine インスタンスに sqlcmd クライアントがまだインストールされていない場合は、インストールします。

5. Cloud SQL Auth Proxy を Compute Engine インスタンスにインストールします。

docker pull gcr.io/cloud-sql-connectors/cloud-sql-proxy:2.14.1

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

TCP ソケットまたは Cloud SQL Auth Proxy の Docker イメージを使用して、Cloud SQL Auth Proxy を起動できます。Cloud SQL Auth Proxy バイナリは、コマンドラインで指定された 1 つ以上の Cloud SQL インスタンスに接続し、TCP ソケットとしてローカル接続を開きます。アプリケーション コードやデータベース管理クライアント ツールなど、他のアプリケーションやサービスは、これらの TCP ソケットの接続を介して Cloud SQL インスタンスに接続できます。

./cloud-sql-proxy --address 0.0.0.0 --port 1234 INSTANCE_CONNECTION_NAME

gcloud sql instances describe INSTANCE_NAME

docker run -d \\
  -v PATH_TO_KEY_FILE:/path/to/service-account-key.json \\
  -p 127.0.0.1:1433:1433 \\
  gcr.io/cloud-sql-connectors/cloud-sql-proxy:2.14.1 \\
  --address 0.0.0.0 --port 1433 \\
  --credentials-file /path/to/service-account-key.json INSTANCE_CONNECTION_NAME

docker run -d -v /cloudsql:/cloudsql \\
  -v PATH_TO_KEY_FILE:/path/to/service-account-key.json \\
  gcr.io/cloud-sql-connectors/cloud-sql-proxy:2.14.1 --unix-socket=/cloudsql \\
  --credentials-file /path/to/service-account-key.json INSTANCE_CONNECTION_NAME

-v /mnt/stateful_partition/cloudsql:/cloudsql

7. sqlcmd セッションを開始します。

使用する接続文字列は、Cloud SQL Auth Proxy の起動時に TCP ソケットを使用したか、Docker を使用したかによって異なります。