wiki/HowtoMySQL/Orchestrator.md

categories: databases title: Howto Orchestrator : Haute disponibilité et outil de gestion de la réplication.

• Github Orchestrator : https://github.com/openark/orchestrator
• Documentation Orchestrator : https://github.com/openark/orchestrator/tree/master/docs
• Dépot packet Debian : https://packagecloud.io/github/orchestrator

Orchestrator est un outil de gestion de la haute disponibilité et de la réplication MySQL / MariaDB. Il s'exécute en tant que service et fourni un accès en ligne de commande, une API HTTP, et un interface web.

Installation

Sur Debian on préconise l'installation du paquet .deb via le dépot officiel d'Orchestrator :

# apt install debian-archive-keyring curl gnupg apt-transport-https
# curl -L https://packagecloud.io/github/orchestrator/gpgkey > /etc/apt/trusted.gpg.d/orchestrator.asc

En Debian 11 on utlise le dépôt buster, car le dépôt bullseye n'existe pas encore, mais le paquets est compatible. A adapter en fontion de la version de Debian, on utilise ce dépôt le fichier /etc/apt/sources.list.d/github_orchestrator.list

deb https://packagecloud.io/github/orchestrator/debian/ buster main
deb-src https://packagecloud.io/github/orchestrator/debian/ buster main

Puis on recharge la liste des dépots et on installe les paquets :

# apt update
# apt install orchestrator orchestrator-cli

Configuration

Configurer le serveur MariaDB Backend

Orchestrator a besoin d'une base de données de Backend pour stocker l'état du cluster, on préconise de créer la base de donnée orchestrator sur une instance MariaDB en dehors du cluster de réplication, sur une machine qui sert de proxy par exemple :

CREATE DATABASE IF NOT EXISTS orchestrator;
CREATE USER 'orchestrator'@'127.0.0.1' IDENTIFIED BY 'password';
GRANT ALL PRIVILEGES ON `orchestrator`.* TO 'orchestrator'@'127.0.0.1';

Le fichier de configuration d'Orchestrator se trouve dans /etc/orchestrator.conf.json, le packet inclu un fichier nommée orchestrator.conf.json.sample avecune configuration de base, on peux se servir de ce fichier pour créer le fichier de configuration de base :

cp /usr/local/orchestrator/orchestrator-sample.conf.json /etc/orchestrator.conf.json

Editer les variables suivante dans le fichier /etc/orchestrator.conf.json, pour configurer le backend d'Orchestrator vers l'instance MariaDB :

...
"MySQLOrchestratorHost": "127.0.0.1",
"MySQLOrchestratorPort": 3306,
"MySQLOrchestratorDatabase": "orchestrator",
"MySQLOrchestratorUser": "orchestrator",
"MySQLOrchestratorPassword": "password",
...

Configuration d'Ochestrator vers vos serveurs MariaDB

Pour que Ochestrator detecte votre topologie de réplication de votre cluster MariaDB, il doit avoir un compte sur chaque serveur du cluster,il doit s'agir du même compte pour tout les serveurs du cluster. Sur le serveur primaire, on créer l'utilisateur comme ceci :

CREATE USER 'orchestrator_client'@'orchestrator_host' IDENTIFIED BY 'password';
GRANT SUPER, PROCESS, REPLICATION SLAVE, RELOAD ON *.* TO 'orchestrator_client'@'orchestrator_host';
GRANT SELECT ON mysql.slave_master_info TO 'orchestrator_client'@'orchestrator_host';
GRANT SELECT ON ndbinfo.processes TO 'orchestrator_client'@'orchestrator_host'; -- seulement pour un cluster NDB

REPLICATION SLAVE est requis pour SHOW SLAVE HOSTS, and pour scanner les binlogs si on utilise les Pseudo GTID. RELOAD est requis pour pourvoir faire un RESET SLAVE. PROCESS est requis pour surveiller les process des réplicas avec SHOW PROCESSLIST.

On configure le fichier /etc/orchestrator.conf.json avec les variables suivantes pour indiquer l'utilisateur orchestrator_client :

"MySQLTopologyUser": "orchestrator_client",
"MySQLTopologyPassword": "password",

Ensuite on peux démarrer Orchestrator comme ceci :

# systemctl start orchestrator.service