Aller au contenu

Installer et préparer une instance

Premier démarrage

docker compose -f deploy/compose.yml up -d

Au premier démarrage, un compte super-admin admin est créé en attente d'activation (HARNESS_BOOTSTRAP_ADMIN, défaut admin). Son lien d'activation se lit une seule fois :

docker compose -f deploy/compose.yml exec web cat /data/bootstrap/activation-link

Ouvrez le lien, choisissez un mot de passe (12 caractères au moins) et enrôlez l'application TOTP. Le lien ne sert qu'une fois et n'apparaît jamais dans les journaux. Pour un autre nom, définissez HARNESS_BOOTSTRAP_ADMIN=<nom> ; pour utiliser plutôt l'assistant /setup et son code d'installation, définissez HARNESS_BOOTSTRAP_ADMIN= (chaîne vide).

Jeton de métriques d'amorçage : HARNESS_BOOTSTRAP_METRICS_TOKEN=<au moins 16 caractères> est importé au premier démarrage si aucun jeton n'existe (il est ensuite géré par l'interface).

Installation par profil

Un profil est un fichier YAML qui décrit l'instance voulue. harness-admin install l'applique et peut être rejoué sans risque : ce qui est déjà conforme n'est pas touché.

version: 1
instance: {name: "Mon instance", public_url: "https://harness.example.org"}
config: {files.max_mb: 100, files.clamav: ["clamav:3310"]}
secrets: {core/mon_secret: {env: MON_SECRET}}
users:
  - {username: e2e-bot, display_name: "E2E Bot", role: superadmin, password: generate, totp: generate}
model_accounts:
  - {name: principal, kind: api_key, token: {env: ANTHROPIC_API_KEY}, priority: 10}
plugins: []
metrics_token: generate

Un exemple complet et commenté est livré : deploy/profiles/example.yml.

# 1. décrire sans rien changer
docker exec -i web harness-admin install --dry-run /dev/stdin < profil.yml
# 2. appliquer ; les identifiants générés vont dans un fichier privé
docker exec -i -e ANTHROPIC_API_KEY web harness-admin install --out /data/bootstrap/install-secrets.json /dev/stdin < profil.yml
docker exec web cat /data/bootstrap/install-secrets.json

Règles :

  • Aucun secret en clair. Une valeur secrète s'écrit {env: NOM} (variable du conteneur : docker exec -e NOM), {file: /chemin} ou generate. Un secret littéral est refusé avant tout changement.
  • Générés = montrés une fois. password: generate et totp: generate produisent des identifiants restitués dans le JSON de sortie (ou dans le fichier --out). Au rejeu, un compte existant n'est jamais modifié : aucun nouvel identifiant n'est produit. Pour en obtenir de nouveaux : harness-admin user reset-password / reset-totp.
  • Un profil invalide est refusé en entier (clé inconnue, secret en clair, URL sans http(s)://). Si une étape échoue, le rejeu s'arrête et dit laquelle ; corrigez et relancez.
  • Plugins : url d'un dépôt git autorisé (plugins.allowed_prefixes). L'entrée marketplace + slug n'est acceptée que dans une version qui fournit les marketplaces.
  • Un super-admin créé par profil termine l'installation (plus de code d'installation à saisir).

Instance de test sans mot de passe (jetable)

Ne jamais utiliser sur une instance qui contient de vraies données. La connexion web ne demande plus que le nom d'utilisateur : toute personne qui atteint la page peut devenir n'importe quel utilisateur actif, administrateurs compris.

Deux variables sur le service web : HARNESS_TEST_MODE=passwordless et HARNESS_TEST_MODE_HOST=<hôte de l'URL publique> (par exemple harness-test.example.org). Garde-fous :

  • le mode ne se pilote que par l'environnement (ni réglage ni opération) ;
  • si l'hôte ne correspond pas à instance.public_url, web refuse de démarrer avec une erreur claire ;
  • tant que instance.public_url est vide, le mode reste inactif ; ordre sûr : démarrer avec les variables, appliquer un profil qui pose instance.public_url, puis redémarrer web ;
  • un bandeau rouge s'affiche sur toutes les pages, un avertissement est écrit au démarrage, et core.instance.status indique test_mode ;
  • l'API, le MCP et les jetons ne changent pas.

Sans ces variables, rien ne change.

Mettre à jour

Les mises à jour de l'image conservent les comptes. Le compte admin par défaut n'est créé que sur une instance neuve.