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.
# Gestion des métadonnées
Amazon MSK prend en charge les modes Apache ZooKeeper ou de gestion des KRaft métadonnées.
À partir de la version 3.7.x d'Apache Kafka sur Amazon MSK, vous pouvez créer des clusters qui utilisent le mode plutôt que KRaft le mode. ZooKeeper KRaftles clusters basés sur les contrôleurs de Kafka s'appuient sur des contrôleurs pour gérer les métadonnées.
**Topics**
+ [ZooKeeper mode](#msk-get-connection-string)
+ [KRaft mode](#kraft-intro)
## ZooKeeper mode
[Apache ZooKeeper](https://zookeeper.apache.org/) est « un service centralisé permettant de gérer les informations de configuration, de nommer, de fournir une synchronisation distribuée et de fournir des services de groupe. Tous ces types de services sont utilisés sous une forme ou une autre par des applications distribuées », notamment Apache Kafka.
Si votre cluster utilise le ZooKeeper mode, vous pouvez suivre les étapes ci-dessous pour obtenir la chaîne de ZooKeeper connexion Apache. Cependant, nous vous recommandons d'utiliser le `BootstrapServerString` pour vous connecter à votre cluster et effectuer des opérations d'administration, car l'`--zookeeper`indicateur est obsolète dans Kafka 2.5 et a été supprimé dans Kafka 3.0.
### Obtenir la chaîne de ZooKeeper connexion Apache à l'aide du AWS Management Console
1. Ouvrez la console Amazon MSK à l'adresse [https://console.aws.amazon.com/msk/](https://console.aws.amazon.com/msk/).
1. Le tableau présente tous les clusters de la région actuelle sous ce compte. Choisissez le nom d'un cluster pour afficher sa description.
1. Sur la page de **résumé du cluster**, choisissez **Voir les informations client**. Cela vous montre les courtiers bootstrap, ainsi que la chaîne de ZooKeeper connexion Apache.
### Obtenir la chaîne de ZooKeeper connexion Apache à l'aide du AWS CLI
1. Si vous ne connaissez pas le nom Amazon Resource Name (ARN) de votre cluster, vous pouvez le trouver en listant tous les clusters de votre compte. Pour de plus amples informations, veuillez consulter [Répertorier les clusters Amazon MSK](msk-list-clusters.md).
1. Pour obtenir la chaîne de ZooKeeper connexion Apache, ainsi que d'autres informations sur votre cluster, exécutez la commande suivante, en la *ClusterArn* remplaçant par l'ARN de votre cluster.
```
aws kafka describe-cluster --cluster-arn ClusterArn
```
La sortie de cette commande `describe-cluster` ressemble à l'exemple JSON suivant.
```
{
"ClusterInfo": {
"BrokerNodeGroupInfo": {
"BrokerAZDistribution": "DEFAULT",
"ClientSubnets": [
"subnet-0123456789abcdef0",
"subnet-2468013579abcdef1",
"subnet-1357902468abcdef2"
],
"InstanceType": "kafka.m5.large",
"StorageInfo": {
"EbsStorageInfo": {
"VolumeSize": 1000
}
}
},
"ClusterArn": "arn:aws:kafka:us-east-1:111122223333:cluster/testcluster/12345678-abcd-4567-2345-abcdef123456-2",
"ClusterName": "testcluster",
"CreationTime": "2018-12-02T17:38:36.75Z",
"CurrentBrokerSoftwareInfo": {
"KafkaVersion": "2.2.1"
},
"CurrentVersion": "K13V1IB3VIYZZH",
"EncryptionInfo": {
"EncryptionAtRest": {
"DataVolumeKMSKeyId": "arn:aws:kms:us-east-1:555555555555:key/12345678-abcd-2345-ef01-abcdef123456"
}
},
"EnhancedMonitoring": "DEFAULT",
"NumberOfBrokerNodes": 3,
"State": "ACTIVE",
"ZookeeperConnectString": "10.0.1.101:2018,10.0.2.101:2018,10.0.3.101:2018"
}
}
```
L'exemple JSON précédent montre la clé `ZookeeperConnectString` dans la sortie de la commande `describe-cluster`. Copiez la valeur correspondant à cette clé et enregistrez-la pour pouvoir la réutiliser lorsque vous devrez créer une rubrique sur votre cluster.
**Important**
Votre cluster Amazon MSK doit être en bon `ACTIVE` état pour que vous puissiez obtenir la chaîne de ZooKeeper connexion Apache. Lorsqu'un cluster a toujours l'état `CREATING`, la sortie de la commande `describe-cluster` n'inclut pas `ZookeeperConnectString`. Si c'est le cas, attendez quelques minutes, puis exécutez à nouveau `describe-cluster` après que votre cluster a atteint l'état `ACTIVE`.
### Obtenir la chaîne de ZooKeeper connexion Apache à l'aide de l'API
Pour obtenir la chaîne de ZooKeeper connexion Apache à l'aide de l'API, consultez [DescribeCluster](https://docs.aws.amazon.com//msk/1.0/apireference/clusters-clusterarn.html#DescribeCluster).
## KRaft mode
Amazon MSK a introduit la prise en charge de KRaft (Apache Kafka Raft) dans la version 3.7.x de Kafka. La communauté Apache Kafka a été développée KRaft pour remplacer [Apache ZooKeeper](#msk-get-connection-string) pour la gestion des métadonnées dans les clusters Apache Kafka. En KRaft mode, les métadonnées du cluster sont propagées au sein d'un groupe de contrôleurs Kafka, qui font partie du cluster Kafka, plutôt qu'entre les nœuds. ZooKeeper KRaftles manettes sont incluses sans frais supplémentaires pour vous et ne nécessitent aucune configuration ou gestion supplémentaire de votre part. Voir [KIP-500](https://cwiki.apache.org/confluence/display/KAFKA/KIP-500%3A+Replace+ZooKeeper+with+a+Self-Managed+Metadata+Quorum) pour plus d'informations sur. KRaft
Voici quelques points à noter concernant le KRaft mode sur MSK :
+ KRaft le mode n'est disponible que pour les nouveaux clusters. Vous ne pouvez pas changer de mode de métadonnées une fois le cluster créé.
+ Sur la console MSK, vous pouvez créer un cluster basé sur Kraft en choisissant Kafka version 3.7.x et en cochant la case dans la fenêtre de création du KRaft cluster.
+ Pour créer un cluster en KRaft mode à l'aide de l'API [https://docs.aws.amazon.com/msk/1.0/apireference/clusters.html#CreateCluster](https://docs.aws.amazon.com/msk/1.0/apireference/clusters.html#CreateCluster)ou [https://docs.aws.amazon.com/MSK/2.0/APIReference/v2-clusters.html#CreateClusterV2](https://docs.aws.amazon.com/MSK/2.0/APIReference/v2-clusters.html#CreateClusterV2)des opérations MSK, vous devez utiliser `3.7.x.kraft` comme version. À utiliser `3.7.x` comme version pour créer un cluster en ZooKeeper mode.
+ Le nombre de partitions par broker est le même sur les clusters KRaft et ZooKeeper basés sur ceux-ci. KRaft Cela vous permet toutefois d'héberger davantage de partitions par cluster en provisionnant [davantage de courtiers dans un cluster](https://docs.aws.amazon.com/msk/latest/developerguide/limits.html).
+ Aucune modification d'API n'est requise pour utiliser le KRaft mode sur Amazon MSK. Toutefois, si vos clients utilisent toujours la chaîne de `--zookeeper` connexion aujourd'hui, vous devez mettre à jour vos clients afin qu'ils utilisent la chaîne de `--bootstrap-server` connexion pour se connecter à votre cluster. L'`--zookeeper`indicateur est obsolète dans la version 2.5 d'Apache Kafka et est supprimé à partir de la version 3.0 de Kafka. Nous vous recommandons donc d'utiliser les versions récentes du client Apache Kafka et la chaîne de `--bootstrap-server` connexion pour toutes les connexions à votre cluster.
+ ZooKeeper le mode continue d'être disponible pour toutes les versions publiées où zookeeper est également pris en charge par Apache Kafka. Consultez [Versions Apache Kafka prises en charge](supported-kafka-versions.md) pour plus de détails sur la fin du support pour les versions d'Apache Kafka et les futures mises à jour.
+ Vous devez vérifier que tous les outils que vous utilisez sont capables d'utiliser Kafka Admin APIs sans ZooKeeper connexion. Reportez-vous à [Régulateur LinkedIn de vitesse d'utilisation pour Apache Kafka avec Amazon MSK](cruise-control.md) la section pour connaître les étapes mises à jour pour connecter votre cluster au régulateur de vitesse. Le régulateur de vitesse contient également des instructions pour [utiliser le régulateur de vitesse sans ZooKeeper](https://github.com/linkedin/cruise-control/wiki/Run-without-ZooKeeper).
+ Vous n'avez pas besoin d'accéder directement aux KRaft contrôleurs de votre cluster pour effectuer des actions administratives. Toutefois, si vous utilisez la surveillance ouverte pour collecter des métriques, vous avez également besoin des points de terminaison DNS de vos contrôleurs afin de collecter des métriques non liées aux contrôleurs concernant votre cluster. Vous pouvez obtenir ces points de terminaison DNS à partir de la console MSK ou à l'aide de l'opération [ListNodes](https://docs.aws.amazon.com/msk/1.0/apireference/clusters-clusterarn-nodes.html#ListNodes)API. Consultez [Surveillez un cluster provisionné MSK avec Prometheus](open-monitoring.md) les étapes mises à jour pour configurer la surveillance ouverte pour les clusters KRaft basés.
+ Il n'y a aucune [CloudWatch métrique](https://docs.aws.amazon.com/msk/latest/developerguide/metrics-details.html) supplémentaire à surveiller pour les clusters de KRaft mode par rapport aux clusters de ZooKeeper mode. MSK gère les KRaft contrôleurs utilisés dans vos clusters.
+ Vous pouvez continuer à gérer ACLs l'utilisation de clusters en KRaft mode à l'aide de la chaîne de `--bootstrap-server` connexion. Vous ne devez pas utiliser la chaîne de `--zookeeper` connexion pour gérer ACLs. Consultez [Apache Kafka ACLs](msk-acls.md).
+ En KRaft mode, les métadonnées de votre cluster sont stockées sur des KRaft contrôleurs au sein de Kafka et non sur des ZooKeeper nœuds externes. Par conséquent, il n'est pas nécessaire de contrôler l'accès aux nœuds de contrôleur séparément [comme c'est le cas pour les ZooKeeper nœuds](https://docs.aws.amazon.com/msk/latest/developerguide/zookeeper-security.html).