TeamCity On-Premises 2026.2 Help

Python

Python ビルドランナーはエージェント上で Python を自動的に検出し、Windows、Linux、macOS 上で Python スクリプトを実行できるようにします。

一般的なビルドステップの設定については、 ビルドステップの設定を参照してください。 Docker コンテナー内でこの手順を実行する方法については、 コンテナーラッパー を参照してください。

コマンド設定

次の Python コマンドのいずれかを選択できます。

コマンド

説明

入力例

ファイル

指定されたパスを介して Python スクリプトを実行します。

scripts/test.py

モジュール

指定された名前を介して Python モジュール(英語)を実行します(モジュール名の前に -m を追加するのと同じです)。

example-module

カスタムスクリプト

UI フォームに Python スクリプトの本文を入力できます。

ips = {} fh = open("/var/log/nginx/access.log", "r").readlines() for line in fh: ip = line.split(" ")[0] if 6 < len(ip) <=15: ips[ip] = ips.get(ip, 0) + 1 print ips

Unittest

unittest(英語) フレームワークを起動します。 ユニットテストの結果は、 ビルド結果テスト タブに表示されます。

処理されたファイルのスコープをフィルタリングするために、追加の引数で単体テストファイルへのパスを指定できます。

必要に応じて、引数として tests/*.py を入力し、単体テストフレームワークを介して テスト ディレクトリ内のすべての Python ファイルを起動します。

Pytest

pytest(英語) フレームワークを起動します。 テスト結果は、 ビルド結果テスト タブに表示されます。

処理されたファイルのスコープをフィルタリングするために、追加の引数で pytest ファイルへのパスを指定できます。

必要に応じて、引数として tests/*.py を入力し、pytest フレームワークを介して テスト ディレクトリ内のすべての Python ファイルを起動します。

Flake8

Flake8(英語) ラッパーを起動します。 コードインスペクションの結果は、 ビルド結果コードインスペクション タブに表示されます。

処理されたファイルのスコープをフィルタリングするために、追加の引数で Python ファイルへのパスを指定できます。

必要に応じて、引数として docs/conf.py を入力して、 conf.py ファイルのエラーをチェックします。

Pylint

Pylint(英語) ツールを起動します。 コードインスペクションの結果は、 ビルド結果コードインスペクション タブに表示されます。

処理されたファイルのスコープをフィルタリングするには、追加の引数で Python ファイルへのパスを指定します。

scripts ディレクトリ内のすべての Python ファイルにエラーがないかチェックするには、引数として scripts/*.py を入力します。

カスタム

Python インタープリターの引数(たとえば、 python3 arg1 arg2)。 カスタムの引数セットを入力する場合は、このコマンドを使用します。

ステップが仮想環境で起動された場合、これらの引数は環境内の python コマンド(たとえば、 python3 -m pipenv run python arg1 arg2 )に適用されます。

arg1 arg2

使用可能な設定のセットは、選択したコマンドによって異なります。 次の表に、すべてのコマンド設定を示します。

設定

説明

ファイル

Python スクリプトファイルへのパス。

モジュール

Python モジュールファイルへのパス。

インストールツール

このオプションを選択すると、選択したツールパッケージ (Pytest、Flake8、Pylint) がビルドエージェントにない場合に自動的にインストールされます。

スクリプトまたはモジュールの引数

呼び出し後にユーザースクリプトまたはモジュールに渡される引数。

スクリプト

カスタムスクリプト本体。

テストレポート

自動的にインストールされた teamcity-messages (英語) パッケージを介してテストレポートを有効にします。 TeamCity は サービスメッセージ経由でテストレポートを受信し、ビルドログに表示します。

カバレッジ

Coverage.py(英語) を介したコードカバレッジ収集を有効にします。 TeamCity は、生成されたテストレポートを コードカバレッジ タブに表示します。

Python 引数

カスタムコマンドが選択された場合に Python インタープリターに渡される引数。

Python 実行可能ファイル設定

この設定ブロックでは、実行する Python バージョンを選択できます。

Python ランナーは、 ビルドエージェントにインストールされている Python バージョンを自動的に検出します。 ランナーは次の場所をチェックします (以下にリストされている順序と同じ)。

Windows の場合:

  1. デフォルトのインストールパス

  2. システムレジストリ

  3. パス 変数

Linux および macOS の場合:

  1. デフォルトのインストールパス

  2. パス 変数

ランナーは、最初に検出された Python 2.x および 3.x のバージョンをエージェントの構成パラメーターとして設定します。 または、インストールされているバージョンへのパスを手動で指定することもできます。

カスタム Python パス

このビルドステップのすべての Python 実行(たとえば、カスタム環境ツールの実行またはレポートの実行)でインタープリターに渡される引数を指定することもできます。

環境ツール設定

オプションで、仮想環境で Python ビルドステップを実行できます。 Python ランナーは、次のツールをサポートしています。

Pipenv 設定

オプションで、 install run arguments (英語) を入力します。

Poetry 設定

必要に応じて、 インストール実行引数(英語)と、ビルドエージェントにインストールされている Poetry へのカスタム実行可能パスを入力します。

この環境ツールに対して poetry install コマンドが実行されます。 作業ディレクトリにある pyproject.toml ファイルで指定された依存関係を解決します。 正しく解析するには、このファイルに tool.poetry セクションが含まれている必要があります。

Venv および virtualenv 設定

Venv(英語)virtualenv(英語) のは、以下の設定があります。

設定

説明

requirements ファイル

requirements ファイルまたはファイルの改行で区切られたリストへのパス。

Pip インストール実行引数

pip install run コマンドの追加の引数。

環境名

仮想環境の名前。

Venv/virtualenv 作成引数

新しい 環境 コマンドを作成するための追加の venv/virtualenv 引数。

2026 年 9 月 11 日