Compartir a través de


Inicio rápido: Configuración de un clúster híbrido con Azure Managed Instance para Apache Cassandra mediante Client Configurator

Azure Client Configurator es una herramienta diseñada para ayudarle a configurar un clúster híbrido y simplificar el proceso de migración a Azure Managed Instance para Apache Cassandra. Si actualmente tiene centros de datos locales o trabaja en un entorno autohospedado, puede usar Azure Managed Instance for Apache Cassandra para incorporar sin problemas otros centros de datos en el clúster, a la vez que los mantiene de forma eficaz.

Importante

La herramienta De configuración de cliente está en versión preliminar pública. Esta característica se proporciona sin un Acuerdo de Nivel de Servicio. No es aconsejable para cargas de trabajo de producción.

Para más información, consulte Términos de uso complementarios de las Versiones Preliminares de Microsoft Azure.

Requisitos previos

  • En este artículo se requiere la versión 2.30.0 o posterior de la CLI de Azure. Si usa Azure Cloud Shell, ya está instalada la versión más reciente.

  • Use una red virtual de Azure con conectividad con el entorno autohospedado o local. Para más información sobre cómo conectar entornos locales a Azure, consulte Conexión de una red local a Azure.

  • Se requiere una instalación de Python. Para comprobar si Python está instalado, ejecute python --version en el terminal.

  • Asegúrese de que tanto el clúster de Azure Managed Instance para Apache Cassandra como el clúster de Cassandra local se encuentran en la misma red virtual. Si no es así, debe establecer el emparejamiento de red u otro medio de conectividad. Por ejemplo, use Azure ExpressRoute.

  • El nombre del clúster para el clúster administrado y el clúster local deben ser los mismos.

    En el cassandra.yaml archivo, asegúrese de que el puerto de almacenamiento esté establecido en 7001 y que el nombre del clúster sea el mismo que el clúster administrado:

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

Instalación

  1. Descargue y vaya a la carpeta del configurador de cliente.

  2. Configure un entorno virtual para ejecutar el script de Python:

    python3 -m venv env
    source env/bin/activate
    python3 -m pip install -r requirements.txt
    
  3. Inicie sesión en la CLI az loginde Azure.

  4. Ejecute el script de Python dentro de la carpeta cliente con información del clúster existente (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>
    
    Parámetro Descripción
    subscription-ID Identificador de suscripción de Azure
    cluster-resource-group Grupo de recursos donde reside el clúster
    cluster-name Nombre del clúster de Azure Managed Instance para Apache Cassandra
    initial-password Contraseña del clúster de Azure Managed Instance para Apache Cassandra
    vnet-resource-group Grupo de recursos asociado a la red virtual
    vnet-name Nombre de la red virtual conectada al clúster
    subnet-name Nombre de la dirección IP asignada al clúster de Cassandra
    location Dónde se implementa el clúster
    seed-nodes Nodos de inicialización de los centros de datos existentes en el clúster de Cassandra local o autohospedado
    mi-dc-name Nombre del centro de datos de la instancia administrada de Azure para el clúster de Apache Cassandra
    dc-name Nombre del centro de datos del clúster local
    sku Tamaño del nivel de producto de máquina virtual
  5. El script de Python genera un archivo tar denominado install_certs.tar.gz. Desempaque esta carpeta en /etc/cassandra/ para cada nodo:

    sudo tar -xzvf install_certs.tar.gz -C /etc/cassandra
    
  6. Dentro de la carpeta /etc/cassandra/, ejecute sudo ./install_certs.sh.

    • Asegúrese de que el script es ejecutable; para ello, ejecute sudo chmod +x install_certs.sh.

    • El script instala y apunta Cassandra hacia los nuevos certificados necesarios para conectarse al clúster de Azure Managed Instance para Apache Cassandra.

    • A continuación, solicita al usuario que reinicie Cassandra.

      Captura de pantalla que muestra el resultado de ejecutar el script.

  7. Una vez que Cassandra haya terminado de reiniciarse en todos los nodos, compruebe nodetool status. Ambos centros de datos deben aparecer en la lista con los nodos en el estado UN (Up/Normal).

  8. Desde su instancia de Azure Managed Instance para Apache Cassandra, puede seleccionar AllKeyspaces para cambiar la configuración de replicación en el esquema de su espacio de claves e iniciar el proceso de migración al clúster de la instancia gestionada de Azure para Cassandra.

  9. Habilite la autoReplicate configuración mediante una plantilla de Azure Resource Manager (plantilla de ARM). La plantilla de ARM debe incluir:

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

    Todas las definiciones de espacios de clave cambian para incluir WITH REPLICATION = { 'class' : 'NetworkTopologyStrategy', 'on-prem-datacenter-1' : 3, 'mi-datacenter-1': 3 }. Si esta topología no es lo que desea, ajustela y ejecútela nodetool rebuild manualmente en el clúster de Azure Managed Instance para Apache Cassandra.

    Obtenga más información sobre la replicación automática.

  10. Actualice y supervise el progreso de la replicación de datos seleccionando el panel Centro de datos .

    Captura de pantalla que muestra el progreso de la replicación.

Paso siguiente