Aller au contenu principal

Variables d'environnement

IaC Code lit la configuration depuis les arguments CLI, les variables d'environnement et les fichiers de configuration. L'ordre de priorité est :

CLI arguments > environment variables > configuration files

Les variables d'environnement sont utiles pour les pipelines CI/CD, les conteneurs et les remplacements ponctuels sans modifier les fichiers de configuration.

Configuration LLM

VariableDescription
IAC_CODE_PROVIDERNom du fournisseur de modèles (insensible à la casse). Valeurs valides : DashScope, DashScope Token Plan, OpenAI, Anthropic, DeepSeek, Gemini, Azure OpenAI, ModelScope, Kimi CN, Kimi Intl, MiniMax CN, MiniMax Intl, ZhiPu CN, ZhiPu Intl, Volcengine CN, SiliconFlow CN, SiliconFlow Intl, Aliyun CodingPlan, Aliyun CodingPlan Intl, ZhiPu CN CodingPlan, ZhiPu Intl CodingPlan, Volcengine CodingPlan, OpenAPI Compatible, Anthropic Compatible, OpenRouter, Ollama, LM Studio
IAC_CODE_MODELNom du modèle
IAC_CODE_BASE_URLPoint de terminaison API pour OpenAPI Compatible uniquement ; ignoré (avec un avertissement) pour les autres fournisseurs
IAC_CODE_API_KEYClé API du fournisseur ; remplace la clé du fournisseur actif dans .credentials.yml

Consultez Fournisseurs LLM pour les détails des fournisseurs.

Identifiants Alibaba Cloud

VariableDescription
ALIBABA_CLOUD_ACCESS_KEY_IDAccessKey ID
ALIBABA_CLOUD_ACCESS_KEY_SECRETAccessKey Secret
ALIBABA_CLOUD_SECURITY_TOKENJeton STS ; bascule le mode d'identification vers STS lorsqu'il est défini
ALIBABA_CLOUD_REGION_IDRégion par défaut

Consultez Identifiants Alibaba Cloud pour plus de détails.

Télémétrie

VariableDescription
IAC_CODE_DISABLE_NONESSENTIAL_TRAFFICDéfinir à 1 / true / yes / on pour désactiver le trafic de télémétrie non essentiel
DISABLE_TELEMETRYDéfinir à 1 / true / yes / on pour désactiver toute la télémétrie
IAC_CODE_TELEMETRY_ENDPOINTPoint de terminaison OTLP de base ; les points de terminaison de signaux individuels utilisent cette valeur par défaut
IAC_CODE_TELEMETRY_TRACES_ENDPOINTPoint de terminaison de remplacement pour les traces
IAC_CODE_TELEMETRY_METRICS_ENDPOINTPoint de terminaison de remplacement pour les métriques
IAC_CODE_TELEMETRY_LOGS_ENDPOINTPoint de terminaison de remplacement pour les journaux
IAC_CODE_TELEMETRY_HEADERSEn-têtes OTLP personnalisés (format JSON ou clé=valeur)

Autres

VariableDescription
IAC_CODE_CONFIG_DIRRemplace le répertoire de configuration à l'exécution (par défaut ~/.iac-code/) ; prend en charge l'expansion de ~ et $VAR. Tous les artefacts persistés (identifiants, paramètres, historique, projects, image-cache, skills, telemetry, etc.) suivent ce répertoire
IAC_CODE_LOG_DIRRemplace le répertoire local des journaux de démarrage/débogage (par défaut <config-dir>/logs/) ; prend en charge l'expansion de ~ et $VAR. Les enregistrements d'audit des permissions suivent le layout de session et ne sont pas déplacés par cette variable
IAC_CODE_PERMISSION_AUDIT_INCLUDE_TOOL_INPUTRemplace permissions.audit.include_tool_input ; définissez-le sur 1 / true / yes / on pour inclure une entrée d'outil sous forme uniquement dans les enregistrements d'audit des permissions, avec type/longueur/empreinte au lieu des chaînes de payload métier brutes et avec empreinte pour les noms de champs hors liste blanche
IAC_CODE_ENVLabel d'environnement de déploiement (par défaut : production)
IAC_CODE_TENANT_IDIdentifiant de locataire pour la télémétrie ; préfixé automatiquement avec iac_tenant_ si ce n'est pas déjà le cas
IAC_CODE_GIT_BASH_PATHChemin vers bash.exe de Git Bash sous Windows lorsqu'il n'est pas dans le PATH
IAC_CODE_A2A_PUSH_KEYRINGTrousseau de clés secret push A2A chiffré géré par l'environnement (format JSON)
OTEL_EXPORTER_OTLP_ENDPOINTPoint de terminaison OpenTelemetry standard ; lorsqu'il est défini, active l'export OTLP
OTEL_INSTRUMENTATION_GENAI_CAPTURE_MESSAGE_CONTENTCapturer le contenu des messages/outils GenAI sur les spans : SPAN_ONLY, EVENT_ONLY, SPAN_AND_EVENT

Sauvegarde de session

VariableDescription
IAC_CODE_CONFIG_BACKUP_DIRRépertoire optionnel de sauvegarde des sessions; prend en charge l’expansion ~ et $VAR, ainsi que l’expansion %VAR% sous Windows. Dans PowerShell, fournissez un chemin concret ou laissez le shell développer $env:VAR avant de démarrer iac-code. Dans les déploiements sandbox, il s’agit souvent d’un chemin OSS monté, mais il doit être indépendant de IAC_CODE_CONFIG_DIR et de toute source de session, sans chevauchement, avec une latence assez faible pour les checkpoints critiques. Les chemins UNC, lecteurs mappés et chemins OSS montés doivent conserver le verrouillage de fichier .backup-lock, le remplacement atomique et les métadonnées de fichier pour la réplication incrémentale; évitez les ancêtres symlink, junction ou reparse point pour la source de session active, la racine de sauvegarde et les sessions miroir. Lorsqu’il est activé, les points de contrôle répliquent chaque session v2 vers <backup>/projects/<project>/<session_id>/ avec la même arborescence que la session active; .backup-state.json et .backup-lock restent locaux et ne sont pas copiés. Les sauvegardes de fin de tour normal utilisent normal_turn_end et ne bloquent pas la réponse; seuls les échecs de checkpoints critical=true bloquent la publication. Les index A2A task/context partagés peuvent être montés séparément.