Menghubungkan menggunakan IP publik

Halaman ini merangkum cara terhubung ke database yang ditayangkan oleh AlloyDB untuk PostgreSQL menggunakan IP publik. AlloyDB mendukung koneksi masuk dan keluar melalui dua opsi yang berbeda.

Anda dapat mengonfigurasi instance AlloyDB agar memiliki alamat IPv4 publik untuk koneksi masuk dan secara opsional, menerima koneksi dari alamat IP eksternal tertentu atau rentang alamat, yang disebut jaringan eksternal yang diizinkan. Jaringan yang diizinkan tidak diperlukan saat Anda menggunakan Konektor Bahasa AlloyDB atau Proxy Auth AlloyDB untuk terhubung ke instance Anda.

Jaringan resmi ini hanya tersedia saat menggunakan IP publik. Anda tidak dapat menentukan jaringan pribadi sebagai jaringan eksternal yang diotorisasi.

AlloyDB mendukung koneksi keluar saat Anda mengaktifkan IP publik keluar di instance Anda. Konektivitas keluar berguna untuk skenario, seperti memigrasikan database Anda ke AlloyDB dari sumber eksternal.

Buat instance AlloyDB

Untuk membuat instance dengan IP publik, lakukan hal berikut:

Konsol

1. Buka halaman Clusters.

   Buka Cluster

2. Klik cluster di kolom Nama Resource.

3. Di halaman Overview, buka Instances in your cluster, lalu klik Create primary instance.

4. Konfigurasi instance utama Anda:

   1. Di kolom Instance ID, masukkan ID untuk instance utama Anda.
   2. Di bagian Zonal availability, pilih salah satu opsi berikut:
      1. Untuk membuat instance produksi dengan ketersediaan tinggi dan failover otomatis, pilih Beberapa zona (Ketersediaan tinggi).
      2. Untuk membuat instance dasar yang tidak perlu memiliki ketersediaan tinggi, pilih Single zone.
   3. Pilih jenis mesin.
   4. Di bagian Connectivity, pilih Enable Public IP untuk mendukung koneksi masuk.
   5. Opsional: Untuk menambahkan konektivitas keluar, di bagian Outbound Public IP Addresses, pilih Enable Outbound Public IP.
   6. Opsional: Untuk mengonfigurasi persyaratan SSL atau konektor pada instance, luaskan Opsi konfigurasi lanjutan, lalu lakukan langkah-langkah berikut:
      1. Secara default, instance AlloyDB mewajibkan semua koneksi untuk menggunakan enkripsi SSL. Untuk mengizinkan koneksi non-SSL, hapus centang pada kotak Hanya izinkan koneksi SSL.
      2. Untuk mewajibkan semua koneksi database ke instance menggunakan Proxy Auth AlloyDB atau library konektor aman yang disediakan oleh Google, pilih Terapkan mTLS melalui konektor AlloyDB.
   7. Opsional: Untuk membatasi koneksi langsung ke alamat IP tertentu, tambahkan daftar rentang CIDR yang dipisahkan koma:
      1. Di bagian Authorized external networks, masukkan daftar rentang CIDR yang dipisahkan dengan koma. Untuk setiap rentang CIDR, masukkan blok CIDR, seperti 64.233.160.0/16. Untuk meminimalkan potensi permukaan serangan, pertahankan agar daftar alamat tetap sekecil mungkin.
   8. Klik Create instance.

gcloud

Untuk menggunakan gcloud CLI, Anda dapat menginstal dan melakukan inisialisasi Google Cloud CLI, atau Anda dapat menggunakan Cloud Shell.

Untuk mengetahui informasi selengkapnya tentang cara membuat jenis instance lainnya, lihat Membuat instance kumpulan baca dan Membuat instance sekunder.

Gunakan perintah gcloud alloydb instances create untuk membuat instance.

gcloud alloydb instances create INSTANCE_ID \
    --instance-type=PRIMARY \
    --cpu-count=CPU_COUNT \
    --region=REGION_ID \
    --cluster=CLUSTER_ID \
    --project=PROJECT_ID \
    --assign-inbound-public-ip=ASSIGN_IPV4

Ganti kode berikut:

