Mengonfigurasi pool pribadi

Memproses live stream memerlukan pengelolaan beberapa komponen yang melakukan tugas seperti penyerapan, transcoding, dan multipleks. Live Stream API mengelola komponen dan resource ini secara internal menggunakan kumpulan. Kumpulan adalah unit pemrosesan yang dialokasikan untuk setiap project Google Cloud per region dan digunakan bersama oleh semua saluran di region tertentu.

Secara default, saat membuat resource Input, Anda akan diberi URI endpoint yang berisi alamat IP publik tempat Anda dapat mengirim streaming input. Baik Anda melakukan streaming dari jaringan lokal maupun dari jaringan virtual private cloud (VPC) Google Cloud, data akan melintasi internet publik untuk menjangkau endpoint layanan live stream.

Sebagai alternatif, Anda dapat menyiapkan akses layanan pribadi ke layanan live stream. 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. Koneksi ini memungkinkan instance VM di jaringan VPC Anda berkomunikasi dengan layanan ini menggunakan alamat IP internal, tanpa mengekspos traffic ke internet publik. Saat Anda mengaktifkan akses layanan pribadi di Live Stream API, alamat IP internal dicadangkan dari jaringan VPC Anda untuk digunakan sebagai endpoint input. Hal ini memiliki keuntungan berikut:

• Keamanan yang ditingkatkan: Akses layanan pribadi memungkinkan Anda terhubung ke endpoint input Live Stream API tanpa mengekspos traffic ke internet publik. Hal ini dapat membantu meningkatkan postur keamanan dan mengurangi risiko kebocoran data.
• Peningkatan performa: Akses layanan pribadi dapat meningkatkan performa koneksi Anda dengan menghindari internet publik. Hal ini dapat sangat bermanfaat untuk mencapai latensi yang lebih rendah dan throughput yang lebih tinggi.

Anda juga dapat menyambungkan akses layanan pribadi dengan Cloud Interconnect atau Cloud VPN untuk menyediakan koneksi pribadi menyeluruh antara jaringan lokal dan layanan live stream.

Sebelum memulai

Untuk mengonfigurasi kumpulan pribadi, selesaikan 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.
• Anda harus mengonfigurasi akses layanan pribadi di jaringan VPC.
• Semua saluran di wilayah tersebut harus dihentikan. Jika tidak, Live Stream API akan menolak permintaan untuk memperbarui jaringan peer kumpulan.
• Semua saluran di wilayah tidak dapat dimulai saat kumpulan sedang diperbarui.

Mengonfigurasi pool pribadi

