• Bahasa Indonesia

      • nb portal

      nb portal mengelola workspace Portal. Portal dapat memiliki source frontend, jalur masuk, dan output deployment sendiri; grup perintah ini menghubungkan record Portal di NocoBase dengan workspace lokal dan source storage.

      Alur umum adalah membuat workspace lokal, menjalankan mode pengembangan, mendorong perubahan source ke source storage, lalu build dan deploy. Jika mengambil alih Portal yang sudah ada, jalankan pull terlebih dahulu.

      Penggunaan

      nb portal <command>

      Subperintah

      PerintahDeskripsi
      nb portal configMemperbarui konfigurasi source workspace Portal lokal dan menyinkronkannya ke record Portal remote jika memungkinkan
      nb portal createMembuat workspace Portal lokal dari template dan membuat atau memperbarui record Portal
      nb portal deployBuild dan deploy workspace Portal yang ditentukan
      nb portal destroyMenghapus record Portal dan workspace lokal
      nb portal devMemulai mode pengembangan untuk workspace Portal yang ditentukan
      nb portal infoMenampilkan detail record Portal dan workspace lokal yang ditentukan
      nb portal listMenampilkan daftar record Portal dan status sinkronisasi workspace lokal
      nb portal pullMenarik source Portal dari source storage ke workspace lokal
      nb portal pushMendorong perubahan source Portal lokal ke source storage

      Alur Umum

      Membuat Portal bernama customer:

      nb portal create customer -e dev --yes

      Menjalankan mode pengembangan lokal:

      nb portal dev customer -e dev --yes

      Memeriksa workspace lokal dan record remote:

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

      Push source dan deploy:

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

      Mengambil alih Portal yang sudah ada:

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

      Mengganti 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

      Saat membuat Portal, pilih tempat source code dikelola:

      ModeDeskripsi
      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:

      ModeDeskripsi
      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:

      ParameterDeskripsi
      --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.

      Perintah terkait