• INSTANCE_ID: ID instance yang Anda buat. Nama harus diawali dengan huruf kecil dan dapat berisi huruf kecil, angka, dan tanda hubung.
• CPU_COUNT: jumlah vCPU yang Anda inginkan untuk instance. Nilai yang valid mencakup berikut ini:
  • 2: 2 vCPU, RAM 16 GB
  • 4: 4 vCPU, RAM 32 GB
  • 8: 8 vCPU, RAM 64 GB
  • 16: 16 vCPU, RAM 128 GB
  • 32: 32 vCPU, RAM 256 GB
  • 64: 64 vCPU, RAM 512 GB
  • 96: 96 vCPU, RAM 768 GB
  • 128: 128 vCPU, RAM 864 GB
• REGION_ID: region tempat Anda ingin menempatkan instance.
• CLUSTER_ID: ID cluster yang Anda buat sebelumnya.

Opsional: Menambahkan jaringan eksternal yang diizinkan

Tambahkan daftar rentang CIDR yang dipisahkan koma jika Anda ingin membatasi koneksi langsung ke alamat IP tertentu.

gcloud alloydb instances create INSTANCE_ID \
    --instance-type=PRIMARY \
    --cpu-count=CPU_COUNT \
    --region=REGION_ID \
    --cluster=CLUSTER_ID \
    --project=PROJECT_ID \
    --assign-inbound-public-ip=ASSIGN_IPV4 \
    --authorized-external-networks=CIDR_RANGE1,CIDR_RANGE2,...

Ganti kode berikut:

• CIDR_RANGE: daftar blok CIDR yang dipisahkan koma, seperti 64.233.160.0/16. Untuk meminimalkan potensi permukaan serangan, jaga agar daftar alamat tetap sekecil mungkin.

Opsional: Menambahkan konektivitas keluar

Tambahkan tanda --outbound-public-ip untuk mengaktifkan alamat IP publik keluar. Anda hanya dapat mengaktifkan IP publik keluar untuk instance primer dan sekunder.

gcloud alloydb instances create INSTANCE_ID \
    --instance-type=PRIMARY \
    --cpu-count=CPU_COUNT \
    --region=REGION_ID \
    --cluster=CLUSTER_ID \
    --project=PROJECT_ID \
    --assign-inbound-public-ip=ASSIGN_IPV4
    --outbound-public-ip

Mengaktifkan IP publik pada instance

Untuk mengaktifkan konektivitas masuk menggunakan IP publik, lakukan hal berikut:

Konsol

1. Buka halaman Clusters.

   Buka Cluster

2. Klik cluster di kolom Nama Resource.

3. Di halaman Overview yang terbuka, buka bagian Instances in your cluster, lalu temukan instance utama Anda.

4. Klik Tindakan instance > Edit.

5. Di bagian Connectivity, centang kotak Enable Public IP untuk mendukung koneksi masuk.

6. Opsional: Di bagian Jaringan eksternal yang diizinkan, masukkan daftar rentang CIDR yang dipisahkan koma jika Anda ingin membatasi koneksi langsung ke alamat IP tertentu.

   Untuk setiap rentang CIDR, masukkan blok CIDR, seperti 64.233.160.0/16. Untuk meminimalkan potensi permukaan serangan, jaga agar daftar alamat tetap sekecil mungkin.

7. Klik Perbarui instance untuk menyimpan perubahan.

gcloud

Untuk menggunakan gcloud CLI, Anda dapat menginstal dan melakukan inisialisasi Google Cloud CLI, atau Anda dapat menggunakan Cloud Shell.

Gunakan perintah gcloud alloydb instances update untuk mengaktifkan IP publik di instance Anda.

gcloud alloydb instances update INSTANCE_ID \
    --cluster=CLUSTER_ID  \
    --region=REGION_ID  \
    --assign-inbound-public-ip=ASSIGN_IPV4

Ganti kode berikut:

• INSTANCE_ID: ID instance yang Anda buat. Nama harus diawali dengan huruf kecil dan dapat berisi huruf kecil, angka, dan tanda hubung.
• CLUSTER_ID: ID cluster yang Anda buat. Nama harus diawali dengan huruf kecil dan dapat berisi huruf kecil, angka, dan tanda hubung.
• REGION_ID: region tempat Anda ingin menempatkan cluster.

Opsional: Menambahkan jaringan eksternal yang diizinkan

Tambahkan daftar rentang CIDR yang dipisahkan koma jika Anda ingin membatasi koneksi langsung ke alamat IP tertentu.

gcloud alloydb instances update INSTANCE_ID \
    --cluster=CLUSTER_ID  \
    --region=REGION_ID  \
    --assign-inbound-public-ip=ASSIGN_IPV4 \
    --authorized-external-networks=CIDR_RANGE1,CIDR_RANGE2,...

