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

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

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

始める前に

このクイックスタートの手順を実行する前に、次のタスクを完了する必要があります。

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

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

Cloud SQL API を有効にする

必要な 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 Platform 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"

次のステップ

このページは役立ちましたか?評価をお願いいたします。

フィードバックを送信...