Variables de entorno del instalador

Objetivo: controlar install.sh / install.ps1 sin editar el script, estableciendo variables de entorno antes de ejecutarlo.

Requisitos previosCopy Anchor Link

• Una shell POSIX (bash) o PowerShell 5.1+. Los ejemplos de PowerShell de más abajo ejecutan pwsh (PowerShell 7+). En Windows PowerShell 5.1, ejecuta en su lugar powershell -NoProfile -ExecutionPolicy Bypass -File install.ps1.
• Las variables se leen una sola vez al principio del instalador, así que establécelas en el mismo comando (o expórtalas antes) y después ejecuta el instalador.

Las variables del instaladorCopy Anchor Link

APOTHEM_SOURCE tiene prioridad sobre un clon: cuando apunta a un checkout que contiene src/apothem, el instalador lo usa directamente, nunca toca APOTHEM_REPO / APOTHEM_REF y omite la resolución de la etiqueta y la verificación de la firma (no se descarga nada que haya que verificar).

Cuando APOTHEM_HOME apunta a un directorio existente que no es un clon de git, el instalador se niega a eliminarlo: apártalo, apunta APOTHEM_HOME a otro lugar o pasa --yes (-Yes en Windows) para autorizar el reemplazo. Un directorio vacío obsoleto se reemplaza sin la opción.

Modelo de confianzaCopy Anchor Link

Sin APOTHEM_REF definido, el instalador resuelve la etiqueta de lanzamiento firmada más reciente y verifica su firma con git verify-tag antes de materializar cualquier configuración; una etiqueta sin firmar o manipulada aborta la instalación. Una etiqueta firmada cuya clave pública del mantenedor falta en el llavero local aborta, en cambio, con indicaciones para importar la clave: importa la clave y comprueba su huella digital con el valor publicado en SECURITY.md. Fija un lanzamiento conocido con APOTHEM_REF=<tag>, tomando la etiqueta de la página de lanzamientos; una etiqueta fijada se verifica del mismo modo. Selecciona la rama móvil con APOTHEM_REF=main más APOTHEM_ALLOW_UNVERIFIED=1; esa instalación no está verificada, y main por sí sola aborta porque una rama no es una etiqueta firmada. Establece APOTHEM_ALLOW_UNVERIFIED=1 por sí sola para continuar pese a un fallo de verificación con una advertencia (uso aislado de la red, local o anterior a los lanzamientos firmados).

APOTHEM_REF=vMAJOR.MINOR.PATCH bash install.sh

APOTHEM_VERIFY=checksum bash install.sh

APOTHEM_ALLOW_UNVERIFIED=1 bash install.sh

Pasos (bash POSIX)Copy Anchor Link

1. Instala un entorno de ámbito de usuario distinto del predeterminado:

   Copy Text

   APOTHEM_HARNESS=codex bash install.sh

2. Fija el destino de instalación y selecciona la rama móvil main. Una rama no es una etiqueta firmada, así que el instalador también necesita APOTHEM_ALLOW_UNVERIFIED=1:

   Copy Text

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

3. Usa un checkout local y un perfil personalizado, omitiendo la verificación:

   Copy Text

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

Pasos (PowerShell)Copy Anchor Link

Establece cada variable en $env: antes de ejecutar el instalador:

$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

VerificarCopy Anchor Link

El instalador imprime ✓ Harness <name> installed y después (a menos que APOTHEM_SKIP_VERIFY=1) ✓ verify passed. Confírmalo de forma independiente:

apothem verify --harness codex

Para un entorno de ámbito de proyecto como Cursor, ejecuta tú mismo la instalación y la verificación después del instalador, con --project:

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

Cuando el perfil todavía no existía, el instalador crea uno a partir del ejemplo y continúa hasta instalar y verificar en la misma ejecución. Los campos de identidad del ejemplo son marcadores de posición, por lo que la instalación imprime un aviso; edita $APOTHEM_PROFILE y después ejecuta apothem update --harness <name> para aplicar tu identidad. Un --dry-run sin perfil hace la vista previa con el ejemplo en su sitio y no escribe nada.

RelacionadoCopy Anchor Link

• Instalación cubre la instalación por red de un solo paso.
• Añadir un entorno cubre cómo añadir entornos mediante la CLI después de la primera instalación.