Ganti kode berikut:

• CIDR_RANGE: daftar blok CIDR yang dipisahkan koma, seperti 64.233.160.0/16. Untuk meminimalkan potensi permukaan serangan, jaga agar daftar alamat tetap sekecil mungkin.

Menonaktifkan IP publik pada instance

Saat Anda menonaktifkan IP publik di instance, AlloyDB akan menghapus alamat IP publik dari instance Anda dan menghapus daftar jaringan yang diizinkan. Semua koneksi masuk ke instance Anda akan gagal. Jaringan eksternal yang diizinkan hanya dapat digunakan dengan IP publik.

Untuk menonaktifkan IP publik, lakukan hal berikut:

Konsol

1. Buka halaman Clusters.

   Buka Cluster

2. Klik cluster di kolom Nama Resource.

3. Di halaman Overview yang terbuka, buka bagian Instances in your cluster, lalu temukan instance utama Anda.

4. Klik Tindakan instance > Edit.

5. Di bagian Connectivity, hapus centang pada kotak Enable Public IP untuk menghentikan koneksi masuk.

6. Opsional: Di bagian Authorized external networks, hapus rentang CIDR yang dipisahkan koma.

7. Klik Perbarui instance untuk menyimpan perubahan.

gcloud

Untuk menggunakan gcloud CLI, Anda dapat menginstal dan melakukan inisialisasi Google Cloud CLI, atau Anda dapat menggunakan Cloud Shell.

Gunakan perintah gcloud alloydb instances update untuk mengaktifkan IP publik di instance Anda.

gcloud alloydb instances update INSTANCE_ID \
    --cluster=CLUSTER_ID  \
    --region=REGION_ID  \
    --assign-inbound-public-ip=NO_PUBLIC_IP

Ganti kode berikut:

• INSTANCE_ID: ID instance yang Anda buat. Nama harus diawali dengan huruf kecil dan dapat berisi huruf kecil, angka, dan tanda hubung.
• CLUSTER_ID: ID cluster yang Anda buat. Nama harus diawali dengan huruf kecil dan dapat berisi huruf kecil, angka, dan tanda hubung.
• REGION_ID: region tempat Anda ingin menempatkan cluster.

Memperbarui jaringan eksternal yang diizinkan untuk instance

Anda dapat memperbarui daftar jaringan eksternal resmi di instance Anda kapan saja. IP publik harus diaktifkan di instance Anda saat memperbarui daftar jaringan eksternal yang diizinkan.

Jaringan eksternal resmi tidak dapat ditambahkan atau dihapus satu per satu, dan daftar jaringan akan diganti setiap kali perintah update list dijalankan. Untuk memperbarui jaringan eksternal yang diizinkan di instance, Anda harus memberikan daftar semua jaringan eksternal yang diizinkan yang dipisahkan dengan koma setiap kali Anda ingin menambahkan atau menghapus jaringan. Setiap jaringan eksternal yang diizinkan harus dalam format CIDR.

Catatan: Untuk membatasi jumlah dan ukuran Jaringan Resmi, Anda dapat menerapkan Kebijakan Org Kustom. Untuk mengetahui informasi selengkapnya, lihat Batasan dan operasi kustom yang didukung.

Untuk memperbarui daftar jaringan eksternal yang diizinkan di instance Anda, lakukan hal berikut:

Konsol

1. Buka halaman Clusters

   Buka Cluster

2. Klik cluster di kolom Nama Resource.

3. Di halaman Overview yang terbuka, buka bagian Instances in your cluster, lalu temukan instance utama Anda.

4. Klik Tindakan instance > Edit.

5. Di bagian Authorized external networks, masukkan daftar rentang CIDR yang dipisahkan dengan koma. Untuk setiap rentang CIDR, masukkan blok CIDR, seperti 64.233.160.0/16. Untuk meminimalkan potensi permukaan serangan, jaga agar daftar alamat tetap sekecil mungkin.

6. Klik Perbarui instance untuk menyimpan perubahan.

gcloud

Untuk menggunakan gcloud CLI, Anda dapat menginstal dan melakukan inisialisasi Google Cloud CLI, atau Anda dapat menggunakan Cloud Shell.

Gunakan perintah gcloud alloydb instances update untuk mengaktifkan IP publik di instance Anda.

