Installation dans Docker

Exigences relatives au moteur d’exécution du conteneur

L’image du conteneur de l’orchestrateur Maverics s’exécutera dans n’importe quel moteur d’exécution de conteneur qui prend en charge la spécification Open Container Initiative (OCI) et l’architecture amd64/X86_64. Ce guide présente les instructions d’installation, de configuration et d’exécution à l’aide de Docker, mais celles-ci peuvent être adaptées pour exécuter l’orchestrateur avec n’importe quel moteur d’exécution compatible.

Télécharger le conteneur

La version actuelle de l’image du conteneur de l’orchestrateur peut être téléchargée à partir de la page Orchestrators de l’interface utilisateur de Maverics.

L’image est distribuée sous la forme d’une archive tar.gz qui peut être importée dans votre système local ou votre registre. Elle n’est actuellement pas disponible à partir d’un registre public.

Chargement du conteneur

Une fois l’archive de l’image Maverics téléchargée, chargez-la dans votre registre d’images local à l’aide de la commande docker load :

$ docker load --input maverics.tar.gz

Configuration du conteneur

Fichier de configuration local

Le conteneur de l’orchestrateur peut charger sa configuration et ses extensions de services à partir d’un répertoire du système de fichiers local installé dans le conteneur.

Créez un fichier maverics.yaml dans un répertoire adéquat sur l’hôte Docker et ajoutez la configuration de l’orchestrateur désirée. Vous devrez installer ce répertoire sous la forme /etc/maverics dans le conteneur lorsque celui-ci s’exécutera.

Variables d’environnement pour les conteneurs

L’orchestrateur peut lire les variables d’environnement qui remplacent les comportements et les chemins d’accès aux fichiers par défaut.

La manière la plus simple de définir des variables d’environnement pour les conteneurs dans Docker est de créer un fichier d’environnement. Par exemple, un fichier maverics.env peut spécifier les éléments suivants :

MAVERICS_CONFIG=/opt/orchestrator/custom.yaml
MAVERICS_TLS_SERVER_CERT_FILE=/etc/maverics/certs/example.crt
MAVERICS_TLS_SERVER_KEY_FILE=/etc/maverics/certs/example.key

Ce format d’environnement peut être utilisé dans d’autres moteurs d’exécution de conteneurs qui prennent en charge l’option --env-file.

Fichier de configuration à distance

Consultez la section Configuration à distance et rechargement automatique pour découvrir comment configurer l’orchestrateur pour le stockage partagé à distance. Un fichier d’environnement pour la configuration à distance ressemble à ce qui suit :

MAVERICS_HTTP_ADDRESS=:443
MAVERICS_RELOAD_CONFIG=true
MAVERICS_TLS_SERVER_CERT_FILE=/etc/maverics/certs/example.crt
MAVERICS_TLS_SERVER_KEY_FILE=/etc/maverics/certs/example.key
MAVERICS_GITHUB_CONFIG={ "token": "github_xxxxxxxxxxxxxxxxxxxxxxx", "owner": "jdoe", "repo": "maverics-config", "configurationFilePath": "folder1/folder2" }

Les objets JSON de plusieurs lignes doivent être concaténés en une seule ligne, comme pour la variable MAVERICS_GITHUB_CONFIG ci-dessus.

Démarrage du conteneur

Pour démarrer le conteneur de l’orchestrateur, utilisez la commande docker run. Par exemple :

docker run --publish 443:8443 \
  --volume /opt/maverics:/etc/maverics \
  --env-file /opt/maverics/maverics.env \
  --name orchestrator maverics_base:0.18.10

L’exemple de commande ci-dessus illustre les options suivantes :

--publish (ou -p) mappe le port 8443 du conteneur au port 443 de l’hôte
--volume (ou -v) lie le répertoire hôte /opt/maverics/ à /etc/maverics dans le conteneur
--env-file source des variables d’environnement à partir d’un fichier maverics.env pour le processus d’orchestration.
--name (facultatif) fournit un nom explicite pour l’instance du conteneur
maverics_base: 0.18.10 spécifie le nom de l’image et le numéro de version du conteneur

Les chemins d’accès, les adresses de port, les noms, les versions et les autres paramètres varient en fonction de votre utilisation. Des informations sur toutes les options sont disponibles dans la documentation de référence de docker run.

Mise à jour

Pour mettre à jour l’orchestrateur, téléchargez la dernière version à partir de l’interface utilisateur de Maverics et chargez-la dans Docker (votre registre local). Fermez le conteneur en cours d’exécution et démarrez un nouveau conteneur en utilisant la même commande avec le nouveau numéro de version.

Désinstallation

Utilisez la commande docker rm pour supprimer l’instance de conteneur, et la commande docker rmi pour supprimer toute image de conteneur indésirable du registre local. Par exemple :

docker rm orchestrator
docker rmi maverics_base:0.18.10

Installation d’un orchestrateur Installation sur Linux