Configure um conjunto privado

O processamento de uma stream em direto requer a gestão de vários componentes que executam tarefas como carregamento, transcodificação e multiplexagem. A API Live Stream gere estes componentes e recursos internamente através de pools. Um conjunto é uma unidade de processamento atribuída a cada Google Cloud projeto por região e é partilhada entre todos os canais numa determinada região.

Por predefinição, quando cria um recurso Input, é-lhe atribuído um URI de ponto final que contém um endereço IP público para o qual pode enviar as suas streams de entrada. Quer faça streaming a partir de uma rede no local ou de uma rede de nuvem virtual privada (VPC), os dados atravessam a Internet pública para alcançar o ponto final do serviço de stream em direto. Google Cloud

Em alternativa, pode configurar o acesso privado aos serviços para o serviço de stream em direto. O acesso a serviços privados é uma ligação privada e segura entre a sua rede de nuvem virtual privada (VPC) e os serviços geridos pela Google ou de terceiros.Google Cloud Esta ligação permite que as instâncias de VM na sua rede VPC comuniquem com estes serviços através de endereços IP internos, sem expor o tráfego à Internet pública. Quando ativa o acesso a serviços privados na API Live Stream, é reservado um endereço IP interno da sua rede VPC para ser usado como o ponto final de entrada. Isto tem as seguintes vantagens:

• Segurança melhorada: o acesso a serviços privados permite-lhe estabelecer ligação a pontos finais de entrada da API Live Stream sem expor o seu tráfego à Internet pública. Isto pode ajudar a melhorar a sua postura de segurança e reduzir o risco de uma violação de dados.
• Maior desempenho: o acesso a serviços privados pode melhorar o desempenho das suas ligações, evitando a Internet pública. Isto pode ser especialmente benéfico para alcançar uma latência mais baixa e um débito mais elevado.

Também pode sincronizar o acesso privado a serviços com o Cloud Interconnect ou a Cloud VPN para fornecer uma ligação privada ponto a ponto entre a sua rede no local e o serviço de stream em direto.

Antes de começar

Para configurar um conjunto privado, conclua os seguintes pré-requisitos:

• Tem de ter uma rede VPC existente que possa usar para se ligar à rede do produtor do serviço. As instâncias de VM têm de usar esta rede VPC para estabelecer ligação a serviços através de uma ligação privada.
• Tem de configurar o acesso a serviços privados na rede VPC.
• Todos os canais na região têm de ser parados. Caso contrário, a API Live Stream rejeita o pedido de atualização da rede com peering do conjunto.
• Não é possível iniciar todos os canais na região enquanto o conjunto estiver a ser atualizado.

Configure um conjunto privado

1. Certifique-se de que já foi criado um conjunto predefinido. O conjunto predefinido de uma localização é criado quando cria o primeiro recurso Input.

   Antes de usar qualquer um dos dados do pedido, faça as seguintes substituições:

   • PROJECT_NUMBER: o número do seu Google Cloud projeto. Este encontra-se no campo Número do projeto na página Definições do IAM
   • LOCATION: use uma das regiões suportadas nas quais já criou uma entrada
     Mostrar localizações
     • 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

   Para enviar o seu pedido, expanda uma destas opções:

   curl (Linux, macOS ou Cloud Shell)

   Nota: O comando seguinte pressupõe que tem sessão iniciada na CLI gcloud com a sua conta de utilizador executando gcloud init ou gcloud auth login, ou usando o Cloud Shell, que inicia automaticamente sessão na CLI gcloud. Pode verificar a conta atualmente ativa executando o comando gcloud auth list.

   Execute o seguinte comando:

   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)

   Nota: O comando seguinte pressupõe que iniciou sessão na CLI do Google Cloud com a sua conta de utilizador executando gcloud init ou gcloud auth login .gcloud Pode verificar a conta atualmente ativa executando o comando gcloud auth list.

   Execute o seguinte comando:

   $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

   Deve receber uma resposta JSON semelhante à seguinte:

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