gcloud alloydb instances update INSTANCE_ID \
    --cluster=CLUSTER_ID  \
    --region=REGION_ID  \
    --authorized-external-networks=CIDR_RANGE1,CIDR_RANGE2,...

Ganti kode berikut:

• INSTANCE_ID: ID instance yang Anda buat. Nama harus diawali dengan huruf kecil dan dapat berisi huruf kecil, angka, dan tanda hubung.
• CLUSTER_ID: ID cluster yang Anda buat. Nama harus diawali dengan huruf kecil dan dapat berisi huruf kecil, angka, dan tanda hubung.
• REGION_ID: region tempat Anda ingin menempatkan cluster.
• CIDR_RANGE: daftar blok CIDR yang dipisahkan koma, seperti 64.233.160.0/16. Untuk meminimalkan potensi permukaan serangan, jaga agar daftar alamat tetap sekecil mungkin.

Menambahkan konektivitas keluar ke instance

Anda dapat mengaktifkan IP publik keluar untuk membuat koneksi dari instance AlloyDB ke sumber eksternal. AlloyDB menghasilkan dua alamat IP publik keluar yang tetap konsisten hingga Anda menonaktifkan konektivitas keluar pada instance Anda. Anda hanya dapat mengaktifkan IP publik keluar untuk instance primer dan sekunder.

Untuk mengaktifkan IP publik keluar, lakukan hal berikut:

Konsol

1. Buka halaman Clusters.

   Buka Cluster

2. Klik cluster di kolom Nama Resource.

3. Di halaman Overview yang terbuka, buka bagian Instances in your cluster, lalu temukan instance utama Anda.

4. Klik Tindakan instance > Edit.

5. Di bagian Outbound Public IP Connectivity, centang kotak Enable Outbound Public IP untuk mendukung koneksi keluar.

6. Klik Perbarui instance untuk menyimpan perubahan.

gcloud

Untuk menggunakan gcloud CLI, Anda dapat menginstal dan melakukan inisialisasi Google Cloud CLI, atau Anda dapat menggunakan Cloud Shell.

Gunakan perintah gcloud alloydb instances update untuk mengaktifkan IP publik keluar pada instance Anda.

gcloud alloydb instances update INSTANCE_ID \
    --cluster=CLUSTER_ID  \
    --region=REGION_ID  \
    --outbound-public-ip

Ganti kode berikut:

• INSTANCE_ID: ID instance yang akan Anda tambahkan konektivitas keluar.
• CLUSTER_ID: ID cluster yang konektivitas keluarnya akan Anda tambahkan.
• REGION_ID: region tempat cluster Anda ditempatkan.

Melihat detail konektivitas untuk instance

Lihat daftar jaringan eksternal yang diizinkan di instance Anda kapan saja dan alamat IP publik yang ditetapkan menggunakan perintah gcloud alloydb instances describe. Anda juga dapat melihat alamat IP publik keluar, jika Anda telah mengaktifkan konektivitas keluar pada instance Anda.

Untuk melihat detail konektivitas, lakukan langkah-langkah berikut:

Konsol

1. Buka halaman Clusters.

   Buka Cluster

2. Klik cluster di kolom Nama Resource.

3. Buka halaman Konektivitas, tempat Anda dapat melihat informasi tentang konfigurasi IP publik, termasuk Konektivitas IP Publik dan IP Publik Keluar.

   Untuk melihat informasi IP publik, Anda juga dapat memilih instance dari Instances in your cluster, lalu mengklik View connectivity configuration.

gcloud

Untuk menggunakan gcloud CLI, Anda dapat menginstal dan melakukan inisialisasi Google Cloud CLI, atau Anda dapat menggunakan Cloud Shell.

gcloud alloydb instances describe INSTANCE_ID \
--cluster=CLUSTER_ID \
--region=REGION_ID

Ganti kode berikut:

• INSTANCE_ID: ID instance yang Anda lihat. Nama harus diawali dengan huruf kecil dan dapat berisi huruf kecil, angka, dan tanda hubung.
• CLUSTER_ID: ID cluster yang Anda lihat. Nama harus diawali dengan huruf kecil dan dapat berisi huruf kecil, angka, dan tanda hubung.
• REGION_ID: region tempat Anda ingin menempatkan cluster.

Langkah berikutnya

• Ringkasan koneksi
• Kebijakan organisasi dan batasan kustom
• Terhubung menggunakan Proxy Auth AlloyDB
• Terhubung menggunakan Konektor Bahasa AlloyDB