Memigrasikan subnet layanan dari peering ke Private Service Connect

Dokumen ini menjelaskan cara produsen layanan memigrasikan layanan berbasis peering mereka ke Private Service Connect dan mempertahankan alamat IP yang digunakan untuk mengakses layanan. Proses migrasi ini memerlukan semua resource yang terhubung ke subnet tertentu untuk dimigrasikan secara bersamaan.

Proses migrasi dimulai oleh produsen layanan, tetapi melibatkan tugas yang diselesaikan oleh produsen dan konsumen. Layanan yang dikelola Google dapat menggunakan agen layanan untuk melakukan tugas atas nama konsumen. Migrasi ini melibatkan periode nonaktif dan perubahan harga untuk produsen dan konsumen.

Setiap produsen layanan menentukan apakah dan kapan mereka akan bermigrasi ke Private Service Connect. Untuk mengetahui apakah produsen layanan bermigrasi dari Peering Jaringan VPC ke Private Service Connect, periksa dokumentasi layanan atau hubungi produsen layanan.

Sebelum memulai

Men-deploy layanan menggunakan Private Service Connect

Buat jaringan VPC baru, deploy resource layanan di jaringan, dan publikasikan layanan melalui Private Service Connect.

Saat membuat load balancer untuk layanan, gunakan alamat IP yang berbeda dari alamat yang sebelumnya digunakan oleh load balancer. Alamat IP asli diperlukan nanti untuk membuat endpoint.

Saat memublikasikan layanan, Anda membuat lampiran layanan. URI lampiran layanan juga diperlukan nanti untuk membuat endpoint.

Menonaktifkan layanan berbasis peering

Untuk menonaktifkan layanan berbasis peering, Anda harus membuat rentang internal untuk mencadangkan rentang alamat IP layanan sebelum menghapus subnet produsen.

Membuat rentang internal

Sebelum Anda menghapus subnet produsen, buat rentang internal untuk mencegah rentang alamat IP subnet digunakan kembali oleh subnet lain di jaringan produsen atau konsumen.

Untuk informasi selengkapnya tentang rentang internal ini, lihat Rentang internal untuk migrasi.

gcloud

Gunakan perintah internal-ranges create.

gcloud network-connectivity internal-ranges create RANGE_NAME \
    --project=PRODUCER_PROJECT_ID \
    --ip-cidr-range=CIDR_RANGE \
    --network=PRODUCER_NETWORK_NAME \
    --usage=FOR_MIGRATION \
    --migration-source=PRODUCER_SUBNET_URI \
    --migration-target=CONSUMER_SUBNET_URI

Ganti kode berikut:

  • RANGE_NAME: nama rentang internal baru.
  • PRODUCER_PROJECT_ID: ID project produsen.
  • CIDR_RANGE: rentang CIDR yang akan dialokasikan ke rentang internal baru.
  • PRODUCER_NETWORK_NAME: nama jaringan tempat rentang internal akan dibuat.
  • PRODUCER_SUBNET_URI: URI subnet produsen yang berisi load balancer untuk layanan.
  • CONSUMER_SUBNET_URI: URI subnet konsumen yang dimaksud. Subnet ini tidak ada saat Anda menjalankan perintah ini.

Menghapus subnet produsen peering

Anda harus menghapus semua resource di subnet produsen sebelum dapat menghapus subnet—misalnya, instance virtual machine (VM), aturan penerusan, grup instance, health check, dan alamat IP yang dicadangkan. Setelah menghapus resource, Anda dapat menghapus subnet.

Membuat resource konsumen

Bekerja samalah dengan konsumen layanan untuk membuat resource berikut di jaringan VPC-nya. Resource dapat dibuat secara manual, atau untuk layanan yang dikelola Google, dapat diotomatiskan melalui agen layanan.

Membuat subnet migrasi peer

Buat subnet migrasi peer di jaringan VPC konsumen untuk menyediakan alamat IP bagi endpoint Private Service Connect. Subnet memiliki tujuan PEER_MIGRATION yang mencegah subnet digunakan untuk resource selain endpoint Private Service Connect.

Untuk informasi selengkapnya, lihat Subnet migrasi peer.

gcloud

Gunakan perintah networks subnets create.

gcloud compute networks subnets create CONSUMER_SUBNET \
    --purpose=PEER_MIGRATION \
    --project=CONSUMER_PROJECT \
    --network=CONSUMER_NETWORK \
    --range=CIDR_RANGE \
    --region=REGION

Ganti kode berikut:

  • CONSUMER_SUBNET: nama subnet konsumen
  • CONSUMER_PROJECT: ID project konsumen
  • CONSUMER_NETWORK: nama jaringan konsumen
  • CIDR_RANGE: rentang CIDR yang akan dialokasikan ke subnet baru; rentang ini harus cocok dengan rentang CIDR dari rentang internal
  • REGION: region tempat membuat subnet

