Aller au contenu principal
Docker Compose

Un conteneur Human Plugin sur un hôte, connecté à votre base de données PostgreSQL.

Markdown

Prérequis​

  • Docker Engine 24 ou supérieur avec Docker Compose v2.
  • Une base de données PostgreSQL dédiée à Human Plugin, accessible depuis l'hôte. Voir Prérequis et accès.
  • Les identifiants du registre et la clé d'accès fournis par Unico.

1. Se connecter au registre​

Une fois par hôte. Docker conserve l'identifiant dans ~/.docker/config.json.

echo "<token>" | docker login pkg.unico.run -u <username> --password-stdin

2. Écrire les paramètres​

Créez un répertoire pour Human Plugin et un fichier .env lisible uniquement par son propriétaire :

mkdir -p /opt/human-plugin && cd /opt/human-plugin
.env
HUMAN_API_ACCESS_KEY=<your access key>
POSTGRES_ADDRESS_HOST=<database host>
POSTGRES_USER=human_plugin
POSTGRES_PASSWORD=<database password>
chmod 600 .env

Ajoutez POSTGRES_ADDRESS_PORT, POSTGRES_DATABASE ou POSTGRES_SSL_MODE uniquement si votre base de données diffère des valeurs par défaut décrites dans Configuration. Ne versionnez jamais le fichier .env.

3. Écrire compose.yaml​

compose.yaml
services:
  human-plugin:
    image: pkg.unico.run/human-plugin-api:latest
    pull_policy: always
    restart: unless-stopped
    stop_grace_period: 60s
    env_file: .env
    ports:
      - "127.0.0.1:8080:8080"
  • ports : publiez uniquement sur 127.0.0.1 ou sur une interface privée, jamais sur 0.0.0.0. Human Plugin n'a pas d'authentification propre : voir Réseau et sécurité.
  • stop_grace_period: 60s : à l'arrêt, Human Plugin attend jusqu'à 55 secondes les requêtes en cours. Un délai plus court peut interrompre une création.
  • pull_policy: always : chaque up vérifie la dernière image, ce qui vous garantit d'exécuter la version la plus récente.

4. Démarrer​

docker compose up -d
curl --fail http://127.0.0.1:8080/health/ready

N'acheminez du trafic vers Human Plugin qu'après que /health/ready répond 200. Exécutez ensuite la requête de création du Démarrage rapide sur ce déploiement.

Journaux et état​

docker compose ps
docker compose logs -f human-plugin

Un démarrage sain se termine par la ligne human plugin listening. Consultez Santé et supervision pour le journal de démarrage complet. Si le conteneur redémarre en boucle, le journal en indique la raison : voir Dépannage.

Mise à jour​

docker compose pull && docker compose up -d

Compose ne remplace le conteneur que si l'image a changé. Voir Exploitation pour savoir quoi vérifier après une mise à jour.

Arrêt​

docker compose down

Vos données se trouvent dans votre base de données PostgreSQL : arrêter ou supprimer le conteneur n'en fait perdre aucune.

Dernière mise à jour le