nx-run-tasks

Nx では、次のようにタスクを実行できます。

ユーザーが nx をグローバルにインストールしていない場合は、コマンドの前に npx/pnpx/yarn を付ける必要があることに注意してください。どのパッケージマネージャーが使用されているかは、package.json またはロックファイルで確認してください。

各コマンドの詳細を確認するには、--help を付けて実行してください（例：nx run-many --help、nx affected --help）。

実行可能なタスクを確認する

タスクは nx show project <projectname> --json で確認できます。たとえば、nx show project myapp --json のように実行します。出力には、実行可能なターゲットに関する情報を含む targets セクションがあります。package.json のスクリプトや project.json のターゲットを確認する方法もありますが、Nx プラグインによって推測されるタスクを見落とす可能性があります。

単一のタスクを実行する

nx run <project>:<task>

ここで project は、package.json または project.json（存在する場合）で定義されているプロジェクト名です。

複数のタスクを実行する

nx run-many -t build test lint typecheck

-p フラグを指定すると、特定のプロジェクトに絞り込めます。指定しない場合は、すべてのプロジェクトで実行されます。--exclude でプロジェクトを除外したり、--parallel で並列プロセス数を指定したりすることもできます（デフォルトは 3 です）。

例：

• nx run-many -t test -p proj1 proj2 — 特定のプロジェクトをテストします
• nx run-many -t test --projects=*-app --exclude=excluded-app — パターンに一致するプロジェクトをテストします
• nx run-many -t test --projects=tag:api-* — タグでプロジェクトを選択してテストします

変更の影響を受けるプロジェクトのタスクを実行する

nx affected を使うと、変更されたプロジェクトと、変更されたプロジェクトに依存するプロジェクトに対してのみタスクを実行できます。これは CI や大規模なワークスペースで特に便利です。

nx affected -t build test lint

デフォルトでは、ベースブランチと比較します。次のようにカスタマイズできます。

• nx affected -t test --base=main --head=HEAD — 特定のベースとヘッドを比較します
• nx affected -t test --files=libs/mylib/src/index.ts — 変更されたファイルを直接指定します

便利なフラグ

これらのフラグは run、run-many、affected で使用できます。

• --skipNxCache — 結果がキャッシュされていてもタスクを再実行します
• --verbose — スタックトレースなどの追加情報を出力します
• --nxBail — 最初に失敗したタスクの後で実行を停止します
• --configuration=<name> — 特定の構成を使用します（例：production）