Share via

Démarrage rapide : Configurer un cluster hybride avec Azure Managed Instance pour Apache Cassandra à l’aide du configurateur client

  • Article

Le configurateur client Azure est un outil conçu pour vous aider à configurer un cluster hybride et à simplifier le processus de migration vers Azure Managed Instance pour Apache Cassandra. Si vous disposez actuellement de centres de données locaux ou que vous travaillez dans un environnement auto-hébergé, vous pouvez utiliser Azure Managed Instance pour Apache Cassandra pour incorporer en toute transparence d’autres centres de données dans votre cluster tout en les conservant efficacement.

Important

L’outil configurateur client est en préversion publique. Cette fonctionnalité est fournie sans contrat de niveau de service et est déconseillée pour les charges de travail de production. Pour plus d’informations, consultez Conditions d’Utilisation Supplémentaires relatives aux Évaluations Microsoft Azure.

Prérequis

  • Pour cet article, vous avez besoin d’Azure CLI version 2.30.0 ou ultérieure. Si vous utilisez Azure Cloud Shell, sachez que la version la plus récente est déjà installée.

  • Un réseau virtuel Azure connecté à votre environnement autohébergé ou local. Pour plus d’informations sur la connexion d’environnements locaux à Azure, consultez l’article Connecter un réseau local à Azure.

  • L’installation de Python est requise. Vous pouvez vérifier si Python est installé en exécutant python --version dans votre terminal.

  • Vérifiez que l’instance managée Azure et le cluster Cassandra local se trouvent sur le même réseau virtuel. Si ce n’est pas le cas, il est nécessaire d’établir un peering réseau ou d’autres moyens de connectivité (par exemple, un itinéraire express).

  • Les noms du cluster managé et du cluster local doivent être identiques. * Dans le fichier cassandra.yaml, vérifiez que le port de stockage est défini sur 7001 et que le nom du cluster est identique au cluster managé :

cluster_name: managed_cluster-name
storage_port: 7001

UPDATE system.local SET cluster_name = 'managed_cluster-name' where key='local';

Installation

python3 -m venv env
source env/bin/activate
python3 -m pip install -r requirements.txt
  • Se connecter à Azure CLI az login
  • Exécutez le script Python dans le dossier client avec des informations du cluster existant (local) :
python3 client_configurator.py --subscription-id <subcriptionId> --cluster-resource-group <clusterResourceGroup> --cluster-name <clusterName> --initial-password <initialPassword> --vnet-resource-group <vnetResourceGroup> --vnet-name <vnetName> --subnet-name <subnetName> --location <location> --seed-nodes <seed1 seed2 seed3> --mi-dc-name <managedInstanceDataCenterName> --dc-name <onPremDataCenterName> --sku <sku>

Remarque

  • subscription-id : numéro d’abonnement Azure.
  • cluster-resource-group : groupe de ressources où votre cluster réside.
  • nom du cluster : nom du cluster Azure Managed Instance.
  • mot de passe initial : mot de passe pour votre cluster Azure Managed Instance pour Apache Cassandra.
  • vnet-resource-group : groupe de ressources attaché au réseau virtuel.
  • nom du réseau virtuel : nom du réseau virtuel attaché à votre cluster.
  • nom du sous-réseau : nom de l’adresse IP allouée au cluster Cassandra.
  • emplacement : emplacement où votre cluster est déployé.
  • nœuds seed : nœuds seed des centres de données existants dans votre cluster Cassandra local ou auto-hébergé.
  • mi-dc-name : nom du centre de données de votre cluster Azure Managed Instance.
  • dc-name : nom du centre de données du cluster local.
  • sku : taille de la référence SKU de la machine virtuelle.

  • Le script Python produit une archive tar nommée install_certs.tar.gz. * Décompressez ce dossier dans /etc/cassandra/ sur chaque nœud.

    sudo tar -xzvf install_certs.tar.gz -C /etc/cassandra

  • Dans le /etc/cassandra/ dossier, exécutez sudo ./install_certs.sh.

    • Vérifiez que le script est exécutable en exécutant sudo chmod +x install_certs.sh.
    • Le script installe et pointe Cassandra vers les nouveaux certificats nécessaires pour se connecter au cluster Azure Managed Instance.
    • Il invite ensuite l’utilisateur à redémarrer Cassandra. Screenshot of the result of running the script.

  • Une fois Cassandra redémarré sur tous les nœuds, case activée nodetool status. Les deux centres de données doivent apparaître dans la liste, avec leurs nœuds dans l’état UN (Up/Normal).

  • À partir de votre Azure Managed Instance pour Apache Cassandra, vous pouvez ensuite sélectionner AllKeyspaces pour modifier les paramètres de réplication dans votre schéma Keyspace et de démarrer le processus de migration vers le cluster Cassandra Managed Instance.

    Screenshot of selecting all key spaces.

Conseil

Le paramètre de réplication automatique doit être activé via un modèle arm. Le modèle arm doit inclure :

"properties":{
...
"externalDataCenters": ["dc-name-1","dc-name-2"],
"autoReplicate": "AllKeyspaces",
...
}

Avertissement

Cela modifie toutes vos définitions d’espaces de clés pour inclure WITH REPLICATION = { 'class' : 'NetworkTopologyStrategy', 'on-prem-datacenter-1' : 3, 'mi-datacenter-1': 3 }. Si ce n’est pas la topologie souhaitée, vous devez l’ajuster et l’exécuter nodetool rebuild manuellement sur le cluster Cassandra Managed Instance. En savoir plus sur la réplication automatique

  • Mettre à jour et surveiller la progression de la réplication des données en sélectionnant le volet Data Center

    Screenshot showing replication progress.

[ !INFO]

Étapes suivantes

Dans ce guide de démarrage rapide, vous avez appris à créer un cluster hybride à l’aide du configurateur client d’Azure Managed Instance pour Apache Cassandra. Vous pouvez maintenant commencer à utiliser le cluster.

Découvrez comment migrer vers Azure Managed Instance pour Apache Cassandra à l’aide d’Apache Spark et d’un proxy double écriture