Краткое руководство. Настройка гибридного кластера с помощью 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.
- Убедитесь, что скрипт является исполняемым, выполнив команду
После завершения перезапуска Cassandra на всех узлах проверьте
nodetool status
. Оба центра обработки данных должны отображаться в списке с их узлами в состоянии ООН (up/Normal).В Управляемый экземпляр Azure для Apache Cassandra можно
AllKeyspaces
изменить параметры репликации в схеме Keyspace и запустить процесс миграции в кластер Cassandra Управляемый экземпляр.
Совет
Параметр автоматической репликации должен быть включен с помощью шаблона 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 Управляемый экземпляр.
Дополнительные сведения о автоматической репликации
[!INFO]
Следующие шаги
Из этого краткого руководства вы узнали, как создать гибридный кластер с помощью Azure Управляемый экземпляр для Клиента Apache Cassandra. Теперь можно приступить к работе с кластером.