ローカルテストにプロキシを使用する場合のクイックスタート

このページでは、Cloud SQL Proxy を使用して、ローカルテスト環境から Cloud SQL に接続する方法を示します。プロキシ経由で接続すると、ローカル環境で App Engine アプリケーションをテストしたり、データベース管理のための安全な接続を確立したりできます。

本番環境のプロキシの設定には、以下の手順を使用しないでください。その他の接続オプションについては、外部アプリケーション用の接続オプションご覧ください。

始める前に

このクイックスタートの手順を行う前に、次のタスクを完了します。

  • Google Cloud プロジェクトと Cloud SQL インスタンスを作成します。
  • 既存のプロジェクトを使用している場合は、Google Cloud ユーザーがプロジェクトの所有者であること、あるいは Cloud SQL で Cloud SQL Viewer 以外のロールを持っていることを確認してください。これらに該当しない場合は、Cloud SQL Proxy を使用して接続するの説明に沿ってプロキシを設定します。
  • 必要に応じて、mysql クライアントをインストールします。

    クライアントを使用すると、インスタンスへの接続をテストできます。 mysql クライアントはサーバー パッケージとともにインストールできます。一部のオペレーティング システムでは、クライアント専用パッケージをサポートしています。 MySQL のインストール手順をご覧ください

Cloud SQL Admin API の有効化

API を有効にする

gcloud コマンドライン ツールのインストールと認証

  1. まだ行っていない場合は、gcloud コマンドライン ツールをインストールします。

    gcloud のインストール手順をご覧ください

  2. gcloud ツールを初期化します。

    gcloud init
    
  3. gcloud ツールを認証します。

    gcloud auth login
    

ローカルマシンへの Cloud SQL Proxy クライアントのインストール

ダウンロードするプロキシ バイナリは、使用しているオペレーティング システム、および 32 ビットと 64 ビットのいずれのカーネルを使用しているかによって異なります。新しいハードウェアのほとんどは 64 ビットのカーネルを使用しています。お使いのマシンが 64 ビットカーネルを実行しているかどうかわからない場合は、Linux または macOS の uname -a コマンドを使用するか、Windows のスタート メニューで [コンピュータ] > [プロパティ] をクリックします。

Linux 64 ビット

  1. プロキシをダウンロードします。
    wget https://dl.google.com/cloudsql/cloud_sql_proxy.linux.amd64 -O cloud_sql_proxy
    
  2. プロキシを実行できるようにします。
    chmod +x cloud_sql_proxy
    

Linux 32 ビット

  1. プロキシをダウンロードします。
    wget https://dl.google.com/cloudsql/cloud_sql_proxy.linux.386 -O cloud_sql_proxy
    
  2. プロキシを実行できるようにします。
    chmod +x cloud_sql_proxy
    

macOS 64 ビット

  1. プロキシをダウンロードします。
    curl -o cloud_sql_proxy https://dl.google.com/cloudsql/cloud_sql_proxy.darwin.amd64
    
  2. プロキシを実行できるようにします。
    chmod +x cloud_sql_proxy
    

macOS 32 ビット

  1. プロキシをダウンロードします。
    curl -o cloud_sql_proxy https://dl.google.com/cloudsql/cloud_sql_proxy.darwin.386
    
  2. プロキシを実行できるようにします。
    chmod +x cloud_sql_proxy
    

Windows 64 ビット

https://dl.google.com/cloudsql/cloud_sql_proxy_x64.exe を右クリックして [名前を付けてリンク先を保存] を選択し、プロキシをダウンロードします。ファイル名を cloud_sql_proxy.exe に変更します。

Windows 32 ビット

https://dl.google.com/cloudsql/cloud_sql_proxy_x86.exe を右クリックして [名前を付けてリンク先を保存] を選択し、プロキシをダウンロードします。ファイル名を cloud_sql_proxy.exe に変更します。
お使いのオペレーティング システムがここに記載されていない場合は、ソースからプロキシをコンパイルすることも可能です。

インスタンス接続名の取得

  1. Google Cloud Console の Cloud SQL インスタンス ページに移動します。

    [Cloud SQL インスタンス] ページに移動

  2. インスタンス名をクリックして [インスタンスの詳細] ページを開きます。

  3. [このインスタンスに接続] のインスタンス接続名を書き留めます。

プロキシの開始

専用のターミナルでプロキシを開始して、その出力をモニタリングできるようにします。<INSTANCE_CONNECTION_NAME> を、前のステップでコピーしたインスタンス接続名に置き換えます。

./cloud_sql_proxy -instances=<INSTANCE_CONNECTION_NAME>=tcp:3306

次のようなメッセージが表示されます。

Listening on 127.0.0.1:3306 for myproject:us-central1:myinstance".
Ready for new connections

mysql クライアントを使用してデータベースに接続する

このセクションは省略可能ですが、接続のテストで使うことをおすすめします。 MySQL のインストール手順をご覧ください。

プロキシを起動した別のターミナル ウィンドウで次のコマンドを実行して、<USERNAME> を MySQL ユーザー名に置き換えます。

mysql -u <USERNAME> -p --host 127.0.0.1 --port 3306

mysql プロンプトが表示され、プロキシ ターミナルに次のようなメッセージが表示されます。

New connection for "myproject:us-central1:myinstance"

クリーンアップ

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

  1. Google Cloud Console の Cloud SQL インスタンス ページに移動します。
    [Cloud SQL インスタンス] ページに移動
  2. myinstance インスタンスを選択して [インスタンスの詳細] ページを開きます。
  3. ページ上部にあるアイコンバーで、[削除] をクリックします。
  4. [インスタンスの削除] ウィンドウで「myinstance」と入力してから、[削除] をクリックしてインスタンスを削除します。

    インスタンスの削除後、約 7 日はそのインスタンス名を再利用できません。

次のステップ