1. Pastikan kumpulan default sudah dibuat. Kumpulan default untuk lokasi dibuat saat Anda membuat resource Input pertama.

   Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

   • PROJECT_NUMBER: nomor project Google Cloud Anda; nomor ini berada di kolom Project number di halaman IAM Settings
   • LOCATION: gunakan salah satu wilayah yang didukung tempat Anda telah membuat input
     Menampilkan lokasi
     • us-central1
     • us-east1
     • us-east4
     • us-west1
     • us-west2
     • northamerica-northeast1
     • southamerica-east1
     • asia-east1
     • asia-east2
     • asia-south1
     • asia-northeast1
     • asia-southeast1
     • australia-southeast1
     • europe-north1
     • europe-west1
     • europe-west2
     • europe-west3
     • europe-west4

   Untuk mengirim permintaan Anda, perluas salah satu opsi berikut:

   curl (Linux, macOS, atau Cloud Shell)

   Catatan: Perintah berikut mengasumsikan bahwa Anda telah login ke gcloud CLI dengan akun pengguna Anda dengan menjalankan gcloud init atau gcloud auth login , atau dengan menggunakan Cloud Shell, yang secara otomatis membuat Anda login ke gcloud CLI . Anda dapat memeriksa akun yang saat ini aktif dengan menjalankan gcloud auth list.

   Jalankan perintah berikut:

   curl -X GET \
        -H "Authorization: Bearer $(gcloud auth print-access-token)" \
        "https://livestream.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION/pools/default"

   PowerShell (Windows)

   Catatan: Perintah berikut mengasumsikan bahwa Anda telah login ke gcloud CLI dengan akun pengguna Anda dengan menjalankan gcloud init atau gcloud auth login . Anda dapat memeriksa akun yang saat ini aktif dengan menjalankan gcloud auth list.

   Jalankan perintah berikut:

   $cred = gcloud auth print-access-token
   $headers = @{ "Authorization" = "Bearer $cred" }
   
   Invoke-WebRequest `
       -Method GET `
       -Headers $headers `
       -Uri "https://livestream.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION/pools/default" | Select-Object -Expand Content

   Anda akan melihat respons JSON seperti berikut:

   {
     "name": "projects/PROJECT_NUMBER/locations/LOCATION/pools/default",
     "createTime": CREATE_TIME,
     "updateTime": UPDATE_TIME
   }
   

2. Perbarui kumpulan dengan nama jaringan yang dipetakan.

   Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

   • PROJECT_NUMBER: nomor project Google Cloud Anda; nomor ini berada di kolom Project number di halaman IAM Settings
   • LOCATION: lokasi kumpulan default; gunakan salah satu region yang didukung
     Menampilkan lokasi
     • us-central1
     • us-east1
     • us-east4
     • us-west1
     • us-west2
     • northamerica-northeast1
     • southamerica-east1
     • asia-east1
     • asia-east2
     • asia-south1
     • asia-northeast1
     • asia-southeast1
     • australia-southeast1
     • europe-north1
     • europe-west1
     • europe-west2
     • europe-west3
     • europe-west4
   • NETWORK: ID yang ditentukan pengguna untuk jaringan dalam project saat ini untuk melakukan peering dengan layanan

   Untuk mengirim permintaan Anda, perluas salah satu opsi berikut:

   curl (Linux, macOS, atau Cloud Shell)

   Catatan: Perintah berikut mengasumsikan bahwa Anda telah login ke gcloud CLI dengan akun pengguna Anda dengan menjalankan gcloud init atau gcloud auth login , atau dengan menggunakan Cloud Shell, yang secara otomatis membuat Anda login ke gcloud CLI . Anda dapat memeriksa akun yang saat ini aktif dengan menjalankan gcloud auth list.

   Simpan isi permintaan dalam file bernama request.json. Jalankan perintah berikut di terminal untuk membuat atau menimpa file ini di direktori saat ini:

   cat > request.json << 'EOF'
   {
     "networkConfig": {
       "peeredNetwork": "projects/PROJECT_NUMBER/global/networks/NETWORK"
     }
   }
   EOF

   Kemudian jalankan perintah berikut untuk mengirim permintaan REST Anda:

   curl -X PATCH \
        -H "Authorization: Bearer $(gcloud auth print-access-token)" \
        -H "Content-Type: application/json; charset=utf-8" \
        -d @request.json \
        "https://livestream.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION/pools/default?updateMask=networkConfig"

   PowerShell (Windows)

   Catatan: Perintah berikut mengasumsikan bahwa Anda telah login ke gcloud CLI dengan akun pengguna Anda dengan menjalankan gcloud init atau gcloud auth login . Anda dapat memeriksa akun yang saat ini aktif dengan menjalankan gcloud auth list.

   Simpan isi permintaan dalam file bernama request.json. Jalankan perintah berikut di terminal untuk membuat atau menimpa file ini di direktori saat ini:

   @'
   {
     "networkConfig": {
       "peeredNetwork": "projects/PROJECT_NUMBER/global/networks/NETWORK"
     }
   }
   '@  | Out-File -FilePath request.json -Encoding utf8

   Kemudian jalankan perintah berikut untuk mengirim permintaan REST Anda:

   $cred = gcloud auth print-access-token
   $headers = @{ "Authorization" = "Bearer $cred" }
   
   Invoke-WebRequest `
       -Method PATCH `
       -Headers $headers `
       -ContentType: "application/json; charset=utf-8" `
       -InFile request.json `
       -Uri "https://livestream.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION/pools/default?updateMask=networkConfig" | Select-Object -Expand Content

   Anda akan melihat respons JSON seperti berikut:

   {
     "name": "projects/PROJECT_NUMBER/locations/LOCATION/operations/OPERATION_ID",
     "metadata": {
       "@type": "type.googleapis.com/google.cloud.video.livestream.v1.OperationMetadata",
       "createTime": CREATE_TIME,
       "target": "projects/PROJECT_NUMBER/locations/LOCATION/pools/default",
       "verb": "update",
       "requestedCancellation": false,
       "apiVersion": "v1"
     },
     "done": false
   }
   

   Permintaan ini memulai operasi yang berjalan lama. Salin OPERATION_ID yang ditampilkan untuk digunakan di langkah berikutnya.

