Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
Utilizzo IPv6 con Kinesis Video Streams
È possibile configurare Kinesis Video Streams da utilizzare sia per le operazioni IPv6 sul piano di controllo che sul piano dati. Ciò consente alle applicazioni di comunicare con i IPv6 servizi Kinesis Video Streams utilizzando indirizzi tramite endpoint dual-stack.
Nota
IPv6 il supporto richiede versioni SDK e impostazioni di configurazione specifiche. Assicurati che le versioni SDK e AWS SDK di Kinesis Video Streams supportino gli endpoint dual-stack. IPv6 Gli endpoint dual-stack supportano sia IPv4 il traffico che il traffico e sono disponibili per alcuni servizi in alcune regioni. IPv6
Kinesis Video IPv6 Streams supporta applicazioni per produttori e consumatori tramite endpoint dual-stack. Puoi configurare le tue applicazioni da utilizzare IPv6 per le chiamate API del piano di controllo e le operazioni di streaming del piano dati.
Configura l' AWS SDK per IPv6
Se utilizzi l' AWS SDK per richiamare il APIs piano di controllo di Kinesis Video Streams nella configurazione di produzione, puoi IPv6 abilitarlo configurando gli endpoint dual-stack. L' AWS SDK fornisce diversi metodi standardizzati per abilitare gli endpoint dual-stack.
Importante
Quando gli endpoint dual-stack sono abilitati, l'SDK tenta di utilizzare gli endpoint dual-stack per effettuare richieste di rete. Se non esiste un endpoint dual-stack per il servizio o la regione, la richiesta ha esito negativo.
Usa variabili di ambiente
Imposta la seguente variabile di ambiente per abilitare gli endpoint IPv6 dual-stack:
export AWS_USE_DUALSTACK_ENDPOINT=true
Usa il file di configurazione AWS
Aggiungi la seguente impostazione al tuo file AWS di configurazione (~/.aws/config):
[default] use_dualstack_endpoint = true
Usa le proprietà del sistema JVM (solo Java e SDKs Kotlin)
Per le applicazioni Java e Kotlin, imposta la seguente proprietà di sistema JVM:
-Daws.useDualstackEndpoint=true
O a livello di codice nel tuo codice Java:
System.setProperty("aws.useDualstackEndpoint", "true");
Supporto SDK
Quanto segue AWS SDKs supporta la configurazione degli endpoint dual-stack:
| SDK | Supportata | Metodi di configurazione |
|---|---|---|
| AWS CLI v2 | Sì | Variabile di ambiente, file di configurazione |
| SDK per C++ | Sì | Variabile di ambiente, file di configurazione |
| SDK per Go V2 (1.x) | Sì | Variabile di ambiente, file di configurazione |
| SDK per Java 2.x | Sì | Variabile di ambiente, file di configurazione, proprietà JVM |
| SDK per Java 1.x | No | Non supportata |
| SDK per 3.x JavaScript | Sì | Variabile di ambiente, file di configurazione |
| SDK per Python (Boto3) | Sì | Variabile di ambiente, file di configurazione |
Dopo aver configurato gli endpoint dual-stack, l' AWS SDK utilizza automaticamente gli endpoint quando chiama il piano di controllo di IPv6 Kinesis Video Streams. APIs
Configurare l'SDK di Kinesis Video Streams Producer per IPv6
L' IPv6 SDK di Kinesis Video Streams Producer offre opzioni di configurazione per le operazioni sul piano di controllo e sul piano dati. Queste impostazioni funzionano con la configurazione degli endpoint AWS dual-stack SDK.
Configura l'SDK C/C++ Producer
Gli endpoint e la catena di risoluzione DNS predefiniti sono implementati dalla versione 1.6.0 di KVS Producer-C SDK. Controlla in sequenza ogni posizione in cui è possibile impostare la configurazione per questi parametri, quindi seleziona la prima che imposti. La sequenza predefinita è la seguente:
Per ulteriori informazioni su Producer SDKs, consulta gli argomenti correlati a Producer SDK for C
Configurazione degli endpoint
-
Il
controlPlaneUrlparametro percreateAbstractDefaultCallbacksProvider. -
CMake Parametri di configurazione dell'endpoint: (
-DAWS_KVS_USE_LEGACY_ENDPOINT_ONLY=TRUE,-DAWS_KVS_USE_DUAL_STACK_ENDPOINT_ONLY=TRUE) -
Variabili di ambiente: ()
export AWS_USE_DUALSTACK_ENDPOINT=TRUE-
Se
AWS_USE_DUALSTACK_ENDPOINTèTRUE(senza distinzione tra maiuscole e minuscole), verrà utilizzato l'endpoint dual-stack.
-
-
In caso contrario, l'endpoint precedente verrà costruito e utilizzato.
Con 2, 3 e 4, l'endpoint verrà costruito in base alla regione fornita. createAbstractDefaultCallbacksProvider
Filtraggio DNS
KVS Producer SDK imposterà il CURLOPT_IPRESOLVE parametro appropriato in base alla configurazione:
-
CMake Parametri di risoluzione DNS: (
-DAWS_KVS_IPV4_ONLY=TRUE,,)-DAWS_KVS_IPV6_ONLY=TRUE-DAWS_KVS_IPV4_AND_IPV6_ONLY=TRUE -
Variabili di ambiente (
export AWS_KVS_USE_IPV4=TRUE,export AWS_KVS_USE_IPV6=TRUE) -
In caso contrario, non verrà eseguito alcun filtraggio. È possibile IPv4 utilizzare sia gli indirizzi IPv6 IP che gli indirizzi IP, se restituiti dal DNS.
Nota
Se le impostazioni del filtro DNS sono impostate per filtrare gli indirizzi IPV6 IP, ma la configurazione SDK prevede l'utilizzo dell'endpoint legacy (restituisce IPV4 solo indirizzi), la richiesta avrà esito negativo.
La versione 3.5.0 di C++ Producer-C SDK utilizza Producer-C SDK 1.6.0 per le chiamate API KVS.
GStreamer Configura il plugin
Il GStreamer plug-in utilizza il C Producer SDK sottostante, quindi la IPv6 configurazione viene gestita automaticamente quando si configura C SDK per IPv6 come descritto in precedenza.
Non è necessario modificare il codice, è sufficiente creare l'SDK con CMake i parametri o impostare le variabili di ambiente appropriate come descritto nella sezione precedente.
Risoluzione degli endpoint del piano dati
Per le operazioni sul piano dati, utilizza l'GetDataEndpointAPI per recuperare l'endpoint del piano dati dual-stack appropriato. Il servizio restituisce l'endpoint corrispondente in base all'URL della richiesta.
Esempio:
-
Se la richiesta
GetDataEndpointAPI viene effettuata all'endpoint legacy che termina con.amazonaws.com, Kinesis Video Streams restituirà gli endpoint del piano dati legacy che terminano con..amazonaws.com -
Se la richiesta
GetDataEndpointAPI viene effettuata all'endpoint dual-stack che termina con, Kinesis.api.awsVideo Streams restituirà l'endpoint del piano dati dual-stack che termina con..api.aws
Configura il modulo AWS CLI IPv6
Se utilizzi le operazioni AWS CLI per Kinesis Video Streams (in proof-of-concept genere per lavoro), IPv6 puoi abilitarle configurando gli endpoint dual-stack.
Usa una variabile di ambiente
export AWS_USE_DUALSTACK_ENDPOINT=true
Usa il file AWS di configurazione
Aggiungi quanto segue al tuo file AWS CLI di configurazione (~/.aws/config):
[default] use_dualstack_endpoint = true
Esempi di configurazione
Esempio di SDK C
Per creare l'SDK KVS Producer-C in modalità IPV6 -only e ignorare la configurazione delle variabili d'ambiente, usa i seguenti comandi per creare l'SDK:
cmake .. -DAWS_KVS_USE_DUAL_STACK_ENDPOINT_ONLY=TRUE -DAWS_KVS_IPV6_ONLY=TRUE make -j
Nota
Se hai già installato l'SDK, dovrai eseguire una build pulita. Elimina le cartelle di build, open source e dependency esistenti prima di eseguire i comandi di build.
Considerazioni
Requisiti di rete
-
Assicurati che la tua infrastruttura di rete supporti la connettività IPv6
-
Verifica che i gruppi di sicurezza e la rete ACLs consentano IPv6 il traffico
-
Verifica la connettività agli AWS IPv6 endpoint dal tuo ambiente di distribuzione
-
Gli endpoint dual-stack sono disponibili per alcuni servizi in alcune regioni: verifica la disponibilità per le aree di destinazione
Compatibilità SDK
-
Assicurati di utilizzare una versione AWS SDK supportata
-
L' AWS SDK for Java 1.x non supporta la configurazione degli endpoint dual-stack
-
Per l'SDK for Go 1.x (V1), è necessario abilitare il caricamento dal file di configurazione per utilizzare le impostazioni condivise del file di configurazione
Test e convalida
Prima di distribuire applicazioni Kinesis Video Streams IPv6 abilitate alla produzione:
-
Verifica le operazioni del piano di controllo (creazione, eliminazione, elenco dei flussi)
-
Verifica il funzionamento del piano dati (ingestione e consumo di video)
-
Convalida le prestazioni e la connettività nel tuo ambiente di rete
-
Esegui i test Canary per garantire funzionalità costanti IPv6
-
Verifica il comportamento di failover quando gli endpoint dual-stack non sono disponibili
I clienti interessati dall'aggiornamento includono IPv6
Quando IPv6 abiliti Kinesis Video Streams, ci sono diverse aree in cui potresti dover aggiornare le configurazioni e le politiche esistenti per garantire la continuità della funzionalità.
Policy IAM e filtraggio degli indirizzi IP
Se utilizzi il filtraggio degli indirizzi IP di origine nelle politiche degli utenti, delle politiche dei ruoli o delle politiche basate sulle risorse IAM, devi aggiornare queste politiche per includere gli intervalli di indirizzi. IPv6
Importante
Le policy IAM esistenti che utilizzano blocchi IPv4 CIDR in IpAddress o NotIpAddress condizioni non funzioneranno automaticamente con gli indirizzi. IPv6 È necessario aggiungere esplicitamente IPv6 intervalli per mantenere il controllo degli accessi.
Esempio di aggiornamento della policy IAM per 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" ] } } } ] }
Registrazione di log e monitoraggio
IPv6 gli indirizzi hanno un formato diverso dagli IPv4 indirizzi, il che può influire sui sistemi di registrazione, monitoraggio e analisi.
log
i registri conterranno IPv6 gli indirizzi nel sourceIPAddress campo quando le richieste vengono inoltrate. IPv6 Aggiorna gli strumenti e gli script di analisi dei log per gestire IPv6 i formati degli indirizzi.
Esempio di IPv6 indirizzo nei log:
{ "sourceIPAddress": "2001:db8::1", "eventName": "CreateStream", "eventSource": "kinesisvideo.amazonaws.com" }
Risoluzione dei problemi
Problemi comuni
-
Errori di connessione: verifica della connettività di IPv6 rete e della risoluzione DNS
-
Errori SDK: assicurati di utilizzare versioni SDK compatibili che supportano endpoint dual-stack
-
Problemi di autenticazione: conferma che le policy e le credenziali IAM funzionino con gli endpoint IPv6
-
Endpoint non disponibile: se non esiste un endpoint dual-stack per il servizio o la regione, le richieste hanno esito negativo
Fasi di verifica
-
Verifica che
AWS_USE_DUALSTACK_ENDPOINT=truesia impostato ouse_dualstack_endpoint = truesia presente nel tuo file di configurazione -
Verifica che i flag di configurazione di Kinesis Video IPv6 Streams SDK siano impostati correttamente
-
Verifica la connettività di rete con gli endpoint AWS IPv6
-
Esamina i registri delle applicazioni per verificare la presenza di messaggi di IPv6 errore specifici
-
Verifica che la tua regione supporti gli endpoint dual-stack per Kinesis Video Streams
Convalida della configurazione
Puoi verificare la configurazione dell'endpoint dual-stack controllando:
-
Variabili di ambiente:
echo $AWS_USE_DUALSTACK_ENDPOINT -
AWS file di configurazione:
cat ~/.aws/config | grep use_dualstack_endpoint -
Proprietà JVM (Java): verifica le proprietà del sistema nei registri delle applicazioni