Jenkins から TeamCity への移行ガイドライン

どちらのツールも、ビルドとデプロイワークフローを構造化する方法としてパイプラインをサポートしています (ただし、使用する用語とアプローチは若干異なります)。

TeamCity と Jenkins はどちらも、プラグインや拡張機能を通じて高度に構成およびカスタマイズ可能です。

どちらのツールも、Docker を含むコンテナーベースのワークフローとの統合をサポートしています。

設定形式。Jenkins は、宣言型パイプライン（Groovy ベースのファイル）またはスクリプト型パイプライン（Jenkins DSL）を使用します。TeamCity では、ビルドルーチンを UI 経由で設定するか、Kotlin ベースの設定スクリプトを使用するか、あるいはその両方を組み合わせて設定するかを常に選択できます。

ホスティングオプション。TeamCity は、セルフホスト型ソリューションと SaaS（JetBrains がホストするクラウドインスタンス経由）の両方を提供しています。Jenkins は完全にセルフホスト型であり、ユーザーは独自のインフラストラクチャを管理する必要があります。

セットアップとメンテナンスの容易さ。TeamCity は、よりユーザーフレンドリーなセットアッププロセスと洗練されたインターフェースを標準装備しています。クラウドエージェントのセットアップからサーバーノードの管理、クリーンアップルールの設定まで、あらゆる設定タスクを TeamCity UI から直接実行できます。さらにユーザー中心のソリューションをお探しなら、TeamCity パイプラインをお試しください。わずか数クリックでビルドルーチンを設定できます。Jenkins は通常、より手動でのセットアップと設定が必要で、プラグインに大きく依存しているため、メンテナンスのオーバーヘッドが増加する可能性があります。

組み込み機能とプラグイン。TeamCity には、ビルドエージェント、テストフレームワーク、コード品質チェック、レポートツールの管理のための組み込みサポートが含まれています。Jenkins の機能はサードパーティ製プラグインに大きく依存しており、同様の機能を実現するには別途プラグインを選択して設定する必要があります。

開発ツールとの統合。TeamCity は JetBrains によって開発されているため、IntelliJ IDEA やその他の JetBrains IDE などの開発ツールのエコシステムと緊密に統合されています。Jenkins は多くのツールとの統合を提供していますが、通常、これらの接続を設定するにはプラグインやカスタム設定が必要です。

コスト。TeamCity の無料利用枠では、ビルドエージェントと構成の数に制限があり、スケールアップには追加コストがかかります。Jenkins はオープンソースであるため、初期費用はかかりませんが、ホスティングとプラグインのメンテナンスは運用コストとして考慮する必要があります。

Jenkins は Groovy で記述された Jenkinsfile を使用します。これはコード内でパイプラインのステップを定義します。

TeamCity は Kotlin または XML 設定ファイルを使用します。TeamCity は UI で設定されたプロジェクトから設定を自動生成し、IDE をフルサポートしてローカルで編集できます。設定ファイルは、ビルドされたプロジェクトと一緒に保存することも、完全に独立したリモートリポジトリに保存することもできます。

Jenkins ジョブは、UI を介して構成されるか、Jenkinsfile でスクリプトまたは宣言型パイプラインとして定義されます。

ビルド構成によって生成されたビルドは、親プロジェクトによって所有されます。各構成には、複数のステップ、トリガー、パラメーターなどを含めることができます。

Jenkins 変数は、環境ブロックまたはパイプラインスクリプト内の params {} を通じて設定されます。UI でも設定できます。

TeamCity は、ビルド構成、プロジェクト、グローバルに定義されたパラメーターを使用します。これには、エージェントのマシンに渡される環境変数や構成パラメーターが含まれます。パラメーターは、他の構成と共有することも（出力パラメーター）、非公開にすることもできます（入力パラメーター）。

Jenkins は、宣言型パイプライン内の when {} ブロックまたはスクリプト型パイプライン内の Groovy を介した条件付き実行をサポートします。

TeamCity ステップの条件は、UI または Kotlin DSL で設定できます。幅広い条件をサポートしており、あるステップが成功した場合のみ、別のステップが失敗した場合のみ、特定のパラメーターに必要な値が設定されている場合にのみ実行するなど、様々な条件を設定できます。

Jenkins では、archiveArtifacts を使用してアーカイブするファイルを明示的に宣言する必要があります。

TeamCity UI、Kotlin DSL、または手動で送信されたサービスメッセージを使用して、ビルド中に生成されたファイルをアーティファクトとして公開できます。アーティファクトの依存関係を使用すると、公開されたアーティファクトをさまざまな構成間で共有できます。

Jenkins は、Docker パイプラインプラグインまたは Kubernetes プラグインを介して Docker をサポートしますが、インストールして構成する必要があります。

TeamCity には Docker と Podman の組み込みサポートが含まれており、Docker のステップ、エージェントイメージ、サービスコンテナーが含まれています。プラグインは必要ありません。

Jenkins エージェントは手動で設定および接続する必要があります（SSH、Docker など）。Kubernetes 経由のエージェントテンプレートではプラグインの設定が必要です。

TeamCity は、最小限の構成で、クラウドエージェント (JetBrains ホスト)、Docker ベースのエージェント、および従来のセルフホストエージェントをサポートします。

Jenkins は、スクリプトパイプライン内の並列ブロックまたは宣言型パイプライン内の並列ステージをサポートします。

TeamCity は、ビルド依存関係、テストのバッチ分割、エージェント側の並列処理を使用して、ビルドまたはビルドステップを並列に実行できます。

Jenkins はデフォルトでビルド結果をコンソールに出力します。プラグインを使用することで、タイムスタンプや色分けなどのログ機能を追加できます。検索とナビゲーション機能は制限されています。

TeamCity は、タイムスタンプとハイライト表示機能を備えたリアルタイムログストリーミング、Prometheus 形式のサーバー負荷メトリクス、ビルドステップごとのアーカイブ履歴を提供します。TeamCity は、Dynatrace、Grafana などのサードパーティ製オブザーバビリティソリューションと統合可能です。