2. Atualize o conjunto com o nome da rede em peering.

   Antes de usar qualquer um dos dados do pedido, faça as seguintes substituições:

   • PROJECT_NUMBER: o número do seu Google Cloud projeto. Este encontra-se no campo Número do projeto na página Definições do IAM
   • LOCATION: a localização do pool predefinido; use uma das regiões suportadas
     Mostrar localizações
     • 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: o identificador definido pelo utilizador para a rede no projeto atual para estabelecer uma relação de interligação com o serviço

   Para enviar o seu pedido, expanda uma destas opções:

   curl (Linux, macOS ou Cloud Shell)

   Nota: O comando seguinte pressupõe que tem sessão iniciada na CLI gcloud com a sua conta de utilizador executando gcloud init ou gcloud auth login, ou usando o Cloud Shell, que inicia automaticamente sessão na CLI gcloud. Pode verificar a conta atualmente ativa executando o comando gcloud auth list.

   Guarde o corpo do pedido num ficheiro denominado request.json. Execute o seguinte comando no terminal para criar ou substituir este ficheiro no diretório atual:

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

   Em seguida, execute o seguinte comando para enviar o seu pedido REST:

   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)

   Nota: O comando seguinte pressupõe que iniciou sessão na CLI do Google Cloud com a sua conta de utilizador executando gcloud init ou gcloud auth login .gcloud Pode verificar a conta atualmente ativa executando o comando gcloud auth list.

   Guarde o corpo do pedido num ficheiro denominado request.json. Execute o seguinte comando no terminal para criar ou substituir este ficheiro no diretório atual:

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

   Em seguida, execute o seguinte comando para enviar o seu pedido REST:

   $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

   Deve receber uma resposta JSON semelhante à seguinte:

   {
     "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
   }
   

   O pedido inicia uma operação de longa duração. Copie o OPERATION_ID devolvido para usar no passo seguinte.

3. Use o método projects.locations.operations.get para verificar se a atualização foi concluída. A atualização do conjunto pode demorar até 30 minutos. Se a resposta contiver "done: false", repita o pedido até que a resposta contenha "done: true".

   Antes de usar qualquer um dos dados do pedido, faça as seguintes substituições:

   • PROJECT_NUMBER: o número do seu Google Cloud projeto. Este encontra-se no campo Número do projeto na página Definições do IAM
   • LOCATION: a localização onde o seu recurso está localizado; use uma das regiões suportadas
     Mostrar localizações
     • 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: o identificador da operação

   Para enviar o seu pedido, expanda uma destas opções:

   curl (Linux, macOS ou Cloud Shell)

   Nota: O comando seguinte pressupõe que tem sessão iniciada na CLI gcloud com a sua conta de utilizador executando gcloud init ou gcloud auth login, ou usando o Cloud Shell, que inicia automaticamente sessão na CLI gcloud. Pode verificar a conta atualmente ativa executando o comando gcloud auth list.

   Execute o seguinte comando:

   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)

   Nota: O comando seguinte pressupõe que iniciou sessão na CLI do Google Cloud com a sua conta de utilizador executando gcloud init ou gcloud auth login .gcloud Pode verificar a conta atualmente ativa executando o comando gcloud auth list.

   Execute o seguinte comando:

   $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

   Deve receber uma resposta JSON semelhante à seguinte:

   {
     "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"
       }
     }
   

Após a atualização, todos os URIs dos pontos finais de entrada existentes (e futuros) na região são endereços IP internos reservados da rede VPC fornecida. Liste os pontos finais de entrada para ver os URIs atualizados.

Nota: após uma atualização, o início do primeiro canal numa região demora mais tempo do que o habitual.

Mudar para o conjunto público

Para reverter para o conjunto público, forneça uma string vazia como o nome da rede com peering no pedido de atualização do conjunto.

Antes de usar qualquer um dos dados do pedido, faça as seguintes substituições:

• PROJECT_NUMBER: o número do seu Google Cloud projeto. Este encontra-se no campo Número do projeto na página Definições do IAM
• LOCATION: a localização do pool predefinido; use uma das regiões suportadas
  Mostrar localizações
  • 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

Para enviar o seu pedido, expanda uma destas opções:

curl (Linux, macOS ou Cloud Shell)

Nota: O comando seguinte pressupõe que tem sessão iniciada na CLI gcloud com a sua conta de utilizador executando gcloud init ou gcloud auth login, ou usando o Cloud Shell, que inicia automaticamente sessão na CLI gcloud. Pode verificar a conta atualmente ativa executando o comando gcloud auth list.

Guarde o corpo do pedido num ficheiro denominado request.json. Execute o seguinte comando no terminal para criar ou substituir este ficheiro no diretório atual:

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

Em seguida, execute o seguinte comando para enviar o seu pedido REST:

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)

Nota: O comando seguinte pressupõe que iniciou sessão na CLI do Google Cloud com a sua conta de utilizador executando gcloud init ou gcloud auth login .gcloud Pode verificar a conta atualmente ativa executando o comando gcloud auth list.

Guarde o corpo do pedido num ficheiro denominado request.json. Execute o seguinte comando no terminal para criar ou substituir este ficheiro no diretório atual:

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

Em seguida, execute o seguinte comando para enviar o seu pedido REST:

$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

Deve receber uma resposta JSON semelhante à seguinte:

{
  "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
}

Pode usar novamente o método projects.locations.operations.get para verificar se a atualização foi concluída.

Nota: após uma atualização, o início do primeiro canal numa região demora mais tempo do que o habitual.