3. Gunakan metode projects.locations.operations.get untuk memeriksa apakah update sudah selesai. Pembaruan kumpulan mungkin memerlukan waktu hingga 30 menit untuk selesai. Jika respons berisi "done: false", ulangi permintaan hingga respons berisi "done: true".

   Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

   • PROJECT_NUMBER: nomor project Google Cloud Anda; nomor ini berada di kolom Project number di halaman IAM Settings
   • LOCATION: lokasi tempat resource Anda berada; gunakan salah satu region yang didukung
     Menampilkan lokasi
     • us-central1
     • us-east1
     • us-east4
     • us-west1
     • us-west2
     • northamerica-northeast1
     • southamerica-east1
     • asia-east1
     • asia-east2
     • asia-south1
     • asia-northeast1
     • asia-southeast1
     • australia-southeast1
     • europe-north1
     • europe-west1
     • europe-west2
     • europe-west3
     • europe-west4
   • OPERATION_ID: ID untuk operasi

   Untuk mengirim permintaan Anda, perluas salah satu opsi berikut:

   curl (Linux, macOS, atau Cloud Shell)

   Catatan: Perintah berikut mengasumsikan bahwa Anda telah login ke gcloud CLI dengan akun pengguna Anda dengan menjalankan gcloud init atau gcloud auth login , atau dengan menggunakan Cloud Shell, yang secara otomatis membuat Anda login ke gcloud CLI . Anda dapat memeriksa akun yang saat ini aktif dengan menjalankan gcloud auth list.

   Jalankan perintah berikut:

   curl -X GET \
        -H "Authorization: Bearer $(gcloud auth print-access-token)" \
        "https://livestream.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION/operations/OPERATION_ID"

   PowerShell (Windows)

   Catatan: Perintah berikut mengasumsikan bahwa Anda telah login ke gcloud CLI dengan akun pengguna Anda dengan menjalankan gcloud init atau gcloud auth login . Anda dapat memeriksa akun yang saat ini aktif dengan menjalankan gcloud auth list.

   Jalankan perintah berikut:

   $cred = gcloud auth print-access-token
   $headers = @{ "Authorization" = "Bearer $cred" }
   
   Invoke-WebRequest `
       -Method GET `
       -Headers $headers `
       -Uri "https://livestream.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION/operations/OPERATION_ID" | Select-Object -Expand Content

   Anda akan melihat respons JSON seperti berikut:

   {
     "name": "projects/PROJECT_NUMBER/locations/LOCATION/operations/OPERATION_ID",
     "metadata": {
       "@type": "type.googleapis.com/google.cloud.video.livestream.v1.OperationMetadata",
       "createTime": CREATE_TIME,
       "endTime": END_TIME,
       "target": "projects/PROJECT_NUMBER/locations/LOCATION/pools/default",
       "verb": "update",
       "requestedCancellation": false,
       "apiVersion": "v1"
     },
     "done": true,
     "response": {
       "@type": "type.googleapis.com/google.cloud.video.livestream.v1.Pool",
       "name": "projects/PROJECT_NUMBER/locations/LOCATION/pools/default",
       "createTime": CREATE_TIME,
       "updateTime": UPDATE_TIME,
       "networkConfig": {
         "peeredNetwork": "projects/PROJECT_NUMBER/global/networks/NETWORK"
       }
     }
   

Setelah update, semua URI untuk endpoint input yang ada (dan mendatang) di wilayah tersebut adalah alamat IP internal yang dicadangkan dari jaringan VPC yang disediakan. Cantumkan endpoint input untuk melihat URI yang diperbarui.

Catatan: Setelah update, memulai saluran pertama di wilayah memerlukan waktu lebih lama dari biasanya.

Beralih ke kumpulan publik

Untuk kembali ke kumpulan publik, berikan string kosong sebagai nama jaringan peer dalam permintaan kumpulan update.

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

• PROJECT_NUMBER: nomor project Google Cloud Anda; nomor ini berada di kolom Project number di halaman IAM Settings
• LOCATION: lokasi kumpulan default; gunakan salah satu region yang didukung
  Menampilkan lokasi
  • us-central1
  • us-east1
  • us-east4
  • us-west1
  • us-west2
  • northamerica-northeast1
  • southamerica-east1
  • asia-east1
  • asia-east2
  • asia-south1
  • asia-northeast1
  • asia-southeast1
  • australia-southeast1
  • europe-north1
  • europe-west1
  • europe-west2
  • europe-west3
  • europe-west4

Untuk mengirim permintaan Anda, perluas salah satu opsi berikut:

curl (Linux, macOS, atau Cloud Shell)

Catatan: Perintah berikut mengasumsikan bahwa Anda telah login ke gcloud CLI dengan akun pengguna Anda dengan menjalankan gcloud init atau gcloud auth login , atau dengan menggunakan Cloud Shell, yang secara otomatis membuat Anda login ke gcloud CLI . Anda dapat memeriksa akun yang saat ini aktif dengan menjalankan gcloud auth list.

Simpan isi permintaan dalam file bernama request.json. Jalankan perintah berikut di terminal untuk membuat atau menimpa file ini di direktori saat ini:

cat > request.json << 'EOF'
{
  "networkConfig": {
    "peeredNetwork": ""
  }
}
EOF

Kemudian jalankan perintah berikut untuk mengirim permintaan REST Anda:

curl -X PATCH \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://livestream.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION/pools/default?updateMask=networkConfig"

PowerShell (Windows)

Catatan: Perintah berikut mengasumsikan bahwa Anda telah login ke gcloud CLI dengan akun pengguna Anda dengan menjalankan gcloud init atau gcloud auth login . Anda dapat memeriksa akun yang saat ini aktif dengan menjalankan gcloud auth list.

Simpan isi permintaan dalam file bernama request.json. Jalankan perintah berikut di terminal untuk membuat atau menimpa file ini di direktori saat ini:

@'
{
  "networkConfig": {
    "peeredNetwork": ""
  }
}
'@  | Out-File -FilePath request.json -Encoding utf8

Kemudian jalankan perintah berikut untuk mengirim permintaan REST Anda:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method PATCH `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://livestream.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION/pools/default?updateMask=networkConfig" | Select-Object -Expand Content

Anda akan melihat respons JSON seperti berikut:

{
  "name": "projects/PROJECT_NUMBER/locations/LOCATION/operations/OPERATION_ID",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.video.livestream.v1.OperationMetadata",
    "createTime": CREATE_TIME,
    "target": "projects/PROJECT_NUMBER/locations/LOCATION/pools/default",
    "verb": "update",
    "requestedCancellation": false,
    "apiVersion": "v1"
  },
  "done": false
}

Anda dapat kembali menggunakan metode projects.locations.operations.get untuk memeriksa apakah update telah selesai.

Catatan: Setelah update, memulai saluran pertama di wilayah memerlukan waktu lebih lama dari biasanya.