Краткое руководство. Настройка гибридного кластера с помощью Azure Управляемый экземпляр для Apache Cassandra с помощью настраиваемого клиента

Настроитель клиента Azure — это средство, предназначенное для настройки гибридного кластера и упрощения процесса миграции в Azure Управляемый экземпляр для Apache Cassandra. Если в настоящее время есть локальные центры обработки данных или работают в локальной среде, вы можете использовать Azure Управляемый экземпляр для Apache Cassandra, чтобы легко включить другие центры обработки данных в кластер, эффективно поддерживая их.

Важно!

Средство Настройки клиента находится в общедоступной предварительной версии. Эта функция предоставляется без соглашения об уровне обслуживания и не рекомендуется для использования в рабочей среде. Дополнительные сведения см. в статье Дополнительные условия использования Предварительных версий Microsoft Azure.

Необходимые компоненты

  • Используйте среду Bash в Azure Cloud Shell. Дополнительные сведения см . в кратком руководстве по Bash в Azure Cloud Shell.

  • Если вы предпочитаете выполнять справочные команды CLI локально, установите Azure CLI. Если вы работаете в Windows или macOS, Azure CLI можно запустить в контейнере Docker. Дополнительные сведения см. в статье Как запустить Azure CLI в контейнере Docker.

    • Если вы используете локальную установку, выполните вход в Azure CLI с помощью команды az login. Чтобы выполнить аутентификацию, следуйте инструкциям в окне терминала. Сведения о других возможностях, доступных при входе, см. в статье Вход с помощью Azure CLI.

    • Установите расширение Azure CLI при первом использовании, когда появится соответствующий запрос. Дополнительные сведения о расширениях см. в статье Использование расширений с Azure CLI.

    • Выполните команду az version, чтобы узнать установленную версию и зависимые библиотеки. Чтобы обновиться до последней версии, выполните команду az upgrade.

  • Для работы с этой статьей потребуется Azure CLI 2.30.0 или более поздней версии. Если вы используете Azure Cloud Shell, последняя версия уже установлена.

  • Azure виртуальная сеть с подключением к локальной или локальной среде. Дополнительные сведения о подключении локальных сред к Azure см. в статье Подключение локальной сети к Azure.

  • Установка Python требуется. Вы можете проверка, если python установлен, выполнив в python --version терминале.

  • Убедитесь, что кластер Azure Управляемый экземпляр и локального кластера Cassandra находятся в одной виртуальной сети. В противном случае необходимо установить пиринг сети или другие средства подключения (например, express route).

  • Имя кластера для управляемого кластера и локального кластера должно совпадать. * В файле cassandra.yaml убедитесь, что порт хранения имеет значение 7001, а имя кластера совпадает с управляемым кластером:

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

Установка

  • Скачайте и перейдите в папку настраиваемого клиента.
  • Настройте виртуальную среду для запуска скрипта Python:
python3 -m venv env
source env/bin/activate
python3 -m pip install -r requirements.txt
  • Вход в Azure CLI az login
  • Запустите скрипт Python в клиентской папке с информацией из существующего (локального) кластера:
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>

Примечание.

  • идентификатор подписки: идентификатор подписки Azure.
  • cluster-resource-group: группа ресурсов, которая находится в кластере.
  • имя кластера: имя кластера Azure Управляемый экземпляр.
  • первоначальный пароль: пароль для azure Управляемый экземпляр для кластера Apache Cassandra.
  • vnet-resource-group: группа ресурсов, подключенная к виртуальной сети.
  • имя виртуальной сети: имя виртуальной сети, подключенной к кластеру.
  • имя подсети: имя IP-адреса, выделенного кластеру Cassandra.
  • расположение: место развертывания кластера.
  • начальные узлы: начальные узлы существующих центров обработки данных в локальном или локальном кластере Cassandra.
  • mi-dc-name: имя центра обработки данных кластера Управляемый экземпляр Azure.
  • dc-name: имя центра обработки данных локального кластера.
  • sku: размер SKU виртуальной машины.
  • Скрипт Python создает архив tar с именем install_certs.tar.gz. * Распакуйте эту папку на /etc/cassandra/ каждом узле.

    sudo tar -xzvf install_certs.tar.gz -C /etc/cassandra
    
  • В папке /etc/cassandra/ выполните команду sudo ./install_certs.sh.

    • Убедитесь, что скрипт является исполняемым, выполнив команду sudo chmod +x install_certs.sh.
    • Скрипт устанавливает и указывает Cassandra на новые сертификаты, необходимые для подключения к кластеру Azure Управляемый экземпляр.
    • Затем пользователь предложит перезапустить Cassandra. Screenshot of the result of running the script.
  • После завершения перезапуска Cassandra на всех узлах проверкаnodetool status. Оба центра обработки данных должны отображаться в списке с их узлами в состоянии ООН (up/Normal).

  • В Управляемый экземпляр Azure для Apache Cassandra можно AllKeyspaces изменить параметры реплика tion в схеме Keyspace и запустить процесс миграции в кластер Cassandra Управляемый экземпляр.

    Screenshot of selecting all key spaces.

Совет

Параметр автоматической репликации должен быть включен с помощью шаблона arm. Шаблон arm должен включать:

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

Предупреждение

Это приведет к изменению всех определений пространств ключей, которые необходимо включить WITH REPLICATION = { 'class' : 'NetworkTopologyStrategy', 'on-prem-datacenter-1' : 3, 'mi-datacenter-1': 3 }. Если это не нужная топология, необходимо настроить ее и запустить nodetool rebuild вручную в кластере Cassandra Управляемый экземпляр. Дополнительные сведения о автоматической репликации

  • Обновление и мониторинг хода выполнения реплика данных путем Data Center выбора области

    Screenshot showing replication progress.

[!INFO]

Следующие шаги

Из этого краткого руководства вы узнали, как создать гибридный кластер с помощью Azure Управляемый экземпляр для Клиента Apache Cassandra. Теперь можно приступить к работе с кластером.