• Français

      • nb portal

      nb portal gère les workspaces Portal. Un Portal peut avoir son propre code source frontend, son chemin d’entrée et son résultat de déploiement ; ce groupe relie l’enregistrement Portal dans NocoBase au workspace local et au source storage.

      Le flux courant consiste à créer un workspace local, lancer le mode développement, pousser les changements vers le source storage, puis builder et déployer. Pour reprendre un Portal existant, commencez par le récupérer avec pull.

      Utilisation

      nb portal <command>

      Sous-commandes

      CommandeDescription
      nb portal configMet à jour la configuration source du workspace Portal local et la synchronise avec l’enregistrement distant lorsque c’est possible
      nb portal createCrée un workspace Portal local à partir d’un template et crée ou met à jour l’enregistrement Portal
      nb portal deployConstruit et déploie le workspace Portal spécifié
      nb portal destroySupprime l’enregistrement Portal et le workspace local
      nb portal devDémarre le mode développement pour le workspace Portal spécifié
      nb portal infoAffiche les détails de l’enregistrement Portal spécifié et du workspace local
      nb portal listListe les enregistrements Portal et l’état de synchronisation du workspace local
      nb portal pullRécupère le code source Portal depuis le source storage vers le workspace local
      nb portal pushPousse les changements locaux du code source Portal vers le source storage

      Flux typique

      Créer un Portal nommé customer :

      nb portal create customer -e dev --yes

      Démarrer le mode développement local :

      nb portal dev customer -e dev --yes

      Inspecter le workspace local et l’enregistrement distant :

      nb portal info customer -e dev --yes
nb portal list -e dev --yes

      Pousser le code source et déployer :

      nb portal push customer -e dev --yes --message "Update customer portal"
nb portal deploy customer -e dev --yes

      Reprendre un Portal existant :

      nb portal list -e dev --yes
nb portal pull customer -e dev --yes
nb portal dev customer -e dev --yes

      Changer le source storage :

      nb portal config customer -e dev --yes --source-storage git --git-repo git@github.com:nocobase/customer-portal.git
nb portal push customer -e dev --yes --message "Move customer portal source to Git"

      source storage

      Lors de la création d’un Portal, choisissez où le code source est géré :

      ModeDescription
      nocobaseDefault mode. Source code is managed by NocoBase source storage.
      gitSource code is stored in a Git repository, configured with --git-repo, --git-branch, and --git-path.

      For quick creation and development, the default nocobase storage is usually enough. Use git when the Portal source should be reviewed, versioned, or built through an existing team workflow.

      Source configuration is written to portal.config.json in the local workspace. create, pull, and config maintain this file; push and deploy read it to sync source or deployment output.

      Env Types

      nb portal currently supports local, docker, and http envs:

      ModeDescription
      localThe workspace and app storage are on the current machine. With default nocobase storage, pull/push usually do not need extra sync.
      dockerThe workspace is shared with the app through a Docker volume. With default nocobase storage, pull/push usually do not need extra sync.
      httpSource and deployment output are synced through APIs. pull downloads a source archive, and push uploads one.

      ssh envs do not support Portal management in the current version.

      Local Workspace Path

      Portals are stored under the selected env storage:

      <storagePath>/portals/<app>/<portal>

      The main app access path is usually:

      <appPublicPath>/x/<portal>/

      A sub-app access path is usually:

      <appPublicPath>/x/apps/<app>/<portal>/

      Env Confirmation

      Most nb portal subcommands support --env and --yes:

      ParamètreDescription
      --env, -eCLI env name. If omitted, the current env is used.
      --yes, -ySkip cross-env confirmation when an explicit --env targets a different env from the current env.

      In scripts or AI agent workflows, pass --env and --yes explicitly to avoid stopping at an interactive confirmation.

      Commandes liées