Mengonfigurasi akses layanan pribadi

Akses layanan pribadi adalah koneksi pribadi yang aman antara jaringan virtual private cloud (VPC)Google Cloud Anda dan layanan pihak ketiga atau yang dikelola Google. Hal ini memungkinkan instance VM di jaringan VPC Anda berkomunikasi dengan layanan ini menggunakan alamat IP internal, tanpa mengekspos traffic ke internet publik.

Sebelum memulai

Untuk membuat koneksi pribadi, lengkapi prasyarat berikut:

  • Anda harus memiliki jaringan VPC yang ada yang dapat digunakan untuk terhubung ke jaringan produsen layanan. Instance VM harus menggunakan jaringan VPC ini untuk terhubung ke layanan melalui koneksi pribadi.
  • Ikuti langkah-langkah di halaman Live Stream API Sebelum memulai untuk membuat project Google Cloud yang dikonfigurasi dengan benar (atau pilih project yang sudah ada).

Mengaktifkan akses layanan pribadi untuk Live Stream API

Proses umum untuk mengonfigurasi akses layanan pribadi disediakan di dokumentasi Virtual Private Cloud. Halaman ini menyesuaikan proses dengan Live Stream API.

  1. Menginstal dan mengonfigurasi Google Cloud CLI.

  2. Aktifkan Service Networking API.

    Jalankan perintah berikut:

    Linux, macOS, atau Cloud Shell

    gcloud services enable servicenetworking.googleapis.com

    Windows (PowerShell)

    gcloud services enable servicenetworking.googleapis.com

    Windows (cmd.exe)

    gcloud services enable servicenetworking.googleapis.com

  3. Untuk mendapatkan izin yang diperlukan guna menyiapkan koneksi pribadi, minta administrator untuk memberi Anda peran IAM Compute Engine Network Admin (roles/compute.networkAdmin) di project Google Cloud tempat jaringan VPC berada. Untuk mengetahui informasi selengkapnya tentang cara memberikan peran, lihat Mengelola akses.

    Izin yang diperlukan juga tersedia melalui peran khusus atau peran bawaan lainnya.

  4. Di jaringan VPC, alokasikan rentang IP yang dinamai menggunakan perintah addresses create seperti yang ditunjukkan dalam contoh berikut.

    Untuk menentukan rentang alamat IP dan panjang awalan, yang juga merupakan mask subnet, gunakan flag addresses dan prefix-length. Misalnya, untuk mengalokasikan blok CIDR 192.168.0.0/13, tentukan 192.168.0.0 untuk alamat dan 13 untuk panjang awalan.

    Sebelum menggunakan salah satu data perintah di bawah, lakukan penggantian berikut:

    • RESERVED_RANGE_NAME: nama untuk rentang yang dialokasikan, seperti my-allocated-range
    • DESCRIPTION: deskripsi untuk rentang, seperti allocated for my-service
    • VPC_NETWORK: nama jaringan VPC Anda, seperti my-vpc-network

    Jalankan perintah berikut:

    Linux, macOS, atau Cloud Shell

    gcloud compute addresses create RESERVED_RANGE_NAME \
        --global \
        --purpose=VPC_PEERING \
        --addresses=192.168.0.0 \
        --prefix-length=13 \
        --description="DESCRIPTION" \
        --network=VPC_NETWORK

    Windows (PowerShell)

    gcloud compute addresses create RESERVED_RANGE_NAME `
        --global `
        --purpose=VPC_PEERING `
        --addresses=192.168.0.0 `
        --prefix-length=13 `
        --description="DESCRIPTION" `
        --network=VPC_NETWORK

    Windows (cmd.exe)

    gcloud compute addresses create RESERVED_RANGE_NAME ^
        --global ^
        --purpose=VPC_PEERING ^
        --addresses=192.168.0.0 ^
        --prefix-length=13 ^
        --description="DESCRIPTION" ^
        --network=VPC_NETWORK

    Anda akan melihat respons seperti berikut:

    Created [https://www.googleapis.com/compute/v1/projects/PROJECT_ID/global/addresses/RESERVED_RANGE_NAME].

    Untuk hanya menentukan panjang awalan, gunakan flag prefix-length. Saat Anda menghilangkan rentang alamat, Google Cloud akan otomatis memilih rentang alamat yang tidak digunakan di jaringan VPC Anda. Contoh berikut memilih rentang alamat IP yang tidak digunakan dengan panjang awalan 13-bit.

    Sebelum menggunakan salah satu data perintah di bawah, lakukan penggantian berikut:

    • RESERVED_RANGE_NAME: nama untuk rentang yang dialokasikan, seperti my-allocated-range
    • DESCRIPTION: deskripsi untuk rentang, seperti allocated for my-service
    • VPC_NETWORK: nama jaringan VPC Anda, seperti my-vpc-network

    Jalankan perintah berikut:

    Linux, macOS, atau Cloud Shell

    gcloud compute addresses create RESERVED_RANGE_NAME \
        --global \
        --purpose=VPC_PEERING \
        --prefix-length=13 \
        --description="DESCRIPTION" \
        --network=VPC_NETWORK

    Windows (PowerShell)

    gcloud compute addresses create RESERVED_RANGE_NAME `
        --global `
        --purpose=VPC_PEERING `
        --prefix-length=13 `
        --description="DESCRIPTION" `
        --network=VPC_NETWORK

    Windows (cmd.exe)

    gcloud compute addresses create RESERVED_RANGE_NAME ^
        --global ^
        --purpose=VPC_PEERING ^
        --prefix-length=13 ^
        --description="DESCRIPTION" ^
        --network=VPC_NETWORK

    Anda akan melihat respons seperti berikut:

    Created [https://www.googleapis.com/compute/v1/projects/PROJECT_ID/global/addresses/RESERVED_RANGE_NAME].

    Contoh sebelumnya membuat koneksi pribadi ke Google sehingga instance VM dalam jaringan VPC yang disediakan (misalnya, my-vpc-network) dapat menggunakan akses layanan pribadi untuk menjangkau layanan Google yang mendukungnya.

    Live Stream API memerlukan alokasi blok CIDR/13 per region. Jika Anda berencana menggunakan Live Stream API di beberapa wilayah, alokasikan blok yang lebih besar. Tabel berikut menjelaskan ukuran blok yang direkomendasikan untuk dialokasikan bergantung pada jumlah region:

    Jumlah regionnilai untuk flag prefix-length
    113
    212
    3-411
    5-810
    7-169
  5. Buat koneksi pribadi antara jaringan produsen layanan dan jaringan VPC Anda:

    1. Membuat koneksi pribadi

      Sebelum menggunakan salah satu data perintah di bawah, lakukan penggantian berikut:

      • RESERVED_RANGE_NAME: nama rentang yang dialokasikan yang Anda buat di langkah sebelumnya
      • VPC_NETWORK: nama jaringan VPC Anda
      • PROJECT_ID: project ID Google Cloud dari project yang berisi jaringan VPC Anda

      Jalankan perintah berikut:

      Linux, macOS, atau Cloud Shell

      gcloud services vpc-peerings connect \
          --service=servicenetworking.googleapis.com \
          --ranges=RESERVED_RANGE_NAME \
          --network=VPC_NETWORK \
          --project=PROJECT_ID

      Windows (PowerShell)

      gcloud services vpc-peerings connect `
          --service=servicenetworking.googleapis.com `
          --ranges=RESERVED_RANGE_NAME `
          --network=VPC_NETWORK `
          --project=PROJECT_ID

      Windows (cmd.exe)

      gcloud services vpc-peerings connect ^
          --service=servicenetworking.googleapis.com ^
          --ranges=RESERVED_RANGE_NAME ^
          --network=VPC_NETWORK ^
          --project=PROJECT_ID

      Anda akan melihat respons seperti berikut:

      Operation "operations/OPERATION_ID" finished successfully.

      Perintah ini membuat operasi yang berjalan lama (LRO).

    2. Jika perintah berhasil, lanjutkan ke langkah berikutnya. Jika tidak, periksa status operasi.

      Sebelum menggunakan salah satu data perintah di bawah, lakukan penggantian berikut:

      • OPERATION_ID: ID operasi yang ditampilkan di langkah sebelumnya

      Jalankan perintah berikut:

      Linux, macOS, atau Cloud Shell

      gcloud services vpc-peerings operations describe \
        --name=operations/OPERATION_ID

      Windows (PowerShell)

      gcloud services vpc-peerings operations describe `
        --name=operations/OPERATION_ID

      Windows (cmd.exe)

      gcloud services vpc-peerings operations describe ^
        --name=operations/OPERATION_ID

      Anda akan melihat respons seperti berikut:

      Operation "operations/OPERATION_ID" finished successfully.

  6. (Opsional) Jika menggunakan Kontrol Layanan VPC, Anda harus mengaktifkan VPC-SC untuk koneksi pribadi yang baru saja Anda buat.

    Sebelum menggunakan salah satu data perintah di bawah, lakukan penggantian berikut:

    • VPC_NETWORK: nama jaringan VPC Anda

    Jalankan perintah berikut:

    Linux, macOS, atau Cloud Shell

    gcloud services vpc-peerings enable-vpc-service-controls \
        --service=servicenetworking.googleapis.com \
        --network=VPC_NETWORK

    Windows (PowerShell)

    gcloud services vpc-peerings enable-vpc-service-controls `
        --service=servicenetworking.googleapis.com `
        --network=VPC_NETWORK

    Windows (cmd.exe)

    gcloud services vpc-peerings enable-vpc-service-controls ^
        --service=servicenetworking.googleapis.com ^
        --network=VPC_NETWORK

    Anda akan melihat respons seperti berikut:

    Operation "operations/OPERATION_ID" finished successfully.

  7. (Opsional) Jika memiliki jaringan lokal yang terhubung ke VPC, Anda dapat mengonfigurasi koneksi peering agar host lokal dapat berkomunikasi dengan jaringan produsen layanan. Untuk mengetahui informasi selengkapnya, lihat pemecahan masalah host lokal.