As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Use IPv6 com o Kinesis Video Streams

Você pode configurar o Kinesis Video Streams IPv6 para ser usado nas operações do plano de controle e do plano de dados. Isso permite que seus aplicativos se comuniquem com os IPv6 serviços do Kinesis Video Streams usando endereços por meio de endpoints de pilha dupla.

O Kinesis Video IPv6 Streams oferece suporte por meio de endpoints de pilha dupla para aplicativos de produtores e consumidores. Você pode configurar seus aplicativos IPv6 para uso em chamadas de API do plano de controle e operações de streaming do plano de dados.

Configure o AWS SDK para IPv6

Se você estiver usando o AWS SDK para chamar o APIs plano de controle do Kinesis Video Streams em sua configuração de produção, você pode IPv6 habilitá-lo configurando endpoints de pilha dupla. O AWS SDK fornece vários métodos padronizados para habilitar endpoints de pilha dupla.

Use variáveis de ambiente

Defina a seguinte variável de ambiente para ativar endpoints de IPv6 pilha dupla:

export AWS_USE_DUALSTACK_ENDPOINT=true

Use o arquivo AWS de configuração

Adicione a seguinte configuração ao seu arquivo AWS de configuração (~/.aws/config):

[default]
use_dualstack_endpoint = true

Use as propriedades do sistema JVM (somente Java e SDKs Kotlin)

Para aplicativos Java e Kotlin, defina a seguinte propriedade do sistema JVM:

-Daws.useDualstackEndpoint=true

Ou programaticamente em seu código Java:

System.setProperty("aws.useDualstackEndpoint", "true");

Compatibilidade com o SDK

Os itens a seguir AWS SDKs oferecem suporte à configuração de endpoint de pilha dupla:

Depois de configurar os endpoints de pilha dupla, o AWS SDK usa automaticamente os endpoints ao chamar o plano de controle do IPv6 Kinesis Video Streams. APIs

Configure o SDK do Kinesis Video Streams Producer para IPv6

O IPv6 SDK do Kinesis Video Streams Producer fornece opções de configuração para operações do plano de controle e do plano de dados. Essas configurações funcionam com a configuração de endpoint de AWS pilha dupla do SDK.

Configurar o SDK do Produtor C/C++

Os endpoints padrão e a cadeia de resolução de DNS são implementados pelo SDK KVS Producer-C versão 1.6.0. Ele verifica sequencialmente cada local onde você pode definir a configuração desses parâmetros e, em seguida, seleciona o primeiro que você definir. A sequência predefinida é a seguinte:

Para obter mais informações sobre o Producer SDKs, consulte os tópicos relacionados ao Producer SDK for C, Producer SDK for C++ e Producer SDK.

Configuração do endpoint

Com 2, 3 e 4, o endpoint será construído com base na região fornecida. createAbstractDefaultCallbacksProvider

Filtragem de DNS

O SDK do KVS Producer definirá o CURLOPT_IPRESOLVE parâmetro apropriado, dependendo da configuração:

O C++ Producer SDK versão 3.5.0 usa o Producer-C SDK 1.6.0 para as chamadas da API KVS.

Configurar o GStreamer plug-in

O GStreamer plug-in usa o SDK do C Producer subjacente, portanto, a IPv6 configuração é feita automaticamente quando você configura o SDK C IPv6 conforme descrito anteriormente.

Não é necessário modificar o código, basta criar o SDK com CMake os parâmetros ou definir as variáveis de ambiente apropriadas conforme descrito na seção anterior.

Resolução do endpoint do plano de dados

Para operações de plano de dados, use a GetDataEndpoint API para recuperar o endpoint apropriado do plano de dados de pilha dupla. O serviço retorna o endpoint correspondente, dependendo da URL da solicitação.

Exemplo:

Configure o AWS CLI para IPv6

Se você estiver usando as operações do Kinesis Video Streams ( proof-of-conceptnormalmente AWS CLI para trabalhar), você IPv6 pode habilitá-las configurando endpoints de pilha dupla.

Usar uma variável de ambiente

export AWS_USE_DUALSTACK_ENDPOINT=true

Use o arquivo AWS de configuração

Adicione o seguinte ao seu arquivo AWS CLI de configuração (~/.aws/config):

[default]
use_dualstack_endpoint = true

Exemplos de configuração

Exemplo de SDK C

Para criar o SDK do KVS Producer-C no modo IPV6 -only e ignorar a configuração da variável de ambiente, use os seguintes comandos para criar o SDK:

cmake .. -DAWS_KVS_USE_DUAL_STACK_ENDPOINT_ONLY=TRUE -DAWS_KVS_IPV6_ONLY=TRUE
make -j

Considerações

Requisitos de rede

Compatibilidade com SDK

Testes e validação

Antes de implantar aplicativos IPv6 habilitados do Kinesis Video Streams na produção:

Clientes afetados pela atualização para incluir IPv6

Quando você habilita o IPv6 Kinesis Video Streams, há várias áreas em que talvez seja necessário atualizar suas configurações e políticas existentes para garantir a funcionalidade contínua.

Políticas do IAM e filtragem de endereços IP

Se você usa a filtragem de endereço IP de origem em suas políticas de usuário, políticas de função ou políticas baseadas em recursos do IAM, precisará atualizar essas políticas para incluir IPv6 intervalos de endereços.

Exemplo de atualização da política do IAM para IPv6:

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Principal": "*",
      "Action": "kinesisvideo:*",
      "Resource": "*",
      "Condition": {
        "IpAddress": {
          "aws:SourceIp": [
            "192.0.2.0/24",
            "203.0.113.0/24",
            "2001:db8::/32"
          ]
        }
      }
    }
  ]
}

Registro em log e monitoramento

IPv6 os endereços têm um formato diferente IPv4 dos endereços, o que pode afetar seus sistemas de registro, monitoramento e análise.

logs

os registros conterão IPv6 endereços no sourceIPAddress campo quando as solicitações forem feitas IPv6. Atualize suas ferramentas e scripts de análise de registros para lidar com formatos IPv6 de endereço.

Exemplo IPv6 de endereço nos registros:

{
  "sourceIPAddress": "2001:db8::1",
  "eventName": "CreateStream",
  "eventSource": "kinesisvideo.amazonaws.com"
}

Solução de problemas

Problemas comuns

Etapas de verificação

Validação de configuração

Você pode verificar sua configuração de endpoint de pilha dupla verificando: