C# スクリプト
C# スクリプトランナーを使用すると、Windows、Linux、macOS で C# スクリプトを実行できます。 複数のプラットフォームで C# 対話シェルを実行するためのカスタム TeamCity ツールを使用します。
このランナーを使用すると、ビルド環境の準備、OS ユーザーの作成、さまざまなメッセンジャーへのレポートなど、さまざまなサービスタスクを実行できます。
一般的なビルドステップの設定については、 ビルドステップの設定を参照してください。 このステップをコンテナー内で実行する方法については、 コンテナーラッパー を参照してください。
前提条件
ランナーの要件:
.NET ランタイム 6.0.0 以降がビルドエージェントにインストールされているか、このステップが Docker 内で実行される場合は Docker コンテナーで利用可能である必要があります。
TeamCity.csi パッケージは、 エージェントツールとしてインストールされている必要があります。
C# スクリプト設定
設定 | 説明 |
|---|---|
TeamCity C# スクリプトツール | 管理 | ツール 経由でインストールされた TeamCity C# スクリプトツールのバージョンを選択するか、 ビルドチェックアウトディレクトリを基準としたこのツールへのカスタムパスを入力します。 |
スクリプトタイプ | 二つのオプションのいずれかを選択します: ランナー内でカスタムスクリプト本文を直接入力するか、C# スクリプトファイルへのパス ( |
C# スクリプト | カスタムスクリプト タイプで使用できます。 C# スクリプトのコードを入力します。 |
C# スクリプトファイル | スクリプトファイル タイプで使用できます。 スクリプトファイルへのパスを、 ビルドチェックアウトディレクトリを基準にして入力します。 |
スクリプトパラメーター | スクリプトのパラメーターを入力します。 パラメーターは パラメーター参照がサポートされています。 |
NuGet パッケージソース | スクリプトから パッケージを参照する場合、TeamCity はこのフィールドで指定されたフィードからそのパッケージを自動的にダウンロードします。 ランナーは、 デフォルトでは、TeamCity は NuGet.org で公開されたソースから NuGet パッケージを復元します。 このフィールドでは、他の NuGet リポジトリへのパスを指定でき、TeamCity は宣言の順序に従ってそこでパッケージを検索します。 指定されたリポジトリのいずれにもパッケージソースが見つからない場合、TeamCity は NuGet.org で検索します。 プライベートリポジトリにアクセスできるようにするには、 NuGet フィード資格情報を設定します。 TeamCity 内部フィードを参照することもできます。 |
スクリプトでサポートされるコマンドと引数
サポートされているコマンド:
コマンド | 説明 | サンプル |
|---|---|---|
| NuGet パッケージまたはアセンブリとその依存関係への参照を追加します。 |
|
| 指定されたスクリプトファイルをロードして実行します。 |
|
| 使用可能なコマンドとキーバインディングに関するヘルプを表示します。 | |
| 詳細レベルを |
サポートされている引数:
スクリプトパラメーターフィールドに提供され、
引数者向けなら配列に格納される 引数 (たとえば、最初のスクリプトパラメーターの値を書き込む場合はWriteLine(Args[0]))。システムパラメーター は ビルド構成設定 | パラメーター で指定され、
Propsディクショナリに格納されます (たとえば、WriteLine(Props["version"])はsystem.versionパラメーターの値を書き込むために使用します)。