Menghubungkan ke Cloud SQL untuk MySQL menggunakan Proxy Auth Cloud SQL

Halaman ini menunjukkan cara terhubung ke Cloud SQL dari lingkungan pengujian lokal menggunakan Proxy Auth Cloud SQL. Proxy Auth Cloud SQL memberikan akses yang aman ke instance Cloud SQL Anda tanpa memerlukan jaringan yang diizinkan atau konfigurasi SSL. Dengan menggunakan Proxy Auth Cloud SQL, Anda dapat terhubung ke instance Cloud SQL dengan aman.

Petunjuk di halaman ini hanya ditujukan untuk lingkungan pengujian dan tidak boleh digunakan untuk lingkungan produksi. Untuk mengetahui informasi selengkapnya tentang konfigurasi yang diperlukan untuk lingkungan produksi, lihat Menggunakan Proxy Auth Cloud SQL dalam lingkungan produksi dan Terhubung menggunakan Proxy Auth Cloud SQL.

Sebelum memulai

  1. Login ke akun Google Cloud Anda. Jika Anda baru menggunakan Google Cloud, buat akun untuk mengevaluasi performa produk kami dalam skenario dunia nyata. Pelanggan baru juga mendapatkan kredit gratis senilai $300 untuk menjalankan, menguji, dan men-deploy workload.
  2. Di konsol Google Cloud, pada halaman pemilih project, pilih atau buat project Google Cloud.

    Buka pemilih project

  3. Pastikan penagihan telah diaktifkan untuk project Google Cloud Anda.

  4. Di konsol Google Cloud, pada halaman pemilih project, pilih atau buat project Google Cloud.

    Buka pemilih project

  5. Pastikan penagihan telah diaktifkan untuk project Google Cloud Anda.

  6. Mengaktifkan Google Cloud API yang diperlukan.

    Konsol

    Di konsol Google Cloud, buka halaman APIs.

    Buka API

    Mengaktifkan Cloud SQL Admin API.

    gcloud

    Klik tombol berikut untuk membuka Cloud Shell, yang menyediakan akses command line ke resource Google Cloud langsung dari browser. Cloud Shell dapat digunakan untuk menjalankan perintah gcloud yang disajikan di seluruh panduan memulai ini.

    Buka Cloud Shell

    Jalankan perintah gcloud services enable sebagai berikut menggunakan Cloud Shell untuk mengaktifkan API yang diperlukan untuk panduan memulai ini.:

    gcloud services enable sqladmin.googleapis.com

    Perintah ini mengaktifkan API berikut:

    • Cloud SQL Admin API

Membuat instance Cloud SQL

Dalam panduan memulai ini, Anda akan menggunakan Konsol Google Cloud. Untuk menggunakan gcloud CLI, cURL, atau PowerShell, lihat Membuat instance.

  1. Di konsol Google Cloud, buka halamanInstance Cloud SQL.

    Buka Instance Cloud SQL

  2. Klik Create Instance.
  3. Klik Choose MySQL.
  4. Masukkan myinstance untuk ID Instance.
  5. Masukkan sandi untuk pengguna root.
  6. Klik Create.

    Anda akan kembali ke daftar instance. Anda dapat langsung mengklik instance baru untuk melihat detailnya, tetapi instance tidak akan tersedia untuk operasi lain sampai instance melakukan inisialisasi dan dimulai.

  1. Download MySQL Community Server untuk platform Anda dari halaman download MySQL Community Server.
    Server Komunitas mencakup klien MySQL.
  2. Instal Server Komunitas, dengan mengikuti petunjuk di halaman download.

Untuk mengetahui informasi selengkapnya tentang cara menginstal MySQL, lihat Menginstal dan Mengupgrade MySQL.

Menginstal klien Proxy Auth Cloud SQL

Biner Proxy Auth Cloud SQL yang Anda download tergantung pada sistem operasi Anda, dan apakah menggunakan kernel 32-bit atau 64-bit. Sebagian besar perangkat keras yang lebih baru menggunakan kernel 64-bit. Jika tidak yakin apakah mesin Anda menjalankan kernel 32-bit atau 64-bit, gunakan perintah uname -a untuk Linux atau macOS. Untuk Windows, lihat dokumentasi Windows.

Linux 64 bit

  1. Download Proxy Auth Cloud SQL:
    curl -o cloud-sql-proxy https://storage.googleapis.com/cloud-sql-connectors/cloud-sql-proxy/v2.10.1/cloud-sql-proxy.linux.amd64
    
  2. Buat Proxy Auth Cloud SQL agar dapat dieksekusi:
    chmod +x cloud-sql-proxy
    

Linux 32 bit

  1. Download Proxy Auth Cloud SQL:
    curl -o cloud-sql-proxy https://storage.googleapis.com/cloud-sql-connectors/cloud-sql-proxy/v2.10.1/cloud-sql-proxy.linux.386
    
  2. Jika perintah curl tidak ditemukan, jalankan sudo apt install curl dan ulangi perintah download.
  3. Buat Proxy Auth Cloud SQL agar dapat dieksekusi:
    chmod +x cloud-sql-proxy
    

