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 para usar IPv6 nas operações do plano de controle e do plano de dados. Isso permite que seus aplicativos se comuniquem com os serviços do Kinesis Video Streams usando endereços IPv6 por meio de endpoints de pilha dupla.

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

Configurar o AWS SDK para IPv6

Se você estiver usando o AWS SDK para chamar as APIs do plano de controle do Kinesis Video Streams em sua configuração de produção, você pode habilitar o IPv6 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 habilitar endpoints IPv6 de pilha dupla:

export AWS_USE_DUALSTACK_ENDPOINT=true

Use o comando AWS Arquivo de configuração do  

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 SDKs Java e 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 seguintes 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 IPv6 ao chamar as APIs do plano de controle do Kinesis Video Streams.

Configurar o SDK do Kinesis Video Streams Producer para IPv6

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

Configurar o SDK do C/C ++ Producer

Os endpoints padrão e a cadeia de resolução de DNS são implementados pelo KVS Producer-C SDK 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 os SDKs do Produtor, consulte os tópicos relacionados ao SDK do Produtor para C, SDK do Produtor para C++ e SDK do Produtor.

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 plugin GStreamer

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

Não é necessário modificar o código, basta criar o SDK com os parâmetros do CMake 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:

Configurar o AWS CLI para IPv6

Se você estiver usando as operações do Kinesis Video Streams (normalmente AWS CLI para trabalhos de prova de conceito), você pode habilitar o IPv6 configurando endpoints de pilha dupla.

Usar uma variável de ambiente

export AWS_USE_DUALSTACK_ENDPOINT=true

Use o comando AWS Arquivo de configuração do  

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 Producer-C SDK do KVS no IPV6-only modo 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 os aplicativos do IPv6-enabled Kinesis Video Streams na produção:

Clientes afetados pela atualização para inclusão de IPv6

Quando você ativa o IPv6 para o 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 intervalos de endereços IPv6.

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

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

logs

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

Exemplo de endereço IPv6 em 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: