#アプリケーションの管理

NocoBase アプリケーションを CLI 環境として保存した場合、日常の管理は基本的に nb app グループのコマンド (開始、停止、再起動、ログの表示、アップグレード) で完了します。

ほとんどの場合、すべてのパラメータを覚えておく必要はありません。まず、やりたいことが「アプリケーションを実行する」か、「ログを読んで問題を解決する」か、「新しいバージョンにアップグレードする」かを明確にしてから、対応するコマンドを選択します。

nb app がこのコマンド セットに統合されている理由と、nb app autostart との関係を最初に理解したい場合は、まず nb アプリの設計意図 を読んでください。このページには、最も一般的な日常操作のみが保持されます。

クイックインデックス

欲しいです...どのコマンドを使用するか
アプリケーション操作の開始または再開nb app start
アプリケーションを一時的に停止するnb app stop
CLI 管理の組み込みデータベースとともに停止するnb app stop --with-db
構成を変更した後、アプリケーションを再起動します。 nb app restart
アプリケーション ログをリアルタイムで表示するnb app logs
新しいソースまたはイメージ バージョンにアップグレードするnb app upgrade
まず現在の環境を確認してください

nb app コマンドは、デフォルトで現在の環境に作用します。複数の環境を同時に維持する場合、デフォルトでは、操作を開始、停止、ログ記録、またはアップグレードする前にターゲット環境を確認することをお勧めします。

別の --env を明示的に渡すと、通常、CLI は確認を求めます。スクリプトまたは非対話型シナリオでは、--yes を追加してこの手順をスキップできます。複数環境の切り替え、表示、および削除は、複数環境管理 で導入されています。

アプリケーションを開始する

アプリケーションを起動し、デフォルトで nb app start を使用します。

nb app start

現在の環境以外のものを操作したい場合は、それを明示的に指定できます。

nb app start --env app1 --yes

その他の一般的に使用される起動パラメータは次のとおりです。

  • nb app start デフォルトでは、必要なインストールまたはアップグレードの準備が最初に自動的に完了し、その後サービスが開始されます。

ローカルの npm/Git 環境はローカル アプリケーション プロセスを開始し、Docker 環境は保存された構成に従ってアプリケーション コンテナを再構築します。詳細なパラメーターについては、nb app start を参照してください。

停止して再起動します

アプリケーションを一時的に停止したいだけの場合は、nb app stop を使用します。

nb app stop

構成、依存関係、またはコードを変更したばかりの場合は、通常、nb app restart を直接使用する方が簡単です。

nb app restart
nb app restart --env app1 --yes

nb app restart は最初に停止され、start と同じ方法で再起動されます。詳しい使用方法については、nb app stop および nb app restart を参照してください。

ログを表示する

問題のトラブルシューティングを行うときは、通常、最初にログを確認します。

nb app logs

より最近の出力を確認したいだけの場合、またはログの追跡を続行したくない場合は、これを使用できます。

nb app logs --tail 200
nb app logs --no-follow
nb app logs --env app1 --yes

ローカルの npm/Git 環境は pm2 ログを読み取り、Docker 環境はコンテナー ログを読み取ります。デフォルトでは、nb app logs は引き続き新しいログ出力を追跡します。詳細なパラメーターについては、nb app logs を参照してください。

アプリケーションをアップグレードする

アップグレード コマンドは nb app upgrade です。

nb app upgrade

このコマンドは、単に「新しいバージョンをダウンロードする」だけではありません。通常、デフォルトのプロセスには次のものが含まれます。

  1. 現在のアプリケーションを停止します
  2. 保存したソースコードまたはイメージをダウンロードして置き換えます
  3. 商用プラグインを同期する
  4. アプリケーションをアップグレードして起動します 5.env ランタイム情報を更新する

事前にソース コードまたはイメージを更新しており、アップグレードを続行して現在のコンテンツに基づいてアプリケーションを開始したい場合は、--skip-download を追加できます。

nb app upgrade --skip-download

ターゲット バージョンを明示的に指定する場合は、--version を追加することもできます。

nb app upgrade --version beta

:::警告メモ

nb app upgrade 通常、実際に開始する前に一度確認を求められます。スクリプト、CI、またはその他の非対話型シナリオでは、--force を明示的に渡す必要があります。複数の環境を同時に操作する場合は、通常、--yes をまとめる必要があります。

nb app upgrade --env app1 --yes --force

:::

より完全なパラメーターの説明については、nb app upgrade を参照してください。

関連リンク