Mengonfigurasi pool pribadi

Pemrosesan live stream memerlukan pengelolaan beberapa komponen yang melakukan tugas seperti penyerapan, transcoding, dan multiplexing. 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 aliran input. Baik Anda melakukan streaming dari jaringan lokal maupun dari jaringan virtual private cloud (VPC) Google Cloud, data akan melewati internet publik untuk mencapai endpoint layanan live stream.

Streaming ke internet publik.

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 yang dikelola Google atau pihak ketiga. Dengan koneksi ini, instance VM di jaringan VPC Anda dapat berkomunikasi dengan layanan ini menggunakan alamat IP internal, tanpa mengekspos traffic ke internet publik. Jika Anda mengaktifkan akses layanan pribadi di Live Stream API, alamat IP internal akan dicadangkan dari jaringan VPC untuk digunakan sebagai endpoint input. Hal ini memiliki keuntungan sebagai berikut:

Keamanan yang ditingkatkan: Akses layanan pribadi memungkinkan Anda terhubung ke endpoint input Live Stream API tanpa mengekspos traffic Anda ke internet publik. Hal ini dapat membantu meningkatkan postur keamanan Anda dan mengurangi risiko pelanggaran 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 end-to-end antara jaringan lokal dan layanan live stream.

Streaming ke endpoint pribadi.

Sebelum memulai

Untuk mengonfigurasi kolam renang pribadi, selesaikan prasyarat berikut:

Anda harus memiliki jaringan VPC yang sudah 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 region tersebut harus dihentikan. Jika tidak, Live Stream API akan menolak permintaan untuk memperbarui jaringan yang di-peering oleh kumpulan.
Semua saluran di wilayah ini tidak dapat dimulai saat kumpulan sedang diperbarui.

Mengonfigurasi pool pribadi

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 Nomor project pada halaman Setelan IAM
- LOCATION: gunakan salah satu wilayah yang didukung tempat Anda telah membuat input
  Tampilkan lokasi
  - us-central1
  - us-east1
  - us-east4
  - us-west1
  - us-west2
  - northamerica-northeast1
  - southamerica-east1
  - asia-east1
  - asia-east2
  - asia-northeast1
  - asia-southeast1
  - australia-southeast1
  - 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 CLI gcloud dengan akun pengguna Anda dengan menjalankan gcloud init atau gcloud auth login, atau menggunakan Cloud Shell, yang secara otomatis membuat Anda login ke CLI gcloud. Anda dapat memeriksa akun yang aktif saat ini 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 CLI gcloud dengan akun pengguna Anda dengan menjalankan gcloud init atau gcloud auth login. Anda dapat memeriksa akun yang aktif saat ini 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
}
```
Perbarui kumpulan dengan nama jaringan yang di-peering.

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:
- PROJECT_NUMBER: nomor project Google Cloud Anda; nomor ini berada di kolom Nomor project pada halaman Setelan IAM
- LOCATION: lokasi kumpulan default; gunakan salah satu wilayah yang didukung
  Tampilkan lokasi
  - us-central1
  - us-east1
  - us-east4
  - us-west1
  - us-west2
  - northamerica-northeast1
  - southamerica-east1
  - asia-east1
  - asia-east2
  - asia-northeast1
  - asia-southeast1
  - australia-southeast1
  - europe-west1
  - europe-west2
  - europe-west3
  - europe-west4
- NETWORK: ID yang ditentukan pengguna untuk jaringan dalam project saat ini untuk di-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 CLI gcloud dengan akun pengguna Anda dengan menjalankan gcloud init atau gcloud auth login, atau menggunakan Cloud Shell, yang secara otomatis membuat Anda login ke CLI gcloud. Anda dapat memeriksa akun yang aktif saat ini 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 CLI gcloud dengan akun pengguna Anda dengan menjalankan gcloud init atau gcloud auth login. Anda dapat memeriksa akun yang aktif saat ini 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 akan memulai operasi yang berjalan lama. Salin OPERATION_ID yang ditampilkan untuk digunakan pada langkah berikutnya.
Gunakan metode projects.locations.operations.get untuk memeriksa apakah update sudah selesai. Mungkin perlu waktu hingga 30 menit untuk menyelesaikan pembaruan kumpulan. 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 Nomor project pada halaman Setelan IAM
- LOCATION: lokasi tempat resource Anda berada; gunakan salah satu wilayah yang didukung
  Tampilkan lokasi
  - us-central1
  - us-east1
  - us-east4
  - us-west1
  - us-west2
  - northamerica-northeast1
  - southamerica-east1
  - asia-east1
  - asia-east2
  - asia-northeast1
  - asia-southeast1
  - australia-southeast1
  - 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 CLI gcloud dengan akun pengguna Anda dengan menjalankan gcloud init atau gcloud auth login, atau menggunakan Cloud Shell, yang secara otomatis membuat Anda login ke CLI gcloud. Anda dapat memeriksa akun yang aktif saat ini 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 CLI gcloud dengan akun pengguna Anda dengan menjalankan gcloud init atau gcloud auth login. Anda dapat memeriksa akun yang aktif saat ini 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 pembaruan, semua URI untuk endpoint input yang ada (dan yang akan datang) di region adalah alamat IP internal yang dicadangkan dari jaringan VPC yang disediakan. Cantumkan endpoint input untuk melihat URI yang diupdate.

Beralih ke kolam renang umum

Untuk kembali ke kumpulan publik, berikan string kosong sebagai nama jaringan yang di-peering dalam permintaan kumpulan pembaruan.

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

PROJECT_NUMBER: nomor project Google Cloud Anda; nomor ini berada di kolom Nomor project pada halaman Setelan IAM
LOCATION: lokasi kumpulan default; gunakan salah satu wilayah yang didukung
Tampilkan lokasi
- us-central1
- us-east1
- us-east4
- us-west1
- us-west2
- northamerica-northeast1
- southamerica-east1
- asia-east1
- asia-east2
- asia-northeast1
- asia-southeast1
- australia-southeast1
- 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 CLI gcloud dengan akun pengguna Anda dengan menjalankan gcloud init atau gcloud auth login, atau menggunakan Cloud Shell, yang secara otomatis membuat Anda login ke CLI gcloud. Anda dapat memeriksa akun yang aktif saat ini 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 CLI gcloud dengan akun pengguna Anda dengan menjalankan gcloud init atau gcloud auth login. Anda dapat memeriksa akun yang aktif saat ini 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 menggunakan metode projects.locations.operations.get lagi untuk memeriksa apakah update sudah selesai.

Sebelumnya

Mengonfigurasi akses layanan pribadi