Variables d'environnement de l'installateur

Objectif : piloter install.sh / install.ps1 sans modifier le script, en définissant des variables d'environnement avant de l'exécuter.

PrérequisCopy Anchor Link

• Un shell POSIX (bash) ou PowerShell 5.1+. Les exemples PowerShell ci-dessous exécutent pwsh (PowerShell 7+). Sous Windows PowerShell 5.1, exécutez plutôt powershell -NoProfile -ExecutionPolicy Bypass -File install.ps1.
• Les variables sont lues une seule fois, au début de l'installateur ; définissez-les donc dans la même commande (ou exportez-les d'abord), puis exécutez l'installateur.

Les variables de l'installateurCopy Anchor Link

APOTHEM_SOURCE a priorité sur un clonage : lorsqu'elle pointe vers un checkout qui contient src/apothem, l'installateur l'utilise directement, ne touche jamais à APOTHEM_REPO / APOTHEM_REF, et ignore la résolution de l'étiquette et la vérification de la signature (rien n'est récupéré, donc il n'y a rien à vérifier).

Lorsque APOTHEM_HOME pointe vers un répertoire existant qui n'est pas un clone git, l'installateur refuse de le supprimer : déplacez-le, faites pointer APOTHEM_HOME ailleurs, ou passez --yes (-Yes sous Windows) pour autoriser le remplacement. Un répertoire vide obsolète est remplacé sans cette option.

Modèle de confianceCopy Anchor Link

Lorsque APOTHEM_REF n'est pas définie, l'installateur résout la dernière étiquette de publication signée et vérifie sa signature avec git verify-tag avant de matérialiser la moindre configuration ; une étiquette non signée ou altérée interrompt l'installation. Une étiquette signée dont la clé publique du mainteneur est absente du trousseau local interrompt plutôt l'installation avec des indications pour importer la clé : importez la clé et comparez son empreinte avec la valeur publiée dans SECURITY.md. Épinglez une publication connue avec APOTHEM_REF=<tag>, en prenant l'étiquette sur la page des publications ; une étiquette épinglée est vérifiée de la même manière. Sélectionnez la branche mouvante avec APOTHEM_REF=main plus APOTHEM_ALLOW_UNVERIFIED=1 ; cette installation n'est pas vérifiée, et main seule interrompt l'installation, car une branche n'est pas une étiquette signée. Définissez APOTHEM_ALLOW_UNVERIFIED=1 seule pour passer outre un échec de vérification avec un avertissement (usage isolé du réseau, local, ou antérieur aux publications signées).

APOTHEM_REF=vMAJOR.MINOR.PATCH bash install.sh

APOTHEM_VERIFY=checksum bash install.sh

APOTHEM_ALLOW_UNVERIFIED=1 bash install.sh

Étapes (POSIX bash)Copy Anchor Link

1. Installer un environnement de portée utilisateur autre que celui par défaut :

   Copy Text

   APOTHEM_HARNESS=codex bash install.sh

2. Épingler la destination d'installation et sélectionner la branche mouvante main. Une branche n'est pas une étiquette signée : l'installateur a donc aussi besoin de APOTHEM_ALLOW_UNVERIFIED=1 :

   Copy Text

   APOTHEM_REF=main APOTHEM_ALLOW_UNVERIFIED=1 APOTHEM_HOME=/opt/apothem bash install.sh

3. Utiliser un checkout local et un profil personnalisé, en ignorant la vérification :

   Copy Text

   APOTHEM_SOURCE=/work/apothem \
   APOTHEM_PROFILE=/work/profile.yaml \
   APOTHEM_SKIP_VERIFY=1 \
   bash install.sh

Étapes (PowerShell)Copy Anchor Link

Définissez chaque variable sur $env: avant d'exécuter l'installateur :

$env:APOTHEM_HARNESS = 'codex'
pwsh -NoProfile -File install.ps1

$env:APOTHEM_ALLOW_UNVERIFIED = '1'
$env:APOTHEM_REF = 'main'
$env:APOTHEM_HOME = 'C:\opt\apothem'
pwsh -NoProfile -File install.ps1

$env:APOTHEM_SOURCE = 'C:\work\apothem'
$env:APOTHEM_PROFILE = 'C:\work\profile.yaml'
$env:APOTHEM_SKIP_VERIFY = '1'
pwsh -NoProfile -File install.ps1

VérifierCopy Anchor Link

L'installateur affiche ✓ Harness <name> installed, puis (sauf si APOTHEM_SKIP_VERIFY=1) ✓ verify passed. Confirmez de manière indépendante :

apothem verify --harness codex

Pour un environnement de portée projet tel que Cursor, lancez vous-même l'installation et la vérification après l'installateur, avec --project :

apothem install --harness cursor --project /path/to/project
apothem verify --harness cursor --project /path/to/project

Lorsque le profil n'existait pas encore, l'installateur en crée un à partir de l'exemple et poursuit l'installation et la vérification au cours de la même exécution. Les champs d'identité de l'exemple sont des espaces réservés ; l'installation affiche donc une remarque. Modifiez $APOTHEM_PROFILE, puis exécutez apothem update --harness <name> pour appliquer votre identité. Un --dry-run sans profil effectue l'aperçu avec l'exemple en place et n'écrit rien.

Voir aussiCopy Anchor Link

• Installation couvre l'installation réseau en une seule étape.
• Ajouter un environnement couvre l'ajout d'environnements via la CLI après la première installation.