nb config

Gère les valeurs de configuration par défaut de la CLI. Les clés actuellement prises en charge se regroupent principalement ainsi :

  • La CLI elle-même : locale, update.policy, license.pkg-url
  • Runtime Docker : docker.network, docker.container-prefix
  • Exécutables externes : bin.docker, bin.caddy, bin.git, bin.nginx, bin.pnpm, bin.yarn
  • Génération de proxy : proxy.nb-cli-root, proxy.upstream-host, proxy.nginx-driver, proxy.caddy-driver

La plupart des projets n'ont besoin que de quelques-unes de ces clés. En pratique, les plus courantes sont :

  • update.policy
  • docker.network
  • docker.container-prefix
  • bin.nginx ou bin.caddy
  • proxy.nginx-driver ou proxy.caddy-driver

Clés de configuration courantes

CléValeur par défautDescription
localerésolue selon les règles actuelles de la CLIRemplace la langue utilisée par la CLI
update.policypromptPolitique de mise à jour au démarrage : prompt, auto ou off
license.pkg-urlhttps://pkg.nocobase.com/Remplace l'URL de téléchargement des paquets d'extensions commerciales
docker.networknocobaseRéseau par défaut pour les applications Docker gérées par la CLI
docker.container-prefixnbPréfixe par défaut pour les conteneurs Docker gérés par la CLI
bin.dockerdockerRemplace le chemin de l'exécutable Docker
bin.caddycaddyRemplace le chemin de l'exécutable Caddy
bin.gitgitRemplace le chemin de l'exécutable Git
bin.nginxnginxRemplace le chemin de l'exécutable Nginx
bin.pnpmpnpmRemplace le chemin de l'exécutable pnpm
bin.yarnyarnRemplace le chemin de l'exécutable Yarn
proxy.nb-cli-rootracine de la CLI, généralement le répertoire personnel de l'utilisateur courantRemplace la racine visible par la configuration proxy générée lorsque le processus proxy et la CLI ne voient pas la même racine du système de fichiers
proxy.upstream-host127.0.0.1Remplace l'hôte utilisé par le proxy pour renvoyer le trafic vers l'application NocoBase
proxy.nginx-driverlocalDriver de runtime par défaut utilisé par nb proxy nginx
proxy.caddy-driverlocalDriver de runtime par défaut utilisé par nb proxy caddy

Utilisation

nb config <command>

Sous-commandes

CommandeDescription
nb config getLire la valeur effective d'une clé de configuration
nb config setDéfinir une clé de configuration
nb config deleteSupprimer une clé de configuration explicitement définie
nb config listLister les clés de configuration explicitement définies actuellement

Exemples

nb config list
nb config get update.policy
nb config set update.policy auto
nb config get proxy.nb-cli-root
nb config set proxy.nb-cli-root /workspace
nb config set proxy.upstream-host host.docker.internal
nb config set proxy.nginx-driver docker
nb config set proxy.caddy-driver local
nb config get docker.network
nb config set docker.network nocobase
nb config set bin.nginx /usr/sbin/nginx
nb config set bin.git /usr/bin/git
nb config set bin.pnpm /usr/local/bin/pnpm
nb config delete docker.container-prefix

Notes

  • bin.nginx et bin.caddy n'affectent que le driver local de nb proxy nginx et nb proxy caddy
  • bin.pnpm est utilisé lorsque des commandes doivent exécuter pnpm directement, par exemple pour mettre à jour une installation globale de la CLI gérée par pnpm avec nb self update
  • proxy.nginx-driver et proxy.caddy-driver stockent le driver par défaut utilisé par chaque provider
  • proxy.nb-cli-root et proxy.upstream-host sont des surcharges proxy avancées. Pour la plupart des environnements local ou docker gérés par la CLI, les valeurs par défaut suffisent
  • Si tu veux simplement changer le driver proxy actif, nb proxy nginx use ou nb proxy caddy use est généralement plus clair que de modifier la clé de configuration manuellement

Commandes associées