Node.js
Node.js ビルドランナーを使用すると、 npm (英語)、 yarn (英語)、 node (英語) などの Node.js ツールを実行できます。
一般的なビルド手順の設定の説明については、ビルドステップの設定を参照してください。
前提条件
現在、Node.js ステップは Docker/Podman コンテナー内でのみ実行できます。利用可能な Docker/Podman 設定に関する一般的な情報については、コンテナーラッパーを参照してください。
現在のビルドステップで使用する Node.js のバージョンを定義できます。TeamCity はデフォルトで node:lts イメージを使用します。または、プロジェクト内に .nvmrc ファイルがある場合、TeamCity はビルドステップの作成中にそこからイメージ仕様を自動的に検出します。
JavaScript ステップの自動検出
リポジトリに package.json ファイルが含まれている場合、TeamCity は使用されているフレームワークを自動的に検出し、それぞれのビルドステップを追加することを提案します。
現在サポートされているフレームワークは、ESlint(英語)、Jest(英語)、Mocha(英語) です。
TeamCity が .nvmrc ファイルを検出すると、そのファイルで指定されたノードバージョンが自動的に使用されます。
Node.js コマンドの実行
シェルスクリプトフィールドに、このステップで実行するすべての Node.js コマンドを入力します。
プライベート NPM レジストリへのアクセス
ビルド中にプライベート npm レジストリにアクセスするには(たとえば、パッケージをダウンロードするため)、次のことを行う必要があります。
ここで説明されているように、NPM レジストリ接続を構成します。
構成設定を開き、機能を構築する設定タブに移動します。
NPM レジストリ接続ビルド機能を追加し、手順 1 で作成した接続を選択します。
その結果、TeamCity エージェントは、ビルド中にこのレジストリで認証されます。
Alternatively to this procedure, you can let TeamCity parse a token from the .npmrc file inside your JS project. To achieve this, declare a token variable in this file as specified here(英語) and then create an environment variable NPM_TOKEN in TeamCity with the value of the access token and the "Password" type.
関連ページ:
ビルドステップの設定
ビルドステップは、CI/CD ワークフローの最小単位です。ビルドステップは、全体として実行される一連のアクションを定義します。ビルドステップは、ビルド構成とパイプラインジョブに属します。構成とパイプラインのビルドステップ:TeamCity は、.NET、Maven、NAnt、Xcode などの特定のビルドツール用に設計された幅広いビルドステップを提供します。現在、ビルド構成ではすべてのステップが利用可能です。バージョン 2025.07 で導入された
コンテナーラッパー
コンテナーラッパー拡張機能を使用すると、指定された Docker/Podman イメージ内でビルドステップを実行できます。ビルドを実行するエージェントにインストールされているコンテナーマネージャーに応じて、イメージはまたはコマンドによってプルされます。TeamCity は、コンテナーを匿名でプルできます (イメージが公開されている場合)。または、レジストリにログインした後でプルできます (プライベートレジストリの場合、または匿名ダウンロードに対する DockerHub のペナルティを回避する場合...
プロジェクト管理者ガイド
このセクションでは、プロジェクト管理に焦点を当てます。TeamCity プロジェクトとビルド構成の作成、ビルドステップの設定、依存関係チェーンの構成などについて説明します。基本的な TeamCity ワークフロー:次のダイアグラムは、基本的な TeamCity ワークフローを示しています。TeamCity サーバーはリポジトリの変更を検出しました。サーバーはこの変更をデータベースに書き込みます。ビルド構成に添付されたトリガーは、データベース内の関連する変更を検出し、ビルドを開始します。トリガー...
ビルドパラメーターの設定
パラメーターは、TeamCity 設定およびビルドスクリプトの構文を介して参照するペアです。パラメーター部分は、生の値 () にすることも、別のパラメーターへの参照 () を含めることもできます。パラメーター型:TeamCity は次の 3 種類のパラメーターをサポートします。構成パラメーター — ビルド構成内で設定を共有することを主な目的とするパラメーター。これらのパラメーターを使用して、テンプレートから作成された構成やレシピを使用する構成をカスタマイズすることもできます。TeamCity は...