# gcloud CLIでCloud SQLへのローカル接続設定を行う手順

## 目次

1. はじめに

2. 前提条件

3. gcloud CLIのインストールと設定

4. Cloud SQLインスタンスへの接続準備

5. Cloud SQL Auth Proxyのインストール

6. Cloud SQL Auth Proxyを使用した接続手順

7. トラブルシューティング

8. まとめ

## 1. はじめに

Google Cloud SQLは、Google Cloud Platform (GCP)におけるマネージドデータベースサービスです。このガイドでは、`gcloud` CLIを使用してローカルマシンからCloud SQLインスタンスへ接続するための具体的な手順を紹介します。

## 2. 前提条件

- Google Cloud Platformアカウントが必要です。

- GCPプロジェクト内にCloud SQLインスタンスが作成されている必要があります。

- `gcloud` CLIがインストールされている必要があります。

- ローカルマシンに接続したいCloud SQLインスタンスへのアクセス権限が必要です。

## 3. gcloud CLIのインストールと設定

### 3-1. gcloud CLIのインストール

`gcloud` CLIがまだインストールされていない場合は、以下のコマンドを使用してインストールします。詳細については、[公式のインストールガイド](https://cloud.google.com/sdk/docs/install)を参照してください。

![img](/mosaic-code.jpg)

### 3-2. gcloud CLIの初期設定

インストールが完了したら、`gcloud init`コマンドを実行して初期設定を行います。

![img](/mosaic-code.jpg)

これにより、使用するプロジェクトや認証情報の設定が行われます。

## 4. Cloud SQLインスタンスへの接続準備

### 4-1. Cloud SQLインスタンスの情報を取得

Cloud SQLインスタンスの名前とリージョンを確認します。これらの情報は、GCPコンソールのSQLセクションから取得できます。

### 4-2. 必要なAPIの有効化

Cloud SQL Admin APIを有効にする必要があります。以下のコマンドを使用してAPIを有効化します。

![img](/mosaic-code.jpg)

## 5. Cloud SQL Auth Proxyのインストール

Cloud SQL Auth Proxyは、セキュアな接続をサポートするプロキシです。これを使用してCloud SQLインスタンスへの接続を行います。

### 5-1. Cloud SQL Auth Proxyのダウンロード

以下のコマンドを使用してCloud SQL Auth Proxyをダウンロードします。

![img](/mosaic-code.jpg)

### 5-2. 移動とパーミッション設定

ダウンロードしたファイルを移動し、実行権限を設定します。

![img](/mosaic-code.jpg)

## 6. Cloud SQL Auth Proxyを使用した接続手順

### 6-1. Cloud SQL Auth Proxyの起動

以下のコマンドを実行して、Cloud SQL Auth Proxyを起動します。`YOUR_PROJECT_ID`と`YOUR_INSTANCE_NAME`には、実際のプロジェクトIDとインスタンス名を挿入してください。

![img](/mosaic-code.jpg)

### 6-2. ローカルからの接続

Cloud SQL Auth Proxyを起動した状態で、ローカルマシンのMySQLクライアントを使用して接続できます。以下のコマンドを使用します。

![img](/mosaic-code.jpg)

`USERNAME`には、Cloud SQLのMySQLユーザー名を指定します。

## 7. トラブルシューティング

- __接続エラー__: Cloud SQL Auth Proxyが正しく起動しているか確認します。

- __認証エラー__: 正しいGCPアカウントに切り替わっていることを確認してください。

- __ファイアウォール設定__: ローカルIPがファイアウォールで許可されていることを確認します。

## 8. まとめ

gcloud CLIとCloud SQL Auth Proxyを用いることで、ローカル環境からセキュアにCloud SQLインスタンスへ接続することが可能です。これにより、開発環境で効率的にデータベース管理が行えます。設定に関する問題が発生した場合は、公式ドキュメントやコミュニティフォーラムを参照してください。

# gcloud CLIでCloud SQLへのローカル接続設定を行う手順

## 目次

1. はじめに

2. 前提条件

3. gcloud CLIのインストールと設定

4. Cloud SQLインスタンスへの接続準備

5. Cloud SQL Auth Proxyのインストール

6. Cloud SQL Auth Proxyを使用した接続手順

7. トラブルシューティング

8. まとめ

## 1. はじめに

Google Cloud SQLは、Google Cloud Platform (GCP)におけるマネージドデータベースサービスです。このガイドでは、`gcloud` CLIを使用してローカルマシンからCloud SQLインスタンスへ接続するための具体的な手順を紹介します。

## 2. 前提条件

- Google Cloud Platformアカウントが必要です。

- GCPプロジェクト内にCloud SQLインスタンスが作成されている必要があります。

- `gcloud` CLIがインストールされている必要があります。

- ローカルマシンに接続したいCloud SQLインスタンスへのアクセス権限が必要です。

## 3. gcloud CLIのインストールと設定

### 3-1. gcloud CLIのインストール

`gcloud` CLIがまだインストールされていない場合は、以下のコマンドを使用してインストールします。詳細については、[公式のインストールガイド](https://cloud.google.com/sdk/docs/install)を参照してください。

```bash

# macOSの場合

brew install --cask google-cloud-sdk

# Linuxの場合

curl https://sdk.cloud.google.com | bash

```

### 3-2. gcloud CLIの初期設定

インストールが完了したら、`gcloud init`コマンドを実行して初期設定を行います。

```bash

gcloud init

```

これにより、使用するプロジェクトや認証情報の設定が行われます。

## 4. Cloud SQLインスタンスへの接続準備

### 4-1. Cloud SQLインスタンスの情報を取得

Cloud SQLインスタンスの名前とリージョンを確認します。これらの情報は、GCPコンソールのSQLセクションから取得できます。

### 4-2. 必要なAPIの有効化

Cloud SQL Admin APIを有効にする必要があります。以下のコマンドを使用してAPIを有効化します。

```bash

gcloud services enable sqladmin.googleapis.com

```

## 5. Cloud SQL Auth Proxyのインストール

Cloud SQL Auth Proxyは、セキュアな接続をサポートするプロキシです。これを使用してCloud SQLインスタンスへの接続を行います。

### 5-1. Cloud SQL Auth Proxyのダウンロード

以下のコマンドを使用してCloud SQL Auth Proxyをダウンロードします。

```bash

# 最新のバージョンURLを確認したうえで実行してください

wget https://dl.google.com/cloudsql/cloud_sql_proxy.linux.amd64 -O cloud_sql_proxy

chmod +x cloud_sql_proxy

```

### 5-2. 移動とパーミッション設定

ダウンロードしたファイルを移動し、実行権限を設定します。

```bash

mv cloud_sql_proxy /usr/local/bin/

chmod +x /usr/local/bin/cloud_sql_proxy

```

## 6. Cloud SQL Auth Proxyを使用した接続手順

### 6-1. Cloud SQL Auth Proxyの起動

以下のコマンドを実行して、Cloud SQL Auth Proxyを起動します。`YOUR_PROJECT_ID`と`YOUR_INSTANCE_NAME`には、実際のプロジェクトIDとインスタンス名を挿入してください。

```bash

cloud_sql_proxy -instances=YOUR_PROJECT_ID:REGION:YOUR_INSTANCE_NAME=tcp:3306

```

### 6-2. ローカルからの接続

Cloud SQL Auth Proxyを起動した状態で、ローカルマシンのMySQLクライアントを使用して接続できます。以下のコマンドを使用します。

```bash

mysql -u USERNAME -p -h 127.0.0.1

```

`USERNAME`には、Cloud SQLのMySQLユーザー名を指定します。

## 7. トラブルシューティング

- __接続エラー__: Cloud SQL Auth Proxyが正しく起動しているか確認します。

- __認証エラー__: 正しいGCPアカウントに切り替わっていることを確認してください。

- __ファイアウォール設定__: ローカルIPがファイアウォールで許可されていることを確認します。

## 8. まとめ

gcloud CLIとCloud SQL Auth Proxyを用いることで、ローカル環境からセキュアにCloud SQLインスタンスへ接続することが可能です。これにより、開発環境で効率的にデータベース管理が行えます。設定に関する問題が発生した場合は、公式ドキュメントやコミュニティフォーラムを参照してください。

gcloud CLIでCloud SQLへのローカル接続設定を行う手順

目次

続きを読むには単価診断を受けてください（30秒）