macOS 64-bit

  1. Download Proxy Auth Cloud SQL:
    curl -o cloud-sql-proxy https://storage.googleapis.com/cloud-sql-connectors/cloud-sql-proxy/v2.10.1/cloud-sql-proxy.darwin.amd64
    
  2. Buat Proxy Auth Cloud SQL agar dapat dieksekusi:
    chmod +x cloud-sql-proxy
    

Mac M1

  1. Download Proxy Auth Cloud SQL:
      curl -o cloud-sql-proxy https://storage.googleapis.com/cloud-sql-connectors/cloud-sql-proxy/v2.10.1/cloud-sql-proxy.darwin.arm64
      
  2. Buat Proxy Auth Cloud SQL agar dapat dieksekusi:
      chmod +x cloud-sql-proxy
      

Windows 64 bit

Klik kanan https://storage.googleapis.com/cloud-sql-connectors/cloud-sql-proxy/v2.10.1/cloud-sql-proxy.x64.exe, lalu pilih Save Link As untuk mendownload Proxy Auth Cloud SQL. Ganti nama file menjadi cloud-sql-proxy.exe.

Windows 32 bit

Klik kanan https://storage.googleapis.com/cloud-sql-connectors/cloud-sql-proxy/v2.10.1/cloud-sql-proxy.x86.exe, lalu pilih Save Link As untuk mendownload Proxy Auth Cloud SQL. Ganti nama file menjadi cloud-sql-proxy.exe.

Image Docker Proxy Auth Cloud SQL

Auth Proxy Cloud SQL memiliki image container yang berbeda, seperti distroless, alpine, dan buster. Image container Proxy Auth Cloud SQL default menggunakan distroless, yang tidak berisi shell. Jika Anda memerlukan shell atau alat terkait, download gambar berdasarkan alpine atau buster. Untuk mengetahui informasi selengkapnya, lihat Image Container Proxy Auth Cloud SQL.

Anda dapat menarik image terbaru ke mesin lokal menggunakan Docker dengan menggunakan perintah berikut:

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

OS lainnya

Untuk sistem operasi lain yang tidak disertakan di sini, Anda dapat mengompilasi Proxy Auth Cloud SQL dari sumber.

Mendapatkan nama koneksi instance

  1. Di konsol Google Cloud, buka halaman Instance Cloud SQL.

    Buka Instance Cloud SQL

  2. Klik nama instance untuk membuka halaman Ringkasan.
  3. Di bagian Terhubung ke instance ini, salin Nama koneksi. Nama koneksi dalam format projectID:region:instanceID.

Memulai Proxy Auth Cloud SQL

Mulai Proxy Auth Cloud SQL di terminalnya sendiri sehingga Anda dapat memantau outputnya. Ganti INSTANCE_CONNECTION_NAME dengan nama koneksi instance yang Anda salin di langkah sebelumnya.

Untuk lingkungan Linux, gunakan perintah ini untuk meluncurkan Proxy Auth Cloud SQL:

./cloud-sql-proxy INSTANCE_CONNECTION_NAME

Pada PowerShell di Windows, gunakan perintah ini untuk meluncurkan Proxy Auth Cloud SQL:

.\cloud-sql-proxy.exe INSTANCE_CONNECTION_NAME

Akan muncul pesan yang mirip dengan berikut ini:

Listening on 127.0.0.1:3306 for INSTANCE_CONNECTION_NAME
Ready for new connections

Jalankan perintah berikut:

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

Pada perintah Enter password:, masukkan sandi akun pengguna root MySQL Anda.

Pastikan perintah MySQL muncul. Anda telah terhubung ke database Anda menggunakan klien mysql.

Kembali ke jendela terminal tempat Anda memulai Proxy Auth Cloud SQL. Anda akan melihat pesan yang mirip dengan berikut ini:

New connection for myInstance

Pembersihan

Agar tidak menimbulkan biaya pada akun Google Cloud Anda untuk resource yang digunakan pada halaman ini, ikuti langkah-langkah berikut.

  1. Di konsol Google Cloud, buka halaman Instance Cloud SQL.

    Buka Instance Cloud SQL

  2. Pilih instance myinstance untuk membuka halaman Instance details.
  3. Pada panel ikon di bagian atas halaman, klik Hapus.
  4. Di jendela Hapus instance, ketik nama instance, lalu klik Hapus.

Langkah-langkah pembersihan opsional

Jika tidak menggunakan API yang diaktifkan sebagai bagian dari panduan memulai ini, Anda dapat menonaktifkannya.

  • API yang diaktifkan dalam panduan memulai ini:
    • Cloud SQL Admin API
  1. Di konsol Google Cloud, buka halaman APIs.

    Buka API

  2. Pilih Cloud SQL Admin API, lalu klik tombol Disable API.

Langkah selanjutnya