Python
Python ビルドランナーはエージェント上で Python を自動的に検出し、Windows、Linux、macOS 上で Python スクリプトを実行できるようにします。
一般的なビルド手順の設定の説明については、ビルドステップの設定を参照してください。Docker コンテナー内でこの手順を実行する方法については、コンテナーラッパーを参照してください。
コマンド設定
次の Python コマンドのいずれかを選択できます。
コマンド | 説明 | 入力例 |
|---|---|---|
ファイル | 指定されたパスを介して Python スクリプトを実行します。 |
|
モジュール | 指定された名前を介して Python モジュール(英語)を実行します（モジュール名の前に |
|
カスタムスクリプト | 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(英語) フレームワークを起動します。ユニットテストの結果は、ビルド結果のテストタブに表示されます。 処理されたファイルのスコープをフィルタリングするために、追加の引数で単体テストファイルへのパスを指定できます。 | 必要に応じて、引数として |
Pytest | pytest(英語) フレームワークを起動します。テスト結果は、ビルド結果のテストタブに表示されます。 処理されたファイルのスコープをフィルタリングするために、追加の引数で pytest ファイルへのパスを指定できます。 | 必要に応じて、引数として |
Flake8 | Flake8(英語) ラッパーを起動します。コードインスペクションの結果は、ビルド結果のコードインスペクションタブに表示されます。 処理されたファイルのスコープをフィルタリングするために、追加の引数で Python ファイルへのパスを指定できます。 | 必要に応じて、引数として |
Pylint | Pylint(英語) ツールを起動します。コードインスペクションの結果は、ビルド結果のコードインスペクションタブに表示されます。 処理されたファイルのスコープをフィルタリングするには、追加の引数で Python ファイルへのパスを指定します。 | |
カスタム | Python インタープリターの引数（たとえば、 ステップが仮想環境で起動された場合、これらの引数は環境内の |
|
使用可能な設定のセットは、選択したコマンドによって異なります。次の表に、すべてのコマンド設定を示します。
設定 | 説明 |
|---|---|
ファイル | Python スクリプトファイルへのパス。 |
モジュール | Python モジュールファイルへのパス。 |
インストールツール | このオプションを選択すると、選択したツールパッケージ (Pytest、Flake8、Pylint) がビルドエージェントにない場合に自動的にインストールされます。 |
スクリプトまたはモジュールの引数 | 呼び出し後にユーザースクリプトまたはモジュールに渡される引数。 |
スクリプト | カスタムスクリプト本体。 |
テストレポート | 自動的にインストールされた |
カバレッジ | Coverage.py(英語) を介したコードカバレッジ収集を有効にします。TeamCity は、生成されたテストレポートをコードカバレッジタブに表示します。 |
Python 引数 | カスタムコマンドが選択された場合に Python インタープリターに渡される引数。 |
Python 実行可能設定
この設定ブロックでは、実行する Python バージョンを選択できます。
Python ランナーは、ビルドエージェントにインストールされている Python バージョンを自動的に検出します。ランナーは次の場所をチェックします (以下にリストされている順序と同じ)。
Windows の場合:
デフォルトのインストールパス
システムレジストリ
PATH変数
Linux および macOS の場合:
デフォルトのインストールパス
PATH変数
ランナーは、最初に検出された Python 2.x および 3.x のバージョンをエージェントの構成パラメーターとして設定します。または、インストールされているバージョンへのパスを手動で指定することもできます。
このビルドステップのすべての Python 実行（たとえば、カスタム環境ツールの実行またはレポートの実行）でインタープリターに渡される引数を指定することもできます。
環境ツールの設定
オプションで、仮想環境で Python ビルドステップを実行できます。Python ランナーは、次のツールをサポートしています。
Pipenv 設定
オプションで、install run arguments (英語) を入力します。
Poetry 設定
必要に応じて、インストール実行引数(英語)と、ビルドエージェントにインストールされている Poetry へのカスタム実行可能パスを入力します。
この環境ツールに対して poetry install コマンドが実行されます。作業ディレクトリにある pyproject.toml ファイルで指定された依存関係を解決します。正しく解析するには、このファイルに tool.poetry セクションが含まれている必要があります。
Venv と virtualenv の設定
Venv(英語) と virtualenv(英語) のは、以下の設定があります。
設定 | 説明 |
|---|---|
requirements ファイル | requirements ファイルまたはファイルの改行で区切られたリストへのパス。 |
Pip インストール実行引数 | |
環境名 | 仮想環境の名前。 |
Venv/virtualenv 作成引数 | 新しい |
関連ページ：
ビルドステップの設定
ビルドステップは、CI/CD ワークフローの最小単位です。ビルドステップは、全体として実行される一連のアクションを定義します。ビルドステップは、ビルド構成とパイプラインジョブに属します。構成とパイプラインのビルドステップ：TeamCity は、.NET、Maven、NAnt、Xcode などの特定のビルドツール用に設計された幅広いビルドステップを提供します。現在、ビルド構成ではすべてのステップが利用可能です。バージョン 2025.07 で導入された
コンテナーラッパー
コンテナーラッパー拡張機能を使用すると、指定された Docker/Podman イメージ内でビルドステップを実行できます。ビルドを実行するエージェントにインストールされているコンテナーマネージャーに応じて、イメージはまたはコマンドによってプルされます。TeamCity は、コンテナーを匿名でプルできます (イメージが公開されている場合)。または、レジストリにログインした後でプルできます (プライベートレジストリの場合、または匿名ダウンロードに対する DockerHub のペナルティを回避する場合...
ビルド結果ページ
TeamCity では、ビルドに関するすべての情報 (キューに入っているか、実行中か、完了しているかに関係なく) がビルド結果ページに蓄積されます。ビルド結果を表示するには、任意の構成を選択してビルド履歴を表示し、必要なビルド番号をクリックします。このページには、いくつかの静的タブ (概要、変更、ビルドログ、アーティファクトなど) と、特定の構成機能に応じて表示が決まるコンテキストタブが含まれます。例: 依存関係タブは、親構成がビルドチェーンに属するビルドに対してのみ表示されます。内部ビルド ID...
サービスメッセージ
サービスメッセージは、ビルドに関するコマンド / 情報をビルドスクリプトから TeamCity サーバーに渡す特別に構成されたテキストです。TeamCity、それらはビルドの標準出力ストリームに書き込まれる必要があり、ビルドステップから出力またはエコーされますによって処理されます。例:echo ##teamcity[<messageName> 'value']echo
TeamCity エージェントをインストールして開始する
TeamCity ビルドエージェントは、TeamCity サーバーからのコマンドをリッスンし、実際のビルドプロセスを開始するソフトウェアです。実稼働の TeamCity セットアップでは、専用のマシンに追加のビルドエージェントをインストールする必要があります。その前に、エージェントとサーバー間の通信、システム要件、競合するソフトウェア、およびセキュリティに関する注意事項を必ず参照してください。Tomcat サーブレットコンテナーにバンドルされた TeamCity をインストールするか、Window...