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}ougenerate. Un secret littéral est refusé avant tout changement. - Générés = montrés une fois.
password: generateettotp: generateproduisent 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 :
urld'un dépôt git autorisé (plugins.allowed_prefixes). L'entréemarketplace+slugn'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,webrefuse de démarrer avec une erreur claire ; - tant que
instance.public_urlest vide, le mode reste inactif ; ordre sûr : démarrer avec les variables, appliquer un profil qui poseinstance.public_url, puis redémarrerweb; - un bandeau rouge s'affiche sur toutes les pages, un avertissement est écrit au démarrage, et
core.instance.statusindiquetest_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.