

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

# Configuration de sous-réseaux IPv6 pour les applications EMR Serverless

Avec Amazon EMR Serverless, vous pouvez exécuter vos tâches Apache Spark et Apache Hive via IPv6 dans votre Amazon Virtual Private Cloud (Amazon VPC). Si vous fournissez une pile double (IPv4 et IPv6) ou IPv6-only sous-réseaux, EMR Serverless exécute vos tâches en utilisant le mode d'adressage de ces sous-réseaux. Vos tâches peuvent ensuite atteindre les points de terminaison IPv6 de votre VPC et les points de terminaison IPv6 externes. IPv6-only les sous-réseaux s'exécutent automatiquement via IPv6. Pour les sous-réseaux à double pile, vous activez IPv6 avec une propriété de configuration, comme décrit dans [Configuration des propriétés IPv6](#ipv6-properties).

## Comprendre les principaux avantages
<a name="ipv6-key-benefits"></a>

L'exécution d'applications EMR Serverless via IPv6 offre les avantages suivants.
+ **Espace d'adressage plus grand** — IPv6 fournit un espace d'adressage beaucoup plus important que l'IPv4, ce qui vous permet d'éviter l'épuisement des adresses IPv4 dans les VPC et les sous-réseaux qui exécutent de nombreux travailleurs.
+ **Dual-stack et IPv6-only réseautage** — Exécutez des tâches sur des sous-réseaux à double pile qui utilisent à la fois IPv4 et IPv6, ou sur IPv6-only sous-réseaux, afin de répondre aux normes réseau et aux exigences de conformité qui nécessitent le protocole IPv6.
+ **Connectivité aux terminaux IPv6** — Vos tâches Spark et Hive peuvent atteindre les points de terminaison et les services IPv6 de votre VPC et les points de terminaison IPv6 externes.
+ **Activation flexible** — IPv6-only les sous-réseaux s'exécutent automatiquement via IPv6. Pour les sous-réseaux à double pile, vous activez IPv6 avec une seule propriété de configuration, afin de contrôler quand IPv6 s'applique.

## Comment EMR Serverless détermine le mode d'adressage
<a name="ipv6-addressing-mode"></a>

EMR Serverless détermine le mode d'adressage de votre application à partir des sous-réseaux que vous fournissez.
+ **IPv4-only sous-réseaux** — L'application s'exécute IPv4-only, exactement comme avant. Il n'y a aucun changement de comportement pour les applications existantes.
+ **Dual-stack sous-réseaux** — L'application s'exécute IPv4-only sauf si vous activez IPv6 avec la propriété de configuration décrite dans [Configuration des propriétés IPv6](#ipv6-properties). Lorsque vous activez IPv6, l'application peut utiliser à la fois IPv4 et IPv6.
+ **IPv6-only sous-réseaux** — L'application s'exécute IPv6-only. Ceci est disponible sur toutes les versions.

Lorsque vous fournissez plusieurs sous-réseaux, EMR Serverless exécute l'ensemble de l'application dans le mode d'adressage unique pris en charge par chaque sous-réseau de l'ensemble. Si les sous-réseaux ne partagent aucun mode commun, EMR Serverless rejette la demande. Les cas suivants décrivent les types de sous-réseaux qu'un ensemble peut contenir, quel que soit leur nombre et leur combinaison.
+ **IPv4-only et IPv6-only** — EMR Serverless rejette l'ensemble avec une erreur de validation.
+ **IPv6-only et double pile** — Le set fonctionne IPv6-only, y compris tous les sous-réseaux à double pile de l'ensemble. Assurez-vous que chaque sous-réseau de l'ensemble, y compris tous les sous-réseaux à double pile, répond aux exigences de [Respect des prérequis en matière de VPC et de sous-réseau](#ipv6-prerequisites).
+ **IPv4-only et double pile** — Le set fonctionne IPv4-only, y compris tous les sous-réseaux à double pile de l'ensemble.

EMR Serverless évalue le mode d'adressage à partir des sous-réseaux et de la configuration actuels à chaque démarrage de l'application. Une application en cours d'exécution conserve le mode avec lequel elle a démarré, de sorte qu'une modification ne prend effet qu'au prochain démarrage.

Pour les définitions de IPv4-only, à double pile et IPv6-only sous-réseaux, voir [Sous-réseaux pour votre VPC](https://docs.aws.amazon.com/vpc/latest/userguide/configure-subnets.html) dans le *Guide de l'utilisateur d'Amazon Virtual Private Cloud*.

## Respect des prérequis en matière de VPC et de sous-réseau
<a name="ipv6-prerequisites"></a>

Vous êtes responsable de la configuration de votre VPC et de vos sous-réseaux afin que le trafic IPv6 puisse atteindre vos magasins de données et les AWS services utilisés par vos tâches. Configurez les éléments suivants dans votre propre VPC avant d'exécuter des tâches IPv6.

Utilisez le *Guide de l'utilisateur d'Amazon Virtual Private Cloud* pour les instructions étape par étape.
+ **Associer un IPv6 Classless Inter-Domain Bloc de routage (CIDR) avec le sous-réseau.** Chaque double pile ou IPv6-only le sous-réseau doit avoir un bloc d'adresse CIDR IPv6. Voir [Ajouter ou supprimer un bloc d'adresse CIDR IPv6 de votre sous-réseau](https://docs.aws.amazon.com/vpc/latest/userguide/subnet-associate-ipv6-cidr.html) et [Support IPv6 pour votre VPC](https://docs.aws.amazon.com/vpc/latest/userguide/vpc-migrate-ipv6.html) dans le *Guide de l'utilisateur d'Amazon Virtual Private Cloud*.
+ **Activez l'attribution automatique d'une adresse IPv6 pour le sous-réseau.** Le sous-réseau doit attribuer automatiquement des adresses IPv6 afin que votre application reçoive la connectivité IPv6. Voir [Modifier les attributs d'adressage IP de votre sous-réseau](https://docs.aws.amazon.com/vpc/latest/userguide/subnet-public-ip.html) dans le *Guide de l'utilisateur d'Amazon Virtual Private Cloud*.
+ **Activez DNS64 (DNS-based IPv6-to-IPv4 traduction) sur le sous-réseau et fournissez un chemin NAT64 sortant (traduction d'adresses réseau d'IPv6 vers IPv4) (IPv6-only).** Un IPv6-only l'application en a besoin pour atteindre IPv4-only points de terminaison (par exemple, les services qui ne publient pas encore d'adresse IPv6). Activez DNS64 sur le sous-réseau et acheminez le synthétisé `64:ff9b::/96` trafic via une passerelle NAT, qui exécute NAT64. Une application à double pile peut atteindre IPv4-only se termine via IPv4 et ne l'exige pas. Voir [DNS64 et NAT64](https://docs.aws.amazon.com/vpc/latest/userguide/nat-gateway-nat64-dns64.html) et [passerelles NAT](https://docs.aws.amazon.com/vpc/latest/userguide/vpc-nat-gateway.html) dans le *Guide de l'utilisateur d'Amazon Virtual Private Cloud*.
+ **Fournissez une passerelle Internet de sortie uniquement pour le trafic IPv6 sortant privé.** Pour permettre à un sous-réseau privé d'initier des connexions IPv6 sortantes sans accepter de connexions entrantes depuis Internet, ajoutez une passerelle Internet de sortie uniquement et un `::/0` itinéraire pour y accéder. Voir [Activez le trafic IPv6 sortant à l'aide d'une passerelle Internet de sortie uniquement](https://docs.aws.amazon.com/vpc/latest/userguide/egress-only-internet-gateway.html) dans le *Guide de l'utilisateur d'Amazon Virtual Private Cloud*.
+ **Autorisez le trafic IPv6 sortant dont vos tâches ont besoin dans vos groupes de sécurité.** Les règles de groupe de sécurité EMR Serverless existantes s'appliquent. Pour la configuration générale des VPC et des groupes de sécurité, voir [Configuration de l'accès au VPC pour que les applications EMR Serverless puissent se connecter aux données](vpc-access.md).

## Configuration d'IPv6 pour votre application
<a name="ipv6-configure"></a>

Vous configurez IPv6 lorsque vous créez une application, ou vous le modifiez ultérieurement en mettant à jour une application existante. Dans les deux cas, EMR Serverless dérive le mode d'adressage des sous-réseaux de `--network-configuration`, comme décrit dans [Comment EMR Serverless détermine le mode d'adressage](#ipv6-addressing-mode). Pour les sous-réseaux à double pile, vous activez également IPv6 avec la propriété décrite dans [Configuration des propriétés IPv6](#ipv6-properties); pour IPv6-only sous-réseaux, aucune propriété n'est requise.

### Pour créer une application
<a name="ipv6-create-app"></a>

La procédure suivante crée une application Spark qui utilise des sous-réseaux à double pile et active IPv6. Avant de commencer, assurez-vous que chaque sous-réseau que vous prévoyez d'utiliser répond aux exigences de [Respect des prérequis en matière de VPC et de sous-réseau](#ipv6-prerequisites).

Ce qui suit AWS CLI la commande crée une application Spark avec des sous-réseaux à double pile et active IPv6 :

```bash
aws emr-serverless create-application \
--type SPARK \
--name {{my-application-name}} \
--release-label emr-7.14.0 \
--network-configuration '{
    "subnetIds": ["{{subnet-id-1}}", "{{subnet-id-2}}"],
    "securityGroupIds": ["{{security-group-id}}"]
}' \
--runtime-configuration '[
    {
        "classification": "spark-defaults",
        "properties": {
            "spark.emr-serverless.networking.ipv6.enabled": "true"
        }
    }
]' \
--region {{AWS_REGION}}
```

Remplacez les valeurs suivantes :
+ **`my-application-name`** — Le nom que vous souhaitez donner à votre candidature.
+ **`subnet-id-1`, `subnet-id-2`** — Les ID des sous-réseaux à double pile que vous souhaitez utiliser.
+ **`security-group-id`** — L'ID du groupe de sécurité que vous souhaitez associer.
+ **`AWS_REGION`** — Les Région AWS où vous souhaitez créer l'application.

Sur les sous-réseaux à double pile, la tâche utilise IPv4 par défaut. Pour que Spark préfère IPv6, définissez les propriétés de préférence du moteur décrites dans [Configuration des propriétés IPv6](#ipv6-properties). Pour une application Hive, utilisez `--type HIVE`, le `hive-site` classification, et `hive.emr-serverless.networking.ipv6.enabled` propriété.

**Note**  
Pour IPv6-only sous-réseaux, omettre `--runtime-configuration`. L'application s'exécute automatiquement via IPv6 et vous ne définissez pas les propriétés d'activation ou de préférence du moteur.

### Pour mettre à jour une application existante
<a name="ipv6-update-app"></a>

1. Arrêtez l'application si elle est en cours d'exécution.

1. Mettez à jour l'application pendant qu'elle est dans `CREATED` ou `STOPPED` état. Fournissez les sous-réseaux que vous souhaitez utiliser `--network-configuration`, et pour les sous-réseaux à double pile, incluez la propriété d'activation dans `--runtime-configuration`. Les paramètres que vous n'incluez pas conservent leurs valeurs actuelles.

   Les suivants AWS CLI la commande met à jour l'application avec les nouveaux sous-réseaux et la propriété d'activation :

   ```bash
   aws emr-serverless update-application \
   --application-id {{application-id}} \
   --network-configuration '{
       "subnetIds": ["{{subnet-id-1}}", "{{subnet-id-2}}"],
       "securityGroupIds": ["{{security-group-id}}"]
   }' \
   --runtime-configuration '[
       {
           "classification": "spark-defaults",
           "properties": {
               "spark.emr-serverless.networking.ipv6.enabled": "true"
           }
       }
   ]' \
   --region {{AWS_REGION}}
   ```

   Remplacez les valeurs suivantes :
   + **`application-id`** — L'ID de l'application que vous souhaitez mettre à jour.
   + **`subnet-id-1`, `subnet-id-2`** — Les ID des sous-réseaux que vous souhaitez utiliser.
   + **`security-group-id`** — L'ID du groupe de sécurité que vous souhaitez associer.
   + **`AWS_REGION`** — Les Région AWS de l'application.

1. Démarrez l'application. EMR Serverless applique le mode d'adressage au démarrage.

## Configuration des propriétés IPv6
<a name="ipv6-properties"></a>

Les propriétés suivantes contrôlent le protocole IPv6 pour votre application et vos tâches. Définissez la propriété d'activation au niveau de l'application dans `runtimeConfiguration`. Définissez les propriétés des préférences du moteur au niveau de la tâche, dans `sparkSubmitParameters` pour Spark ou avec `--hiveconf` pour Hive.



| Engine | Propriété | Où vous le configurez | Par défaut | S’applique à | Remarques | 
| --- | --- | --- | --- | --- | --- | 
| Spark | spark.emr-serverless.networking.ipv6.enabled | spark-defaults (demande) runtimeConfiguration) | false | Dual-stack | Active IPv6 sur les sous-réseaux à double pile. | 
| Spark | spark.emr-serverless.driverEnv.SPARK\_PREFER\_IPV6 | sparkSubmitParameters (travail) | false | Dual-stack (facultatif) | Fait en sorte que le pilote Spark préfère IPv6. Activer automatiquement IPv6-only sous-réseaux. Ne pas activer IPv4-only sous-réseaux. | 
| Spark | spark.executorEnv.SPARK\_PREFER\_IPV6 | sparkSubmitParameters (travail) | false | Dual-stack (facultatif) | Fait en sorte que les exécuteurs Spark préfèrent IPv6. Activer automatiquement IPv6-only sous-réseaux. Ne pas activer IPv4-only sous-réseaux. | 
| Hive | hive.emr-serverless.networking.ipv6.enabled | hive-site (demande) runtimeConfiguration) | false | Dual-stack | Identique à la propriété d'activation Spark, pour les applications Hive. | 
| Hive | JAVA\_TOOL\_OPTIONS=-Djava.net.preferIPv6Addresses=true | --hiveconf (travail) | Non défini | Dual-stack (facultatif) | Fait en sorte que Hive préfère IPv6. Activer automatiquement IPv6-only sous-réseaux. Ne pas activer IPv4-only sous-réseaux. | 

Sur les sous-réseaux à double pile, IPv4 et IPv6 sont disponibles et le moteur utilise IPv4 par défaut. Pour que le moteur préfère IPv6, définissez les propriétés de préférence du moteur pour votre moteur. Sur IPv6-only sous-réseaux, EMR Serverless définit la préférence IPv6 pour vous, vous ne définissez donc pas ces propriétés. Sur IPv4-only sous-réseaux, ne définissez pas les propriétés de préférence du moteur ; aucun IPv6 n'est disponible, donc la préférence d'IPv6 entraîne l'échec de la tâche.

L'exemple suivant configure le moteur Spark pour qu'il privilégie le protocole IPv6 dans les tâches `sparkSubmitParameters`.

```
--conf spark.emr-serverless.driverEnv.SPARK_PREFER_IPV6=true
--conf spark.executorEnv.SPARK_PREFER_IPV6=true
```

**Important**  
Ne forcez pas la pile IPv4 dans la JVM (par exemple, en définissant `-Djava.net.preferIPv4Stack=true` dans `spark.driver.extraJavaOptions` ou `spark.executor.extraJavaOptions`) sur n'importe quel mode d'adressage.

Pour plus d'informations sur la déclaration `runtimeConfiguration` au niveau de l'application, voir [Configuration d'application par défaut pour EMR Serverless](https://docs.aws.amazon.com/emr/latest/EMR-Serverless-UserGuide/default-configs.html). Pour plus d'informations sur les configurations de moteurs de dépassement, voir [Utilisation des configurations Spark lorsque vous exécutez des tâches EMR Serverless](https://docs.aws.amazon.com/emr/latest/EMR-Serverless-UserGuide/jobs-spark.html) et [Utilisation des configurations Hive lorsque vous exécutez des tâches EMR Serverless](https://docs.aws.amazon.com/emr/latest/EMR-Serverless-UserGuide/jobs-hive.html).

## Considérations et restrictions
<a name="ipv6-considerations"></a>
+ Le mode d'adressage ne peut pas être défini via l'API. Pour le modifier, modifiez vos sous-réseaux (ou `spark.emr-serverless.networking.ipv6.enabled` propriété opt-in pour les sous-réseaux à double pile) et redémarrez l'application.
+ IPv4-only et IPv6-only les sous-réseaux ne peuvent pas être mélangés dans une seule application.
+ Votre code de tâche et tous les SDK, pilotes ou points de terminaison qu'il utilise doivent prendre en charge IPv6 lors de l'exécution de l'application IPv6-only. Avec EMR Serverless, vous bénéficiez d'une connectivité IPv6 ; elle ne modifie pas le code de votre application ni les points de terminaison tiers.

## Résolution des problèmes
<a name="ipv6-troubleshooting"></a>

Cette rubrique vous aide à diagnostiquer et à résoudre les problèmes de réseau IPv6 courants liés aux applications EMR Serverless, notamment les échecs de résolution DNS, les adresses IPv6 attribuées automatiquement manquantes, l'utilisation inattendue d'IPv4 et les erreurs de validation des sous-réseaux. Voici les symptômes que vous pouvez rencontrer lors de l'exécution de tâches IPv6 et la marche à suivre pour chacun d'entre eux.

### Erreur de résolution DNS (UnknownHostException)
<a name="ipv6-ts-dns"></a>

Cela peut se produire sur IPv6-only application lorsque le sous-réseau ne dispose pas de DNS64 ou d'un chemin sortant NAT64, de sorte que les tâches ne peuvent pas atteindre les points de terminaison dont elles ont besoin. Activez DNS64 et fournissez une passerelle NAT pour NAT64 sur chaque sous-réseau de l'application, comme décrit plus haut dans cette rubrique sous [Respect des prérequis en matière de VPC et de sous-réseau](#ipv6-prerequisites).

### Dual-stack le sous-réseau n'attribue pas automatiquement les adresses IPv6
<a name="ipv6-ts-no-autoassign"></a>

Cela peut se produire lorsqu'un bloc CIDR IPv6 est associé à un sous-réseau mais qu'il n'attribue pas automatiquement d'adresses IPv6, de sorte que l'application ne reçoit pas la connectivité IPv6 qu'elle attend. Activez l'attribution automatique d'une adresse IPv6 pour le sous-réseau, comme décrit plus haut dans cette rubrique, puis démarrez une nouvelle tâche. Le paramètre s'applique uniquement aux ressources créées une fois que vous l'avez modifié.

### La tâche s'exécute sur IPv4 sur une application à double pile
<a name="ipv6-ts-ran-ipv4"></a>

Sur les sous-réseaux à double pile, cela peut se produire pour l'une des deux raisons suivantes. Tout d'abord, vous n'avez pas activé IPv6 avec la propriété de configuration. L'application s'exécute donc IPv4-only. Ensuite, vous avez activé IPv6 mais n'avez pas configuré le moteur pour qu'il le préfère. Le moteur a donc utilisé IPv4. Confirmez à la fois la propriété d'activation et les propriétés de préférence du moteur dans [Configuration des propriétés IPv6](#ipv6-properties).

### Job échoue avec UnresolvedAddressException
<a name="ipv6-ts-unresolved"></a>

Cela peut se produire lorsque la tâche force la pile IPv4 dans la JVM. Supprimer `-Djava.net.preferIPv4Stack=true` (et tout paramètre équivalent) à partir de la configuration de votre tâche, puis soumettez à nouveau la tâche. Consultez [Configuration des propriétés IPv6](#ipv6-properties).

### La demande échoue avec une erreur de validation des sous-réseaux incompatibles
<a name="ipv6-ts-validation"></a>

Cela peut se produire lorsque vous fournissez des sous-réseaux qui ne peuvent pas fonctionner ensemble, tels que IPv4-only sous-réseaux mélangés avec IPv6-only des sous-réseaux, ou le `spark.emr-serverless.networking.ipv6.enabled` propriété opt-in définie sur `true` alors que l'application inclut un IPv4-only sous-réseau. Vérifiez vos sous-réseaux par rapport à [Comment EMR Serverless détermine le mode d'adressage](#ipv6-addressing-mode), ajustez-les ou modifiez la propriété opt-in, puis relancez la demande.