Registre et Images¶

Avant l’installation, toutes les machines ciblées doivent pouvoir accéder aux images nécessaires au déploiement de l’environnement.
Trois modes sont disponibles : Online, Proxy, Offline.
Choisissez un seul mode et définissez les variables avant la commande d’installation finale.

Principes généraux¶

Les variables de registre sont lues par le rôle Ansible reemo-relayws.

REGISTRY_URL: l’url du registre (ex. registry.reemo.io)
REGISTRY_ENV: le préfixe permettant au rôle Ansible de construire les noms d’images au format **REGISTRY_ENV**traefik
REGISTRY_USERNAME: nom d’utilisateur fourni par le support Reemo
REGISTRY_PASSWORD: mot de passe fourni par le support Reemo

Exemple d’image résultante : registry.reemo.io/reemoinfratraefik:latest

Tip

Vérifiez l’espace disque sur chaque noeud. Le chargement d’images peut exiger plusieurs Go libres.

Mode Online¶

Toutes les machines joignent directement le registre Reemo.

Conditions¶

Sortie HTTPS ouverte vers registry.reemo.io:443.
Identifiants fournis par le support Reemo.

Inventaire minimal¶

all:
    vars:
        REGISTRY_URL: "registry.reemo.io"
        REGISTRY_ENV: "reemoinfra"
        REGISTRY_USERNAME: "user"
        REGISTRY_PASSWORD: "password"
relayws_manager:
    hosts:
        relayws_manager1:
            ansible_host: "10.0.0.4"
        relayws_manager2:
            ansible_host: "10.0.0.5"

Contrôles rapides¶

Vérifier la connexion au registre (depuis un noeud)

docker login registry.reemo.io

Vérifier le préfixe utilisé (exemple)

docker pull registry.reemo.io/reemoinfratraefik:latest

Confirmer la présence de l’image en local

docker image ls

Mode Proxy¶

Les noeuds accèdent au registre via un proxy HTTP/HTTPS.

Utilisez la même configuration d’inventaire que le mode Online.

Pour déclarer le proxy au niveau du service Docker:

Rajoutez la ligne suivante dans la section [Service] du fichier /usr/lib/systemd/system/docker.service

EnvironmentFile=/etc/default/docker

Créez le fichier /etc/default/docker et renseignez les infos suivantes:

http_proxy="http://< IP du serveur Proxy >:< Port du service Proxy >"
https_proxy="http://< IP du serveur Proxy >:< Port du service Proxy >"

Au niveau du proxy autorisez les 2 urls suivantes:

registry.reemo.io
registry-auth.reemo.io

Mode Offline¶

Aucune sortie Internet depuis les noeuds. Les images sont pré-packagées en tarballs. Utilisez le mode Offline du rôle reemo-infra pour générer les tarballs d’images requis par RELAYWS.

Générer les tarballs¶

Executez cette commande avec le rôle Ansible reemo-infra :

ansible-playbook -i inventory.yml playbooks/reemo-infra.yml \
    --extra-vars "TARBALL_GENERATE=true" --tags tarball_generate

Charger les tarballs¶

Executez cette commande avec le rôle Ansible reemo-relayws :

ansible-playbook -i inventory.yml playbooks/reemo-relayws.yml \
    --extra-vars "LOAD_IMAGE=true" \
    --extra-vars "TARBALL_PATH=/opt/reemo/images"

Note

Vous pouvez aussi charger les images sur votre propre registre.

Vous pouvez ensuite lancer l’installation en mode Online contre votre registre.