Membuat endpoint Private Service Connect

Buat endpoint Private Service Connect di subnet migrasi peer konsumen. Konsumen memerlukan URI lampiran layanan untuk membuat endpoint.

gcloud

  1. Cadangkan alamat IP internal untuk endpoint.

    Gunakan perintah addresses create.

    gcloud compute addresses create ENDPOINT_ADDRESS_NAME \
        --project=CONSUMER_PROJECT \
        --region=REGION \
        --address=ENDPOINT_ADDRESS \
        --subnet=CONSUMER_SUBNET
    

    Ganti kode berikut:

    • ENDPOINT_ADDRESS_NAME: nama untuk resource alamat IP
    • CONSUMER_PROJECT: ID project konsumen
    • REGION: region tempat membuat alamat IP
    • ENDPOINT_ADDRESS: alamat IP yang akan ditetapkan ke resource alamat IP; alamat ini harus berupa alamat IP yang sama dengan yang digunakan di load balancer layanan
    • CONSUMER_SUBNET: nama subnet konsumen
  2. Buat endpoint.

    Gunakan perintah forwarding-rules create.

    gcloud compute forwarding-rules create ENDPOINT \
        --region=REGION \
        --network=CONSUMER_NETWORK \
        --address=ENDPOINT_ADDRESS \
        --target-service-attachment=SERVICE_ATTACHMENT_URI
    

    Ganti kode berikut:

    • ENDPOINT: nama untuk endpoint
    • REGION: region tempat membuat endpoint
    • CONSUMER_NETWORK: nama jaringan konsumen
    • ENDPOINT_ADDRESS: alamat IP yang dicadangkan untuk ditetapkan ke endpoint; Anda dapat menentukan alamat IP secara langsung, atau menggunakan nama resource alamat IP
    • SERVICE_ATTACHMENT_URI: URI lampiran layanan

Menghapus rentang internal produsen

Setelah subnet migrasi konsumen dibuat, rentang internal tidak diperlukan lagi dan dapat dihapus.

gcloud

Gunakan perintah internal-ranges delete.

gcloud network-connectivity internal-ranges delete RANGE_NAME \
    --project=PRODUCER_PROJECT_ID

Ganti kode berikut:

  • RANGE_NAME: nama rentang internal
  • PRODUCER_PROJECT_ID: ID project produser

Memvalidasi bahwa endpoint berfungsi

Minta konsumen untuk mengonfirmasi bahwa mereka dapat terhubung ke layanan melalui endpoint.

Jika endpoint tidak berfungsi, dan pemecahan masalah tidak menyelesaikan masalah, Anda dapat melakukan rollback migrasi.

Menyelesaikan migrasi

Jika endpoint berfungsi seperti yang diharapkan, Anda dapat menyelesaikan migrasi dengan memperbarui subnet migrasi peer konsumen ke subnet reguler.

Memperbarui subnet migrasi peer konsumen

Memperbarui subnet migrasi peer konsumen ke subnet reguler memungkinkan konsumen menggunakan subnet untuk semua jenis resource.

gcloud

Gunakan perintah networks subnets create.

gcloud compute networks subnets update CONSUMER_SUBNET \
    --purpose=PRIVATE \
    --region=REGION \
    --project=CONSUMER_PROJECT

Ganti kode berikut:

  • CONSUMER_SUBNET: nama subnet konsumen
  • REGION: region subnet konsumen
  • CONSUMER_PROJECT: ID project konsumen

Menghapus koneksi peering

Jika koneksi peering tidak lagi diperlukan, hapus konfigurasi peering untuk konsumen dan produsen.

Me-roll back migrasi

Anda hanya dapat melakukan rollback migrasi jika subnet konsumen belum diperbarui ke subnet reguler. Jika Anda melakukan rollback, layanan akan tersedia melalui Peering Jaringan VPC.

  1. Jika masih ada, hapus rentang internal di project produser.
  2. Buat rentang internal di project konsumen. Saat melakukan rollback, sumber migrasi adalah subnet konsumen, dan target migrasi adalah subnet produsen.

    gcloud network-connectivity internal-ranges create RANGE_NAME \
        --project=CONSUMER_PROJECT \
        --ip-cidr-range=CIDR_RANGE \
        --network=CONSUMER_NETWORK \
        --usage=FOR_MIGRATION \
        --migration-source=CONSUMER_SUBNET_URI \
        --migration-target=PRODUCER_SUBNET_URI
    
  3. Hapus endpoint Private Service Connect konsumen.

  4. Hapus resource alamat IP konsumen.

  5. Buat ulang subnet produsen menggunakan nama dan rentang CIDR yang sama. Tetapkan tujuan subnet ke PRIVATE.

  6. Buat ulang resource yang diperlukan untuk menyediakan layanan di subnet produsen.

  7. Konsumen memvalidasi bahwa mereka dapat mengakses layanan melalui koneksi peering.