

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.

# Migrez des clusters Apache Kafka autres que MSK vers les courtiers Amazon MSK Express
<a name="msk-replicator-migrate-external"></a>

Vous pouvez utiliser MSK Replicator pour migrer les charges de travail Apache Kafka d'environnements autogérés vers des clusters Amazon MSK Provisioned avec des courtiers Express. MSK Replicator prend en charge la migration des données depuis les déploiements Kafka (Kafka version 2.8.1 ou ultérieure) pour lesquels l'authentification est activée. SASL/SCRAM 

**Note**  
SASL/SCRAM l'authentification est requise uniquement pour que MSK Replicator se connecte à votre cluster Kafka autogéré. Vos applications clientes peuvent continuer à utiliser leurs mécanismes d'authentification existants.

**Conditions préalables**  
Avant de commencer, assurez-vous que vous disposez des éléments suivants :

1. Cluster source Apache Kafka exécutant la version 2.8.1 ou ultérieure

1. SASL/SCRAM authentification activée sur le cluster source

1. Chiffrement SSL configuré sur le cluster source

1. Connectivité réseau via AWS Site-to-Site VPN ou AWS Direct Connect

1. Sous-réseaux VPC configurés pour l'accès à Secrets Manager

Pour obtenir des instructions complètes, consultez [Configuration des prérequis pour MSK Replicator avec des clusters Apache Kafka autogérés](msk-replicator-external-prereqs.md).

**Étape 1 : créer un cluster Amazon MSK Express**  
Créez un cluster MSK provisionné avec des courtiers Express avec l'authentification IAM activée. Minimum de trois courtiers répartis sur trois AZ. Consultez [Préparer le cluster cible](msk-replicator-prepare-clusters.md#msk-replicator-prepare-target).

**Étape 2 : Création d'un rôle d'exécution IAM**  
Joignez la stratégie `AWSMSKReplicatorExecutionRole` gérée et configurez la politique de confiance pour`kafka.amazonaws.com`. Ajoutez des autorisations intégrées pour AWS Secrets Manager (et AWS KMS si vos secrets le sont CMK-encrypted) par. [Autorisations SER supplémentaires pour SASL/SCRAM les clés gérées par le client](msk-replicator-ser-additional-perms.md) Consultez [Configuration des prérequis pour MSK Replicator avec des clusters Apache Kafka autogérés](msk-replicator-external-prereqs.md).

**Étape 3 : Configuration SASL/SCRAM et protocole SSL sur un cluster autogéré**  
Créez un utilisateur SCRAM dédié avec les autorisations ACL requises. Configurez les certificats SSL. Consultez [Configuration des prérequis pour MSK Replicator avec des clusters Apache Kafka autogérés](msk-replicator-external-prereqs.md).

**Étape 4 : Stocker les informations d'identification dans AWS Secrets Manager**  
Créez un secret avec `username``password`, et des paires `certificate` clé-valeur. Consultez [Configuration des prérequis pour MSK Replicator avec des clusters Apache Kafka autogérés](msk-replicator-external-prereqs.md).

**Étape 5 : Création du réplicateur**  
Utilisez une `CreateReplicator` API avec une position de `EARLIEST` départ, une réplication de nom de rubrique identique et une `synchroniseConsumerGroupOffsets` valeur définie sur`true`. Le principal IAM qui appelle `CreateReplicator` doit disposer des autorisations d'appelant de l'API décrites dans. [Autorisations IAM requises pour créer un réplicateur MSK](msk-replicator-create-iam-perms.md) Si vous prévoyez de configurer la réplication bidirectionnelle pour la fonctionnalité de restauration (étape 6), configurez également cette option `ENHANCED` sur `consumerGroupOffsetSyncMode` les réplicateurs direct et inverse. Attendez environ 30 minutes pour que le réplicateur atteigne le statut EN COURS D'EXÉCUTION. Consultez [CreateReplicator Exemples d'API pour les clusters Kafka autogérés](msk-replicator-external-api-examples.md).

**Étape 6 : (Facultatif) Configurer la réplication bidirectionnelle**  
Créez un réplicateur inversé à partir du cluster MSK Express vers le cluster autogéré pour des fonctionnalités de restauration. Consultez [CreateReplicator Exemples d'API pour les clusters Kafka autogérés](msk-replicator-external-api-examples.md).

**Étape 7 : suivre la progression de la réplication**  
Surveillez les indicateurs suivants :
+ `MessageLag`(devrait atteindre 0)
+ `ReplicationLatency`
+ `ConsumerGroupOffsetSyncFailure`(devrait être 0)
+ `ConsumerGroupCount`
+ `OffsetLag (MSK Cluster)` et `OffsetLag (Non-MSK Cluster)`

Pour de plus amples informations, veuillez consulter [Surveiller la réplication](msk-replicator-monitor.md).

**Étape 8 : migrer les applications**  
Pour migrer vos applications, procédez comme suit :

1. Empêchez les producteurs d'écrire à un cluster autogéré

1. Reconfigurez les producteurs vers le cluster MSK Express avec l'authentification IAM

1. Surveillez `MessageLag` jusqu'à ce qu'il atteigne 0

1. Empêchez les consommateurs d'accéder à un cluster autogéré

1. Reconfigurer les consommateurs vers le cluster MSK Express

**Étape 9 : (Facultatif) Revenir au cluster autogéré**  
Si la réplication bidirectionnelle a été configurée, vous pouvez inverser les étapes de migration pour revenir au cluster autogéré. Le réplicateur inverse (MSK Express → External) aura maintenu le cluster autogéré synchronisé, afin que les consommateurs puissent être redirigés sans perte de données.