# パイプライン ## はじめに -------------------------------------------------------------------------------- title: "はじめに" description: "Catalyst Pipelinesサービスについて学び、アプリケーションのCI/CDワークフローを効率化する方法を理解しましょう。" last_updated: "2026-09-09T11:06:45.809Z" source: "https://docs.catalyst.zoho.com/ja/pipelines/getting-started/introduction/" service: "Pipelines" -------------------------------------------------------------------------------- # はじめに # イントロダクション Pipelinesは、Catalystが提供する継続的インテグレーションおよび継続的デリバリー（CI/CD）サービスであり、ソフトウェアの開発およびデプロイメントプロセスを効率化・自動化するのに役立ちます。Catalyst Pipelinesを使用すると、さまざまなプラットフォームやクラウド環境にわたって、アプリケーションを効率的にビルド、テスト、デプロイできます。スケーラブルなインフラストラクチャと、一般的なバージョン管理システムやその他のCatalystサービスとのシームレスな統合を提供することで、Pipelinesサービスは開発チームが手動介入を削減し、コラボレーションを向上させながら、高品質なソフトウェアをより迅速にデリバリーできるよう支援します。 詳細に入る前に、まずCI/CDの一般的な概念を確認しましょう。 ### 継続的インテグレーション 継続的インテグレーション（CI）は、ソースコードリポジトリへの更新が自動ビルドプロセスをtriggerするソフトウェア開発プラクティスです。このプロセスにより、継続的デリバリーパイプラインを通じて進行し、指定された環境にデプロイされるデプロイ可能なリリースアーティファクトが生成されます。 継続的インテグレーションの主な特徴は以下の通りです： **バージョン管理の統合** CIは、GitHub、GitLab、Bitbucketなどのバージョン管理システムとシームレスに統合されます。ソースコードリポジトリは継続的に監視され、統合システムにcommitがプッシュされるたびに、パイプラインは自動的にコンパイル、ビルド、テストプロセスを開始します。これにより、アプリケーションの最新バージョンが常に利用可能になります。 **自動ビルドとテスト** CIシステムは同時ビルドをサポートしており、ビルドの待ち時間を短縮し、全体的な開発プロセスを加速します。ビルドを並列に実行し、同時にテストすることで、複数のコード変更に対するフィードバックがより迅速に提供され、生産性が向上し、開発者が問題をより早く解決できるようになります。ビルドプロセスの後、CIシステムは新しいコードに対して一連のテストを自動的に実行し、問題やリグレッションを特定できます。 **即時フィードバック** 継続的インテグレーションは、コード変更に対する迅速なフィードバックを提供し、チームが開発サイクルの早い段階で問題を修正できるようにすることを目的としています。このプロセスにより、ソフトウェアの品質が向上し、リスクが最小化され、新機能のより迅速なデリバリーが促進されます。 ### 継続的デリバリー 継続的デリバリーは、継続的インテグレーション（CI）プロセスの上に構築され、デプロイ可能なリリースアーティファクトを取得し、選択された環境に自動的にデプロイします。このソフトウェアエンジニアリングアプローチは、ソフトウェアデリバリーパイプラインの自動化を重視し、最小限の手動介入で迅速なデプロイメントを保証します。 継続的デリバリーの主な特徴は以下の通りです： **自動デプロイメントと環境管理** 継続的デリバリーは、開発環境、テスト環境、ステージング環境、本番環境を含むさまざまな環境へのコード変更のデプロイメントを効率化し、一貫性のある信頼性の高いデプロイメント手順を保証します。異なる設定を持つ複数の環境を効率的に管理し、コード変更を本番環境にプッシュする前に、隔離された環境でデプロイおよびテストできるようにします。 **段階的な更新と市場投入までの時間短縮** CDは、本番環境への小規模で段階的な変更のスムーズなデリバリーを可能にします。更新を管理可能なセグメントに分割することで、CDは大規模なデプロイメントに伴うリスクを軽減します。このアプローチは、より迅速なフィードバックループを促進し、問題の迅速な特定と解決を可能にします。最終的に、継続的デリバリーは新機能や機能強化の市場投入までの時間を短縮し、エンドユーザーへの価値のより迅速なデリバリーを保証します。 ### Catalyst PipelinesにおけるCI/CD Catalyst PipelinesはCI/CDアプローチを採用し、お好みの環境へのアプリケーションのビルド、テスト、デプロイメントを自動化します。WebアプリケーションやモバイルアプリケーションにかかわらずCatalyst AppSail、Amazon S3、Google Cloud Platform、Heroku、Microsoft Azure、Firebaseなど、あらゆるプラットフォームに簡単にデプロイできます。プログラミング言語に関係なく、Catalyst Pipelinesはアプリケーションのビルドとデプロイメントのシームレスな自動化をサポートします。一般的なデプロイメントターゲットの例については、こちらのヘルプページをご確認ください。 Catalystエコシステムを以下の方法で最大限に活用できます： * Catalyst AppSailサービスを使用して、Catalystで任意のアプリケーションをデプロイします。 * Catalystアプリケーションをデプロイ し、Catalyst Serverless Functions コンポーネントを使用してCatalystクラウドに構築します。 いずれの場合も、Catalyst Pipelinesサービスを使用して、アプリケーションのビルド、テスト、デプロイメントのプロセス全体をシームレスに自動化できます。 パイプラインを作成 し、Catalystコンソールから直接操作できます。Catalyst Pipelinesは、catalyst-pipelines.yamlファイルに定義されたYAMLベースの宣言型コードに基づいて実行され、パイプラインの実行フローを定義する必要があります。特定のニーズに応じて、組み込みのYAML code editorまたはvisual builderを使用して必要なコンポーネントを追加し、フローを定義できます。パイプラインコンポーネントの詳細については、こちらのヘルプページをご確認ください。パイプラインの設定の詳細については、こちらのヘルプページを参照してください。 GitHub、GitLab、Bitbucketなど、お好みのGit providerとパイプラインを統合して、実行プロセスを自動化することもできます。このトピックについては、こちらのヘルプページで詳しく説明します。 また、アプリケーションにPipeline SDKメソッドを**Java**、**Node.js**、**Python**で実装し、パイプラインの詳細を取得してパイプラインを実行できます。 次のセクションで、パイプラインを使用する主な利点について理解しましょう。 -------------------------------------------------------------------------------- title: "メリット" description: "Catalyst Pipelinesサービスの主なメリットと、ソフトウェア開発ライフサイクルを効率化する方法について学びましょう。" last_updated: "2026-09-09T11:06:45.809Z" source: "https://docs.catalyst.zoho.com/ja/pipelines/getting-started/benefits/" service: "Pipelines" -------------------------------------------------------------------------------- # メリット **ソフトウェア開発ライフサイクルの迅速化** Catalyst Pipelinesは、コードのビルド、テスト、選択した環境へのデプロイのプロセスを自動化し、手動介入を最小限に抑え、エンドユーザーへの機能の迅速なデリバリーを可能にします。さらに、Catalyst Pipelinesは開発者に迅速なフィードバックを提供することで開発プロセスを加速し、より迅速な問題解決とイテレーション速度および改善の向上を促進します。 信頼性の確保とリスクの最小化 自動化されたデプロイメントプロセスとテスト手順を採用することで、Catalyst Pipelinesは本番環境への欠陥のあるコードのデプロイリスクを効果的に軽減します。この予防的な戦略により、サービスの中断やダウンタイムの可能性が最小化されます。自動化により、デプロイメント時のヒューマンエラーの可能性が大幅に低減され、信頼性の高いデリバリーが保証されます。最終的に、これらのプラクティスはデプロイされたソースコードの全体的な効率を向上させます。 **開発における汎用性** Catalyst Pipelinesは、多様なプログラミング言語、プラットフォーム、ツールのビルドプロセスを促進し、アプリケーションの開発、テスト、デプロイメントにおける適応性を提供します。 **簡単にカスタマイズ可能で再利用可能な設定** Catalyst PipelinesサービスはYAMLベースの宣言型構文を使用してパイプラインを定義し、ニーズに応じてパイプライン定義を再利用できます。Catalystコンソールの組み込みYAML code editorまたはvisual builderを使用して、パイプラインのワークフローを簡単にカスタマイズできます。 **コスト効率の良いスケールアップ** Catalyst Pipelinesは、スケーラブルなインフラストラクチャにより、小規模な個人プロジェクトから大規模なエンタープライズレベルのアプリケーションまで、あらゆるサイズと複雑さのプロジェクトを処理できます。これは、コードベースのサイズが比例して増加しても、ユーザー側のメンテナンス作業を増やすことなく、ワークフローの効率を維持することを意味します。自動化プロセスは、時間とリソースの面でのコスト削減への道を開きます。さらに、バグや問題の早期発見により、開発サイクルの後半でのコストのかかるやり直しを防ぐことができます。 **Catalystエコシステムにおけるワークフローの自動化** Catalyst Pipelinesは、Catalyst Serverless FunctionsやCatalyst AppSailなどの他のCatalystサービスとシームレスに統合され、Catalystエコシステム内でのアプリケーション開発、効率的なワークフロー自動化、およびデプロイメントを可能にします。 -------------------------------------------------------------------------------- title: "ユースケース" description: "Catalyst Pipelinesサービスの多様性と効率性を示す理想的なユースケースについて学びましょう。" last_updated: "2026-09-09T11:06:45.809Z" source: "https://docs.catalyst.zoho.com/ja/pipelines/getting-started/use-cases/" service: "Pipelines" -------------------------------------------------------------------------------- # ユースケース 以下は、Catalyst Pipelinesサービスの多様性と効率性を示す理想的なユースケースです： 1. **スタートアップのための迅速なイテレーション：** Webアプリケーションを開発するスタートアップにとって、スピードとアジリティは非常に重要です。Catalyst Pipelinesにより、小規模なチームは以下のことが可能になります： * 新機能やアップデートを迅速にデプロイする。 * 各デプロイメント前にテストを自動的に実行する。 * 問題が発生した場合に変更を簡単にロールバックする。 * 新しいアイデアを実験しながら、安定した本番環境を維持する。 これにより、スタートアップはコードの品質や安定性を犠牲にすることなく、市場の需要に対して競争力と即応性を維持できます。 2. **大規模エンタープライズデプロイメント：** 複数の環境にまたがる複雑なWebアプリケーションを管理するエンタープライズは、Catalyst Pipelinesを活用して以下のことが可能になります： * チームやプロジェクト全体でデプロイメントプロセスを標準化する。 * ステージング環境、開発環境、本番環境間のデプロイメントを調整する。 * A/Bテストやその他の一般的なテスト手法を大規模に管理する。 これにより、一貫性が確保され、ヒューマンエラーが削減され、大規模な組織のデプロイメントパイプラインが効率化されます。 3. **DevOps文化の実現：** DevOps文化への移行を進める組織は、Catalyst Pipelinesを使用して以下のことが可能になります： * 開発チームと運用チームの間のギャップを埋める。 * Infrastructure-as-Codeプラクティスを導入する。 * 反復的なデプロイメントタスクを自動化する。 * すべての関係者にリアルタイムのデプロイメントステータスとメトリクスを提供する。 これにより、コラボレーションが促進され、透明性が向上し、ソフトウェアデリバリーライフサイクルが加速されます。 4. **品質保証とテスト自動化：** QAチームは、Catalyst Pipelinesを活用して以下のことが可能になります： * デプロイメント前に包括的なテストスイートを自動的に実行する。 * さまざまなテストツール（ユニット、インテグレーション、パフォーマンス、セキュリティ）を統合する。 * テストレポートとコードカバレッジメトリクスを生成する。 * 重要なテストが失敗した場合にデプロイメントを防止する。 これにより、高品質なコードのみが本番環境に反映され、バグやセキュリティ脆弱性が導入されるリスクが軽減されます。 Catalyst Pipelinesは幅広いWebアプリケーションデプロイメントシナリオをサポートしており、可能性は無限です。小規模なスタートアップから大規模エンタープライズまで、シンプルなWebサイトから複雑なマイクロサービスアーキテクチャまで、Pipelinesサービスは効率的で信頼性が高く、スケーラブルなデプロイメントに必要なツールを提供します。 -------------------------------------------------------------------------------- title: "クイックスタートガイド" description: "Catalyst Pipelinesサービスを利用して、パイプラインの作成から設定、実行までのプロセスを学びましょう。" last_updated: "2026-09-09T11:06:45.809Z" source: "https://docs.catalyst.zoho.com/ja/pipelines/getting-started/quick-start-guide/" service: "Pipelines" -------------------------------------------------------------------------------- # クイックスタートガイド このセクションでは、パイプラインの作成からYAMLファイルで必要なコンポーネントを定義して設定し、パイプラインを実行するまで、Catalyst Pipelinesサービスを利用するプロセス全体を詳しく説明します。 手順を詳しく見てみましょう： 1. **Catalystプロジェクトを作成する:** Catalystコンソールにアクセスして、新しいプロジェクトを作成します。プロジェクトの作成が完了すると、コンソールでCatalyst Pipelinesサービスにアクセスできるようになります。コンソールからその他のCatalystサービスも確認できます。 2. **パイプラインを作成する:** Catalyst Pipelinesサービスでは、コンソールから直接パイプラインを作成できます。パイプラインの作成手順の詳細については、こちらのヘルプページを参照してください。 * **統合ソースを接続する** - パイプラインの作成時に、GitHub、GitLab、Bitbucketなどの任意のGit providerと統合することを選択できます。これを有効にするには、catalyst-pipelines.yamlファイルでパイプラインの実行フローを設定し、このファイルを統合されたGit providerのrepositoryにcommitする必要があります。この設定により、リンクされたrepositoryに変更がプッシュされるたびに、パイプラインが自動的にtriggerされます。パイプラインがtriggerされると、統合されたGit repositoryからの完全なソースコードとYAMLファイルが自動的に取得され、ZIPファイルとしてCatalystにダウンロードされます。この統合はオプションです。 注意: 外部repositoryと統合せずにパイプラインを作成することもできます。その場合、Catalystコンソールから毎回手動でパイプラインをtriggerする必要があります。 3. **パイプラインを設定する:** catalyst-pipelines.yamlで、要件に基づいてstages、jobs、runners、images、conditions、variablesなどの必要なコンポーネントを定義して、パイプラインの実行フローを設定できます。この目的のために、組み込みのYAML code editorまたはvisual builderを使用できます。パイプラインの設定の詳細については、こちらのページを参照してください。 4. **catalyst-pipelines.yamlファイルをコミットする:** この手順は、パイプラインの作成時にintegration sourceをリンクした場合にのみ適用されます。パイプラインの設定が完了したら、catalyst-pipelines.yamlファイルをsource repository内の任意のbranchにcommitする必要があります。YAMLファイルは、**ステップ2**で選択したintegration sourceのbranchにcommitされます。パイプラインフローに変更を加えるたびに、YAMLファイルをcommitすることが必須です。 注意：パイプラインをintegration sourceに接続していない場合は、この手順をスキップしてパイプラインの実行に進むことができます。 5. **パイプラインを実行する:** パイプラインの設定後、Catalystコンソールから直接実行を開始できます。パイプラインがintegration sourceにリンクされている場合、リンクされたrepositoryに変更がプッシュされるたびに自動的に実行されます。 さらに、コンソールの**Execution History**セクション内の**Basic**タブと**Advanced**タブを使用して、実行ステータスを監視し、パイプライン実行の詳細なログにアクセスできます。これについては、こちらのヘルプページで詳しく説明します。 ## ヘルプコンポーネント ### catalyst-pipelines.yaml -------------------------------------------------------------------------------- title: "はじめに" description: "Catalyst Pipelinesサービスと、YAMLスキーマ定義の基本について学びます。" last_updated: "2026-09-09T11:06:45.810Z" source: "https://docs.catalyst.zoho.com/ja/pipelines/help/catalyst-pipelines.yaml/introduction/" service: "Pipelines" related: - パイプライントリガー (/ja/pipelines/help/triggers/introduction) -------------------------------------------------------------------------------- # catalyst-pipelines.yaml # はじめに catalyst-pipelines.yamlファイルは、pipelineを実行するためのコアコンポーネントであり、そのワークフローを定義します。組み込みのコードエディターまたはvisual builderを使用して、必要なpipelineコンポーネントを追加することで、このファイルにpipelineの実行フローを定義できます。pipelineの設定方法の詳細については、こちらのヘルプページを確認してください。 pipelineが手動でトリガーされるか、自動でトリガーされるかにかかわらず、このファイルがpipelineのアクションを制御します。pipelineがバージョン管理システムにリンクされている場合、リンクされたrepositoryのsource codeに変更が加えられると、pipeline実行が自動的にトリガーされ、このファイルで定義されたワークフローが実行されます。同様に、pipelineがCatalystコンソールから手動でトリガーされた場合、このファイルはコンソールインターフェースから直接実行されます。 Catalyst Pipelinesの事前定義されたYAMLスキーマ定義とその使用方法について詳しく説明する前に、YAMLについて概要を見てみましょう。 YAMLファイルは、設定ファイル、データ交換、シリアライゼーションなど、さまざまなコンテキストで構造化データを表現するための汎用的なフォーマットです。 YAMLファイルの一般的な特徴は以下の通りです： * YAMLは特定のプログラミング言語に依存しないため、異なるシステムやプラットフォーム間でのデータ交換に適しています。 * このファイルは、シンプルなkey-value pairs、リスト、マップで構成されており、これらを組み合わせてネストすることで、複雑なデータ構造や設定を表現できます。 * インデントを使用してデータの構造を定義します。 * YAMLは、スカラー（文字列、整数、浮動小数点、ブール値、null）、リスト、マップ（key-value pairs）、ネストされた構造など、さまざまなデータ型をサポートしています。 Catalyst Pipelinesは独自のYAMLスキーマ標準に従っており、pipelineを設定する際にはこれを厳密に守る必要があります。次のセクションでは、CatalystのYAMLスキーマ定義についてさらに詳しく説明します。 -------------------------------------------------------------------------------- title: "スキーマリファレンス" description: "catalyst-pipelines.yamlファイルの事前定義されたスキーマ定義について詳しく学びます。" last_updated: "2026-09-09T11:06:45.810Z" source: "https://docs.catalyst.zoho.com/ja/pipelines/help/catalyst-pipelines.yaml/schema-reference/" service: "Pipelines" -------------------------------------------------------------------------------- # スキーマリファレンス Catalyst PipelinesのYAML schema referenceは、pipelineのさまざまなコンポーネントの事前定義されたキーを概説しています。これらのキーを使用して、必要なコンポーネントを組み込み、pipelineの実行フローを定義できます。 各コンポーネントの詳細については、それぞれのヘルプページで説明します。こちらから開始できます。CatalystコンソールからのPipelineの設定方法については、こちらのページを参照してください。 ### YAML定義 以下は、Catalystのcatalyst-pipelines.yamlファイルでサポートされているキーのリストです。 <table class="content-table"> <thead> <tr> <th>キーワード</th> <th>説明</th> </tr> </thead> <tbody> <tr> <td>version</td> <td>pipelineのバージョンは任意の整数値として定義でき、pipeline設定を個別の再利用可能なバージョンとして保持する目的で使用されます。</td> </tr> <tr> <td>runners</td> <td>runnerは、stageレベルまたはjobレベルで定義できる仮想マシン構成です。runnersのconfig-idキーの値としてrunner specificationを定義できます。詳細については、こちらのヘルプページを参照してください。</td> </tr> <tr> <td>images</td> <td>imageは、pipeline内のjobsの実行に必要なパッケージまたは依存関係のセットです。imagesはstageレベルまたはjobレベルで定義できます。 imageキーでimage nameを定義し、registryキーで外部パッケージレジストリ（Dockerhubなど）のURLを定義できます。 指定されたregistryを認証するためにauthキーも定義する必要があります。詳細については、こちらのヘルプページを参照してください。 </td> </tr> <tr> <td>auth</td> <td>外部registryアカウントを認証し、job実行に必要なパッケージをプルするには、authキーにusernameとpasswordキーを指定する必要があります。詳細については、こちらのヘルプセクションを参照してください。</td> </tr> <tr> <td>variables</td> <td>このキーワードは、pipelineレベルまたはjobレベルでプレースホルダー値を格納するために使用されます。詳細については、こちらのヘルプページを確認してください。</td> </tr> <tr> <td>steps</td> <td>pipeline内のビルド、テスト、デプロイプロセスを実行するために定義できるコマンドのセットです。ビルドするアプリケーション、そのテスト手順、およびアプリケーションをデプロイする環境に基づいてstepsを定義できます。stepsの詳細については、こちらのヘルプページを参照してください。</td> </tr> <tr> <td>jobs</td> <td>jobは、stage内で定義されたstepsのシーケンスです。stage内に最大5つのjobsを定義でき、各jobの下にjobsキーを使用してsteps、variables、runners、およびimagesを定義できます。 アプリケーションをテストまたはデプロイする前にビルドするようにpipelineを設定している場合、生成されたコードのビルドファイルをCatalyst Stratusサービスに一時的に保存できます。これらの設定はartifactsキーを使用して定義できます。 このキーには、notifyとapproveという2つのサブキーも含まれています。 詳細については、こちらのヘルプページを参照してください。 </td> </tr> <tr> <td>notify</td> <td>このキーを使用すると、job実行の開始時またはjobの正常完了時に通知を送信できます。この目的には、on-startまたはon-endキーを使用できます。詳細については、こちらのヘルプセクションを確認してください。</td> </tr> <tr> <td>approve</td> <td>このキーは、approval jobsでjobレビュアーの詳細とカスタム承認メッセージを定義するために使用されます。 type-nameサブキーを使用して承認タイプを設定し、type-variablesキーにレビュアーのメールアドレスとカスタムレビューメッセージを追加できます。このキーには、それぞれreviewersとmessageサブキーが含まれています。 </td> </tr> <tr> <td>artifacts</td> <td>このキーは、pipeline実行中に生成されたアプリケーションビルドファイルのアップロードおよびダウンロードプロセスを表すために使用されます。そのために、それぞれuploadとdownloadキーに値を設定できます。artifactsの詳細については、こちらのヘルプページを参照してください。</td> </tr> <tr> <td>upload</td> <td>このキーは、生成されたビルドZIPファイルをCatalyst Stratusサービスに保存するために使用されます。name、location、およびfilesサブキーをそれぞれ使用して、ビルドファイルの名前、ファイルを保存する場所、およびその他のファイル条件を定義する必要があります。</td> </tr> <tr> <td>download</td> <td>このキーは、Catalyst Stratusサービスから保存されたビルドZIPファイルを取得するために使用できます。uploadキーワードと同様に、name、location、およびfilesサブキーも定義できます。</td> </tr> <tr> <td>stages</td> <td>stageは、複数のjobsを含む個別のフェーズです。pipeline内に最大5つのstagesを定義でき、それぞれにjobsのセットが含まれます。stageレベルでrunnersとimagesも定義できます。</td> </tr> <tr> <td>when-equal</td> <td>このキーは、2つの値が完全に一致するかどうかを評価し、検証がtrueの場合にのみ、指定されたpipelineの実行フローを続行するために使用できます。</td> </tr> <tr> <td>when-not</td> <td>このキーは、特定の条件がtrueまたはfalseであるかどうかを評価するために使用できます。評価結果に基づいて、定義されたpipelineフローが実行されます。</td> </tr> <tr> <td>when-not-equal</td> <td>このキーは、2つの値が一致しないかどうかを評価し、その場合に定義されたpipelineフローの実行を続行するために使用できます。</td> </tr> <tr> <td>when-and</td> <td>このキーは、andキーで定義された2つの条件がtrueであるかどうかを評価するために使用できます。trueの場合、when conditionで定義されたフローが実行されます。</td> </tr> <tr> <td>when-or</td> <td>このキーは、orキーで定義された条件のいずれかがtrueであるかどうかを評価するために使用できます。trueの場合、whenキーで定義されたpipelineフローが実行されます。</td> </tr> <tr> <td>pipeline-when</td> <td>pipelineレベルで定義できる条件ロジックで、pipeline全体の実行フローを制御します。pipeline-when conditionとともに、and、equal、or、not、not-equalキーを使用できます。</td> </tr> <tr> <td>pipeline-runner</td> <td>このキーは、pipelineレベルでrunnerを定義するために使用でき、すべてのstagesおよびjobsからアクセス可能です。</td> </tr> <tr> <td>pipeline-image</td> <td>このキーは、pipelineレベルでimageを定義するために使用でき、すべてのstagesおよびjobsからアクセス可能です。</td> </tr> </tbody> </table> 注意: pipeline-image ファイルでpipelineの実行フローを定義する際は、Catalystが指定した正確なキーワードをキーとして使用し、各キーに対応するデータを割り当てるようにしてください。 -------------------------------------------------------------------------------- title: "実装" description: "Catalystコンソールから直接pipelineを設定するためのステップバイステップの手順について学びます。" last_updated: "2026-09-09T11:06:45.811Z" source: "https://docs.catalyst.zoho.com/ja/pipelines/help/catalyst-pipelines.yaml/implementation/" service: "Pipelines" related: - Runners (/ja/pipelines/help/catalyst-pipelines.yaml/build-the-pipeline/runners) - Images (/ja/pipelines/help/catalyst-pipelines.yaml/build-the-pipeline/images) - Artifacts (/ja/pipelines/help/catalyst-pipelines.yaml/build-the-pipeline/artifacts) - Variables (/ja/pipelines/help/catalyst-pipelines.yaml/build-the-pipeline/variables) - 条件（When） (/ja/pipelines/help/catalyst-pipelines.yaml/build-the-pipeline/when-condition) - Steps (/ja/pipelines/help/catalyst-pipelines.yaml/build-the-pipeline/steps) - Jobs (/ja/pipelines/help/catalyst-pipelines.yaml/build-the-pipeline/jobs/introduction) - Stages (/ja/pipelines/help/catalyst-pipelines.yaml/build-the-pipeline/stages/introduction) - YAMLスキーマリファレンス (/ja/pipelines/help/catalyst-pipelines.yaml/schema-reference) - パイプライントリガー (/ja/pipelines/help/triggers/introduction) -------------------------------------------------------------------------------- # 実装 Catalystコンソールから直接、組み込みのvisual builderまたはコードエディターを使用してpipelineを構築できます。以下の手順に従ってください： まず、コードエディターを使用してpipelineを設定しましょう。 1. pipelineを作成すると、コードエディターが自動的に開きます。基本的なYAMLコードがこのファイルに事前定義されていますので、必要に応じて更新を開始できます。 2. 右側のAssistant panelで、**Add Variable**をクリックします。key-value pairsを入力し、**Generate**をクリックします。 3. **Add to Code**をクリックします。 variablesがYAMLコードに追加されました。 4. 次に、pipeline実行に必要なimagesを追加しましょう。**Create Image**をクリックします。 **Create Image**ポップアップで、Image Variable name、image name、registry URL、registryのusernameとpasswordを入力します。**Generate**をクリックします。 **Add to Code**をクリックします。 imageがYAMLコードに追加されました。 5. **Add Runners**をクリックします。runner nameを入力し、runner configurationを選択します。runner configurationsの詳細については、こちらのヘルプページを参照してください。 **Generate**をクリックします。 **Add to Code**をクリックします。runnerがYAMLコードに追加されました。 6. 次に、pipelineに必要なjobsを追加しましょう。**Add Job**をクリックします。jobの名前を入力します。 以下のオプションのいずれかを使用してjobを作成できます： * **Create using Steps** : このオプションでは、下のscript editorで独自のコマンドセットを定義できます。jobに必要なrunnerとimageの設定を選択できます。以下に示すように、現在のworking directoryのパスを追加します。**Generate**をクリックします。 * **Create using Approvals** : これにより、pipelineのapproval jobが作成されます。以下に示すように、必要なapprover email addressを選択し、メッセージを入力します。**Generate**をクリックします。 * **Create using Templates** : Catalystで利用可能なpre-defined templatesを使用してjobsを作成します。ユースケースがこれらの操作のいずれかに該当する場合は、テンプレートを直接選択できます。 **Generate**をクリックします。 **Add to Code**をクリックすると、jobがYAMLに追加されます。 7. 次に、pipelineのstagesを定義しましょう。**Add Stage**をクリックします。stage nameを入力し、stageに必要なjobsを選択します。 **Show Advanced Options**をクリックし、stage実行内に条件ロジックを追加する必要がある場合は**Checks**を有効にします。 以下に示すようにチェックを追加し、**Add to Stage**をクリックします。 **Generate**をクリックし、**Add to Code**をクリックします。 stageがYAMLコードに追加されました。 YAMLの設定が完了したら、**Save**をクリックできます。設定を部分的に保存して後で編集を続ける場合は、**Save as Draft**をクリックできます。 以下のスクリーンショットに示すように、YAMLファイルをcommitするbranchを選択し、**Commit**をクリックします。 commit messageを入力し、**Commit**をクリックします。 catalyst-pipelines.yamlファイルがGit repositoryに更新されます。 同様に、visual builderを使用して同じpipelineを設定することもできます。 まず、以下のスクリーンショットに示すように**Builder tab**に切り替えます。 drag-and-drop builder interfaceが自動的に開きます。 ここで、コンポーネントをドラッグアンドドロップし、上記と同じ手順に従うだけです。 初回のYAML設定後、**Configure YAML**をクリックすることでいつでも変更を加えることができます。 **Global Variables**をクリックするだけで、pipeline全体でアクセス可能なglobal variablesを追加することもできます。 変数名をキーとして入力し、対応する値を入力します。**Save**をクリックします。 pipelineの実行については、次のセクションで説明します。 #### パイプラインの構築 -------------------------------------------------------------------------------- title: "ランナー" description: "Catalyst Pipelinesのrunnersの詳細、関連するキーワード、およびサンプルコードスニペットについて学びます。" last_updated: "2026-09-09T11:06:45.812Z" source: "https://docs.catalyst.zoho.com/ja/pipelines/help/catalyst-pipelines.yaml/build-the-pipeline/runners/" service: "Pipelines" related: - パイプラインの設定 (/ja/pipelines/help/catalyst-pipelines.yaml/implementation) -------------------------------------------------------------------------------- # パイプラインの構築 このセクションでは、さまざまなpipelineコンポーネントの詳細、catalyst-pipelines.yamlファイルでの使用方法、Catalystコンソールから直接これらのコンポーネントを組み込みCatalyst pipelineを構築する方法について説明します。始めましょう！ # Runners ## はじめに runnerは、pipelineで定義されたjobsを実行するエージェントまたはコンピューティングリソースです。Catalyst runnersは、ソフトウェアアプリケーションの効率的で信頼性の高いビルド、テスト、デプロイのための堅牢で柔軟なインフラストラクチャを提供します。 runnersキーワードを使用して、pipelineに必要なrunnersをkey-value pairsとして定義できます。 Catalyst Pipelinesでサポートされているrunner configurationsは以下の通りです： <table class="content-table"> <thead> <tr> <th>Runner設定</th> <th>RAMストレージ</th> <th>CPU容量</th> <th>ディスクスペース</th> </tr> </thead> <tbody> <tr> <td>Low</td> <td>1 GB</td> <td>0.8 vCPU</td> <td>2 GB</td> </tr> <tr> <td>Medium</td> <td>2 GB</td> <td>1.2 vCPU</td> <td>4 GB</td> </tr> <tr> <td>High</td> <td>4 GB</td> <td>2.0 vCPU</td> <td>8 GB</td> </tr> </tbody> </table> 注意: 1. runnerの定義は必須ではありません。runnerが指定されていない場合、jobsの実行にはデフォルトでmedium設定のrunnerが使用されます。 2. runnersはpipelineレベル、stageレベル、またはjobレベルで定義できます。複数の定義がある場合、最下位レベル（つまりjob）で指定されたものが優先されます。 ### Runnerのプロパティ <table class="content-table"> <thead> <tr> <th>キー</th> <th>値</th> <th>必須</th> </tr> </thead> <tbody> <tr> <td>Runner name（runnerにアクセスするために使用されるrunner変数名）</td> <td></td> <td>はい</td> </tr> <tr> <td>config-id</td> <td>必要なrunner configurationのID。 Low = config-id : 1<br/> Medium = config-id :2<br/> High = config-id : 3 </td> <td>はい</td> </tr> </tbody> </table> ### RunnerのYAMLコードスニペット runners: runner1: config-id: 2 runner2: config-id: 3 ### グローバル設定 必要に応じて、pipelineレベルでrunnersを定義することもできます。このrunner configurationは、すべてのstagesとjobsからアクセス可能になります。pipelineレベルでのrunner設定は以下のように行います： pipeline-runner:runner1 -------------------------------------------------------------------------------- title: "イメージ" description: "Catalyst Pipelinesのimagesの詳細、関連するキーワード、およびサンプルコードスニペットについて学びます。" last_updated: "2026-09-09T11:06:45.812Z" source: "https://docs.catalyst.zoho.com/ja/pipelines/help/catalyst-pipelines.yaml/build-the-pipeline/images/" service: "Pipelines" related: - パイプラインの設定 (/ja/pipelines/help/catalyst-pipelines.yaml/implementation) -------------------------------------------------------------------------------- # Images # はじめに imageは、pipeline内でjobを実行するために必要な依存関係を含む実行可能なパッケージです。Catalyst Pipelinesは、Docker Hubやその他のプライベートレジストリなどのコンテナレジストリとシームレスに統合し、pipeline実行中にimagesと依存関係をプルします。 さまざまなオペレーティングシステム、プログラミング言語、フレームワーク、ツールをサポートする幅広いimagesから、特定の要件に合ったものを選択できます。また、事前定義されたimagesを使用することで、pipelineのさまざまなstagesおよび環境間での一貫性と再現性が保証されます。 registryキーを使用してコンテナレジストリURLを明示的に指定することで、imagesをプルできます。registry URLが定義されていない場合、imagesはデフォルトでDockerhubコンテナからプルされます。imagesキーを使用して、pipelineに必要なimagesを定義できます。 ### Imageのプロパティ <table class="content-table"> <thead> <tr> <th>キー</th> <th>値</th> <th>必須</th> </tr> </thead> <tbody> <tr> <td>Image Variable Name</td> <td>imageにアクセスするために使用されるimage変数名</td> <td>はい</td> </tr> <tr> <td>image</td> <td>imageの名前</td> <td>はい</td> </tr> <tr> <td>registry</td> <td>imageを取得するURL</td> <td>いいえ</td> </tr> <tr> <td>auth</td> <td>usernameとpasswordキーを含みます。</td> <td>はい</td> </tr> <tr> <td>auth</td> <td>usernameとpasswordキーを含みます。</td> <td>はい</td> </tr> <tr> <td>username</td> <td>指定されたregistryのアカウントusername認証情報</td> <td>はい</td> </tr> <tr> <td>password</td> <td>指定されたregistryのアカウントpassword認証情報</td> <td>はい</td> </tr> </tbody> </table> 注意: 1. imageの定義は必須ではありません。imageが指定されていない場合、Catalyst CLIがプリインストールされたデフォルトのUbuntu imageがjobsの実行にデフォルトで使用されます。 2. imagesはpipelineレベル、stageレベル、またはjobレベルで定義できます。複数の定義がある場合、最下位レベル（つまりjob）で指定されたものが優先されます。 3. stage内の2つのjobsに同じimageが指定されている場合、キャッシュされたimageが2番目のjobに自動的に再利用され、パフォーマンス速度が向上します。 4. image nameが指定されてregistry URLが指定されていない場合は、authキーにDockerhubアカウントのusernameとpassword認証情報を必ず指定してください。imageはデフォルトでDockerHubからプルされます。 セキュリティ上の理由から、パスワード情報をグローバル設定のvariableとして保存し、catalyst-pipelines.yamlファイルで<< env.{variable_name} >>を使用してアクセスすることを強く推奨します。コンソールからvariablesをグローバルに設定する方法については、こちらのヘルプセクションを参照してください。 ### ImageのYAMLコードスニペット 以下は、pipelineで定義できるimagesのサンプルコードスニペットです： images: testImage1: image: node:18 registry: my.private.registry.com auth: username: ameliab password: zylker@123 testImage2: image: node:20 auth: username: ameliab password: zylker@123 上記のコードスニペットは以下を示しています： * pipelineには2つのimagesが定義されています（testImage1とtestImage2）。 * testImage1は、定義されたregistry URLからnode18の依存関係を使用します。registryの認証資格情報をauthキーワードに追加しています。 * デフォルトでは、registryが指定されていないため、testimage2はDockerhubからnode20の依存関係を使用します。 ### グローバル設定 必要に応じて、pipelineレベルでimageを定義することもできます。このimage設定は、すべてのstagesとjobsからアクセス可能になります。pipelineレベルでのimage設定は以下のように行います： pipeline-image: image1 -------------------------------------------------------------------------------- title: "変数" description: "Catalyst Pipelinesのvariablesの詳細、関連するキーワード、およびサンプルコードスニペットについて学びます。" last_updated: "2026-09-09T11:06:45.812Z" source: "https://docs.catalyst.zoho.com/ja/pipelines/help/catalyst-pipelines.yaml/build-the-pipeline/variables/" service: "Pipelines" related: - パイプラインの設定 (/ja/pipelines/help/catalyst-pipelines.yaml/implementation) -------------------------------------------------------------------------------- # Variables # はじめに variableは、必要に応じてjobレベルまたはpipelineレベルで定義できるプレースホルダー値です。stageレベルでvariableを定義することはできません。 variablesキーを使用して、pipelineに必要なvariablesをkey-value pairsとして定義できます。 ### Variableのプロパティ <table class="content-table"> <thead> <tr> <th>キー</th> <th>値</th> <th>必須</th> </tr> </thead> <tbody> <tr> <td>変数名</td> <td>variableの文字列値を指定します</td> <td>はい</td> </tr> </tbody> </table> ### VariableのYAMLコードスニペット 以下の構文を使用して、catalyst-pipelines.yamlファイルのjobレベルでvariableを宣言できます： variables: target:'app3.1' ### Global Variables コンソールから直接、pipelineレベルでvariableを定義できます。variableの作成手順については、こちらのヘルプページを参照してください。 注意: pipeline実行でCatalyst CLIを使用している場合は、CATALYST_TOKENという名前のglobal variableを必ず設定し、Catalyst CLIから生成されたトークンを入力する必要があります。トークンを取得するには、こちらのヘルプセクションに記載されている手順を参照してください。 ### Variableへのアクセス variableには、以下のいずれかの方法でアクセスできます： * **<< variables.{variable_name} >>** : jobレベルで定義されたvariableにアクセスするために使用できます。 * **<< event.{variable_name} >>** : コンソールからpipelineを手動でトリガーする際に、イベントJSONで渡されたvariablesにアクセスするために使用できます。 * **<< env.{variable_name} >>** : pipelineレベルで定義されたvariablesにアクセスするために使用できます。 -------------------------------------------------------------------------------- title: "条件（When）" description: "Catalyst Pipelinesのconditionsの詳細、関連するキーワード、およびサンプルコードスニペットについて学びます。" last_updated: "2026-09-09T11:06:45.812Z" source: "https://docs.catalyst.zoho.com/ja/pipelines/help/catalyst-pipelines.yaml/build-the-pipeline/when-condition/" service: "Pipelines" related: - パイプラインの設定 (/ja/pipelines/help/catalyst-pipelines.yaml/implementation) -------------------------------------------------------------------------------- # 条件（When） # はじめに when conditionは、pipelineの実行フローを定義するために設定できる基本的なロジックです。when conditionは、stageレベル、jobレベル、またはpipelineレベルで定義できます。when conditionはこれらのいずれのレベルでも適用でき、コンポーネントの順序は重要ではないことに注意してください。 when conditionとともに以下の演算子を使用できます： ### when-equal when: equal: - << status.build.package >> - success when-not-equal ### when-not-equal not-equal: - << status.build.package >> - failed ### when-not when: -not:true ### when-and/when-or when: or: - and: - equal: - << pipeline.status.build >> - success - not-equal: - << pipeline.status.build.hello-world >> - failed - equal: - << pipeline.event.{{Event Variable Placeholder}} >> 注意: approval jobsにはwhen conditionsを設定できません。 ### グローバル設定 必要に応じて、pipelineレベルでwhen conditionを定義できます。この条件はpipelineの実行フローのみを決定します。以下のように条件を設定できます： pipeline-when: equal: - << event.ref >> - refs/heads/main -------------------------------------------------------------------------------- title: "ステップ" description: "Catalyst Pipelinesのstepsの詳細、関連するキーワード、およびサンプルコードスニペットについて学びます。" last_updated: "2026-09-09T11:06:45.813Z" source: "https://docs.catalyst.zoho.com/ja/pipelines/help/catalyst-pipelines.yaml/build-the-pipeline/steps/" service: "Pipelines" related: - パイプラインの設定 (/ja/pipelines/help/catalyst-pipelines.yaml/implementation) -------------------------------------------------------------------------------- # Steps # はじめに stepはpipelineの最小構成要素です。source codeのビルド、デプロイ、またはテストを実行するためのコマンドセットです。ハイフン（-）を使用してコマンドを追加することで、jobのstepsを定義できます。 stepsキーを使用して、pipelineのstepsを定義できます。 ### StepsのYAMLコードスニペット steps: - ls - >- catalyst deploy appsail --name spring-boot --build-path "/catalyst/SNAPSHOT.jar" --stack java17 --platform javase --command "sh -c 'java -jar SNAPSHOT.jar --server.port=\${X_ZOHO_CATALYST_LISTEN_PORT}'" --verbose -------------------------------------------------------------------------------- title: "アーティファクト" description: "Catalyst Pipelinesのartifactsの詳細、関連するキーワード、およびサンプルコードスニペットについて学びます。" last_updated: "2026-09-09T11:06:45.813Z" source: "https://docs.catalyst.zoho.com/ja/pipelines/help/catalyst-pipelines.yaml/build-the-pipeline/artifacts/" service: "Pipelines" related: - パイプラインの設定 (/ja/pipelines/help/catalyst-pipelines.yaml/implementation) -------------------------------------------------------------------------------- # Artifacts # はじめに artifactは、pipeline実行中のアプリケーションビルドプロセスで生成されるファイルまたはZIPです。これらのartifactsはデプロイ可能なエンティティであり、インフラストラクチャやアプリが含まれます。pipeline実行中にCatalyst Stratusサービスでartifactsを保存および取得できます。 artifactsには2つのタイプがあります： * **単一のartifactファイル：** このビルドファイルはCatalyst Stratusのバケットに直接アップロードし、必要に応じてダウンロードできます。 * **artifact ZIP：** このタイプでは、正規表現を設定して関連ファイルを選択し、それらをZIPに圧縮してCatalyst Stratusのバケットにアップロードし、必要に応じてZIPをダウンロードします。 artifactsキーを使用して、pipelineに必要なartifactsをkey-value pairsとして定義できます。これらのartifactsは、Catalystコンソールでstepsを使用して作成されたjobsの一部として含めることができます。jobsでのartifact設定の詳細については、こちらのヘルプセクションを参照してください。ただし、parallelおよびapproval jobsには適用されません。 ### Artifactのプロパティ #### アップロード <table class="content-table"> <thead> <tr> <th>キー</th> <th>値</th> <th>必須</th> </tr> </thead> <tbody> <tr> <td>upload</td> <td>このキーには、artifactのアップロードプロセスに必要な設定が含まれます。</td> <td>はい</td> </tr> <tr> <td>type</td> <td>fileまたはzipのいずれかの値を指定します。</td> <td>はい</td> </tr> <tr> <td>name</td> <td>artifactの名前（ファイル名またはZIP名）。 例： SNAPSHOT.jar（fileタイプの場合） Build.zip（zipタイプの場合） </td> <td>はい</td> </tr> <tr> <td>file</td> <td>artifactファイルのソースパス。 例：target/demo-0.0.1-SNAPSHOT.jar </td> <td>はい（artifactタイプがfileの場合）</td> </tr> <tr> <td>regex</td> <td>ファイルを識別し、一致するすべてのファイルを圧縮する正規表現パターン。 例： - /catalyst/node_modules/**/ </td> <td>はい（artifactタイプがzipの場合）</td> </tr> <tr> <td>location</td> <td>ファイルまたはZIPをアップロードするStratusのロケーションパス。 例： stratus://<<env.BUCKET_NAME >>/ （送信先） </td> <td>はい</td> </tr> </tbody> </table> #### ダウンロード <table class="content-table"> <thead> <tr> <th>キー</th> <th>値</th> <th>必須</th> </tr> </thead> <tbody> <tr> <td>download</td> <td>このキーには、artifactのダウンロードプロセスに必要な設定が含まれます。</td> <td>はい</td> </tr> <tr> <td>type</td> <td>fileまたはzip。お好みに応じてこの値を指定します。</td> <td>はい</td> </tr> <tr> <td>name</td> <td>Stratus内のartifactの名前。 例： SNAPSHOT.jar（fileタイプの場合） Build.zip（zipタイプの場合） </td> <td>はい</td> </tr> <tr> <td>file</td> <td>ファイルをダウンロードする送信先パス。 例：/SNAPSHOT.jar </td> <td>はい（artifactタイプがfileの場合）</td> </tr> <tr> <td>location</td> <td>ファイルをダウンロードするStratusのロケーション。 例： stratus://<<env.BUCKET_NAME >>/ artifact名 </td> <td>はい</td> </tr> </tbody> </table> 注意: artifactタイプがzipに設定されている場合、ZIPファイルはデフォルトでルートディレクトリにダウンロードされます。 artifactsが設定されたサンプルYAMLコードスニペットについては、こちらのセクションを参照してください。 -------------------------------------------------------------------------------- title: "ステージ" description: "Catalyst Pipelinesのstagesの詳細、関連するキーワード、およびサンプルコードスニペットについて学びます。" last_updated: "2026-09-09T11:06:45.813Z" source: "https://docs.catalyst.zoho.com/ja/pipelines/help/catalyst-pipelines.yaml/build-the-pipeline/stages/" service: "Pipelines" related: - パイプラインの設定 (/ja/pipelines/help/catalyst-pipelines.yaml/implementation) -------------------------------------------------------------------------------- # Stages # はじめに stageは、pipeline内のjobsの実行順序を整理する重要なコンポーネントです。各stageは、アプリケーションのビルド、テスト、デプロイなど、ソフトウェアデリバリープロセスの個別のフェーズを表します。stagesにより、jobsの論理的なグループ化と分離が可能になり、より高速なビルドとデプロイのための並列実行が実現します。また、ワークフローを管理可能な単位に分解することで複雑なpipelinesの効率的な管理を促進し、デプロイプロセス全体の明確さと制御を提供します。 stagesキーを使用して、pipelineに必要なstagesをkey-value pairsとして定義できます。 &lt;&lt; status.{stage_name} &gt;&gt;を使用して、stageの現在のステータスを取得できます。 注意: 1. pipeline内の複数のstagesは、デフォルトで順次実行され、1つずつ進行します。stage実行の条件を定義するオプションがあり、各stageがいつトリガーされるかをカスタマイズして制御できます。pipelineでの条件の定義方法については、こちらのセクションを参照してください。 2. pipeline設定では、少なくとも1つのstageが必要で、最大5つのstagesまでです。また、各stageはparallel jobsを含めて最大5つのjobsを収容できます。 ### Stageのプロパティ 以下の属性の1つまたは複数の組み合わせで、pipeline内のstagesを定義できます： <table class="content-table"> <thead> <tr> <th>キー</th> <th>値</th> <th>必須</th> </tr> </thead> <tbody> <tr> <td>name</td> <td>stage nameを文字列値として指定します。</td> <td>はい</td> </tr> <tr> <td>jobs</td> <td>jobsの配列</td> <td>はい</td> </tr> </tr> <tr> <td>runner</td> <td>jobsを実行するrunnerの名前</td> <td>いいえ</td> </tr> <tr> <td>image</td> <td>特定のstageでのjob実行に使用されるimageの名前</td> <td>いいえ</td> </tr> <tr> <td>when</td> <td>stageを実行するための条件ロジック。基本条件とともに"and"、"or"、"not"、"not-equal"、または"equal"演算子を使用できます。</td> <td>いいえ</td> </tr> </tbody> </table> ### StageのYAMLコードスニペット 以下は、pipelineで定義できるstagesのサンプルコードスニペットです： stages: - name: testStage1 runner: runner1 image: testImage1 jobs: - testJob1 when: - and: - equal: - << pipeline.event.branch >> - master - true - name: testStage2 jobs: - testJob1 - - testJob2 - testJob3 上記のコードは以下のワークフローを示しています： * pipelineには2つのstagesが定義されています - testStage1とtestStage2。 * stage testStage1は1つのjob（testJob1）を実行し、stage testStage2は3つのjobs（testJob1とparallel job）を実行します。parallel jobには、それぞれtestJob2とtestJob3が含まれます。 * runnerとimageはstageレベルで定義されており、両方のstagesで利用されます。 * when conditionは、現在のbranchがmasterを指しているかどうかを検証し、それがtrueの場合、testJob1が実行されます。 ##### Jobs -------------------------------------------------------------------------------- title: "はじめに" description: "Catalyst Pipelinesのjobsの詳細、関連するキーワード、およびサンプルコードスニペットについて学びます。" last_updated: "2026-09-09T11:06:45.813Z" source: "https://docs.catalyst.zoho.com/ja/pipelines/help/catalyst-pipelines.yaml/build-the-pipeline/jobs/introduction/" service: "Pipelines" related: - パイプラインの設定 (/ja/pipelines/help/catalyst-pipelines.yaml/implementation) -------------------------------------------------------------------------------- # Jobs # はじめに jobは、pipelineで実行されるstepsのシーケンスです。pipelineには少なくとも1つのjobを定義することが必須です。jobsキーを使用して、pipelineに必要なjobsをkey-value pairsとして定義できます。 pipelineで定義される通常のjobs以外に、以下のjobsも設定できます： * **Approval Job** * **Parallel Job** &lt;&lt; status.{stage_name}.{job_name} &gt;&gt;を使用してjobのステータスを取得できます。 ### Jobのプロパティ <table class="content-table"> <thead> <tr> <th>キー</th> <th>値</th> <th>必須</th> </tr> </thead> <tbody> <tr> <td>variables</td> <td>variablesの配列</td> <td>いいえ</td> </tr> <tr> <td>artifacts</td> <td>uploadとdownloadキーを含みます。詳細については、こちらのヘルプページを参照してください。</td> <td>いいえ</td> </tr> <tr> <td>notify</td> <td>このキーは、job実行の開始前および完了後にjobに関する通知メールを送信するように設定できます。 サブキーon-startとon - endを含みます。</td> <td>いいえ</td> </tr> <tr> <td>on-start / on -end</td> <td>サブキーnotify-typeとnotify-variablesを含みます。</td> <td>はい（notifyを使用する場合）</td> </tr> <tr> <td>notify-type</td> <td>値としてemailを指定します。</td> <td>はい（notifyを使用する場合）</td> </tr> <tr> <td>notify-variables</td> <td>job実行開始時に通知するメールアドレス（on-startの場合）およびjob実行が正常に完了した時に通知するメールアドレス（on-endの場合）を指定します。</td> <td>はい（notifyを使用する場合）</td> </tr> <tr> <td>runner</td> <td>jobsを実行するrunner nameを指定します。</td> <td>いいえ</td> </tr> <tr> <td>image</td> <td>特定のjob実行に必要なimage nameを指定します。</td> <td>いいえ</td> </tr> <tr> <td>cwd</td> <td>jobを実行するworking directoryを指定します。</td> <td>いいえ</td> </tr> <tr> <td>steps</td> <td>pipelineで実行する必要があるスクリプトを含む配列。</td> <td>はい</td> </tr> <tr> <td>when</td> <td>jobを実行するかどうかを決定する条件を指定します。</td> <td>いいえ</td> </tr> </tbody> </table> ### JobのYAMLコードスニペット 以下は、pipelineで定義できるjobsのサンプルコードスニペットです： jobs: testJob1: steps: - echo "Enter your scripts here" testJob2: variables: BRANCH: main artifacts: upload: - name: artifactTest type: zip location: stratus://mybucket/home/artifacts files: - '**/*' download: - name: artifactTest type: zip location: stratus://mybucket/home/artifacts notify: on-start: - notify-type: email notify-variables: to: amelia.burrows@zylker.com on-end: - notify-type: email notify-variables: to: amelia.burrows@zylker.com runner: runner2 image: testImage1 cwd: cd ./src steps: - echo "Enter your scripts here" and: - equal: - << pipeline.event.branch >> - main - true testJob3: steps: - echo "Hello" 上記のコードは以下のワークフローを示しています： * pipelineには3つのjobsが定義されています - testJob1、testJob2、testJob3。 * testJob2は、repository内の現在のworking branchがmain branchの場合にのみ実行されるように設定されています。 * testJob2は、生成されたビルドファイルをCatalyst Stratusに保存および取得するプロセスを処理します。これはuploadとdownloadキーを使用して定義されます。 * また、job実行の開始とjobの完了について情報を提供するために、定義されたメールアドレスに通知を送信します。これはnotify on-startとon-end keysを使用して実現されます。 -------------------------------------------------------------------------------- title: "承認ジョブ" description: "Catalyst Pipelinesのapproval jobsの詳細、関連するキーワード、およびサンプルコードスニペットについて学びます。" last_updated: "2026-09-09T11:06:45.814Z" source: "https://docs.catalyst.zoho.com/ja/pipelines/help/catalyst-pipelines.yaml/build-the-pipeline/jobs/approval-job/" service: "Pipelines" related: - パイプラインの設定 (/ja/pipelines/help/catalyst-pipelines.yaml/implementation) -------------------------------------------------------------------------------- # Approval Job # はじめに 手動レビューが必要な重要なタスクは、pipelineのapproval jobとして定義できます。approval jobで定義されるstepsは、通常、デプロイの実行前に必要な一連の検証です。approval jobが設定されると、承認者がjobを承認するまでpipelineの実行が一時停止されます。 承認者にはjobを承認するためのメール通知が送信されます。また、コンソールから直接承認することもできます。コンソールからのjobの承認方法の詳細については、こちらのヘルプセクションを参照してください。 approveキーを使用して、pipelineのapproval jobsをkey-value pairsとして定義できます。 ### Approval Jobのプロパティ <table class="content-table"> <thead> <tr> <th>キー</th> <th>値</th> <th>必須</th> </tr> </thead> <tbody> <tr> <td>type</td> <td>このキーにはサブキーtype-nameが含まれます。</td> <td>はい</td> </tr> <tr> <td>type-name</td> <td>この値を「approval」として指定します。</td> <td>はい</td> </tr> <tr> <td>type-variables</td> <td>このキーにはサブキーreviewersとmessageが含まれます。</td> <td>はい</td> </tr> <tr> <td>reviewers</td> <td>このjobを承認できるレビュアーのメールアドレスを指定します。</td> <td>はい</td> </tr> <tr> <td>message</td> <td>承認者に送信するメッセージを入力します。</td> <td>はい</td> </tr> </tbody> </table> 注意: 1. approval jobには1人のレビュアーのみ追加できます。 2. approval jobには特定のタイムアウトがなく、承認者がアクションを取るまでpipelineの実行は一時停止されたままになります。 ### Approval JobのYAMLコードスニペット 以下は、approval jobのサンプルコードスニペットです： approve: type: type-name: approval type-variables: reviewers: - amelia.b@zylker.com message: Review this -------------------------------------------------------------------------------- title: "並列ジョブ" description: "Catalyst Pipelinesのparallel jobsの詳細、関連するキーワード、およびサンプルコードスニペットについて学びます。" last_updated: "2026-09-09T11:06:45.814Z" source: "https://docs.catalyst.zoho.com/ja/pipelines/help/catalyst-pipelines.yaml/build-the-pipeline/jobs/parallel-job/" service: "Pipelines" related: - パイプラインの設定 (/ja/pipelines/help/catalyst-pipelines.yaml/implementation) -------------------------------------------------------------------------------- # Parallel Job parallel jobには、並列で実行できる2つの個別のjobsを含めることができます。最初のjob名の前にハイフン2つ（--）を追加し、2番目のjob名の前にハイフン1つ（-）を追加することで、parallel jobを定義できます。これは、両方のjobsが並列で実行されることを記号的に示しています。 注意: 順次実行jobは、ハイフン1つ（-）を使用して簡単に定義できます。 ### Parallel JobのYAMLコードスニペット 以下は、parallel jobのサンプルコードスニペットです： name: testStage1 jobs: - testJob1 - - testJob2 - testJob3 ### デプロイメント -------------------------------------------------------------------------------- title: "AppSailへのデプロイ" description: "Pipelinesサービスを使用してアプリケーションをCatalyst AppSailにデプロイするためのサンプルYAMLコードスニペットについて詳しく学びます。" last_updated: "2026-09-09T11:06:45.814Z" source: "https://docs.catalyst.zoho.com/ja/pipelines/help/deployments/deploy-to-appsail/" service: "Pipelines" related: - Catalyst AppSail (/ja/serverless/help/appsail/introduction/) -------------------------------------------------------------------------------- # AppSailへのデプロイ アプリケーションのビルドとテストが完了したら、ユーザーが利用できるように仮想マシンにデプロイする必要があります。特定のニーズに基づいて、pipelineのデプロイフローをカスタマイズできます。プロセス全体を自動化することも、approval jobを含めてデプロイプロセスを部分的に自動化することもできます。 以下は、Springbootフレームワークを使用して構築されたJavaアプリケーションをCatalyst AppSailサービスにデプロイするために使用できるサンプルYAMLコードスニペットです。 pipelineを実行する前に、以下のキーをpipelineのglobal variablesとして設定する必要があります。variablesの設定方法については、こちらのヘルプセクションを参照してください。 * CATALYST_TOKEN : YAMLからCatalyst CLIにアクセスするための一意のトークン。トークン生成の詳細については、こちらのヘルプページを参照してください。 * DOCKER_PASS : Docker Hubアカウントのパスワード。 * BUCKET_NAME : Stratusバケットの名前。 version: 1.0 runners: high: config-id: 3 pipeline-when: equal: - << event.ref >> - refs/heads/main images: maven: image: maven:3.8.5-openjdk-17 auth: username: ameliaburrows password: << env.DOCKER_PASS >> jobs: unit-test: steps: - mvn surefire-report:report artifacts: upload: - type: zip regex: - /catalyst/target/surefire-reports/** name: junit.zip location: stratus://<< env.BUCKET_NAME >>/ package: steps: - mvn clean package -DskipTests=true artifacts: upload: - type: file name: SNAPSHOT.jar file: target/demo-0.0.1-SNAPSHOT.jar location: stratus://<< env.BUCKET_NAME >>/ catalyst-deploy: when: equal: - << status.build.package >> - success steps: - npm install -g zcatalyst-cli@beta - >- catalyst deploy appsail --name spring-boot --build-path "/catalyst/SNAPSHOT.jar" --stack java17 --platform javase --command "sh -c 'java -jar SNAPSHOT.jar --server.port=\${X_ZOHO_CATALYST_LISTEN_PORT}'" --verbose artifacts: download: - type: file name: SNAPSHOT.jar file: /SNAPSHOT.jar location: stratus://<< env.BUCKET_NAME >>/ stages: - name: test image: maven jobs: - unit-test - name: build image: maven jobs: - package - name: deploy jobs: - catalyst-deploy -------------------------------------------------------------------------------- title: "Catalystへのデプロイ" description: "Pipelinesサービスを使用してアプリケーションをCatalystにデプロイするためのサンプルYAMLコードスニペットについて詳しく学びます。" last_updated: "2026-09-09T11:06:45.814Z" source: "https://docs.catalyst.zoho.com/ja/pipelines/help/deployments/deploy-to-catalyst/" service: "Pipelines" related: - 基本Webクライアントのデプロイ (/ja/cli/v1/deploy-resources/deploy-client/) -------------------------------------------------------------------------------- # Catalystへのデプロイ このセクションでは、基本的なCatalyst WebクライアントとCatalyst Serverless Functionsコンポーネントのデプロイを自動化するためのサンプルYAMLコードについて説明します。このコードは**Java**、**Node.js**、**Python**に適用できます。 以下のキーをpipelineのglobal variablesとして設定する必要があります。variablesの設定方法については、こちらのヘルプセクションを参照してください。 * PROJECT_ID : Catalystによってプロジェクトに割り当てられた一意のID。この値はコンソールの一般設定から取得できます。 * CATALYST_ORG : 現在のプロジェクトが属するCatalyst組織。この値はコンソールのマルチ組織ポータルから取得できます。 * CATALYST_TOKEN : YAMLからCatalyst CLIにアクセスするための一意のトークン。トークン生成の詳細については、こちらのヘルプページを参照してください。 * USER_NAME : Docker Hubアカウントのユーザー名。 * USER_PASSWORD : Docker Hubアカウントのパスワード。 version: 1 runners: Machine: config-id: 2 images: DeployMachine: image: ubuntu auth: username: << env.USER_NAME >> password: << env.USER_PASSWORD >> jobs: Deploy_Client_Functions: steps: - apt-get update - apt-get -y install openjdk-17-jdk curl - curl -fsSL https://deb.nodesource.com/setup_18.x | bash - - apt-get install -y nodejs - apt-get update && \ - apt-get install -y software-properties-common wget curl && \ - add-apt-repository ppa:deadsnakes/ppa && \ - apt-get update && \ - apt-get install -y python3.9 python3.9-distutils && \ - wget https://bootstrap.pypa.io/get-pip.py && \ - python3.9 get-pip.py && \ - rm get-pip.py - npm i -g zcatalyst-cli - catalyst -v - cd functions/Node - npm install - cd ../.. - catalyst deploy --project << env.PROJECT_NAME >> --org << env.CATALYST_ORG >> --token << env.CATALYST_TOKEN >> stages: - name: build image: DeployMachine jobs: - Deploy_Client_Functions ### トリガー -------------------------------------------------------------------------------- title: "はじめに" description: "さまざまなpipelineトリガーとその使用方法について学びます。" last_updated: "2026-09-09T11:06:45.815Z" source: "https://docs.catalyst.zoho.com/ja/pipelines/help/triggers/introduction/" service: "Pipelines" -------------------------------------------------------------------------------- # トリガー # はじめに ### 自動トリガー Catalyst Pipelinesにおける自動トリガーは、特定のイベントまたは条件に基づいてpipelineの実行を開始するプロセスです。コンソールからpipelineを作成する際、外部バージョン管理システムとpipelineを統合するオプションがあります。この統合の詳細については、こちらのセクションを参照してください。 pipelinesをバージョン管理システムに接続することは推奨されるアプローチであり、トレーサビリティ、コラボレーション、コード変更に基づくビルドのトリガーなど、多くのメリットがあることに注意してください。 pipelineを外部バージョン管理システムと統合している場合、リンクされたrepositoryでプッシュまたはマージイベントが発生するたびにpipelineの実行が開始されます。Catalystコンソールからpipelineの実行ステータスを確認できます。pipelineの実行ステータスの監視の詳細については、こちらのセクションを参照してください。 ### 手動トリガー pipelineを外部バージョン管理システムと統合していない場合は、Catalystコンソールから毎回手動でpipelineを実行できます。 コンソールから直接pipelineを実行するには、以下の手順に従ってください： 1. **Execute Pipeline**をクリックします。 2. 必要に応じて、JSON形式でpipelineのイベント詳細を入力します。**Execute**をクリックします。ここではイベント詳細はオプションです。 pipelineの実行が開始されます。 pipelineのステータスは、**QUEUED**から**RUNNING**、そして**SUCESS/FAILED**へと進行します。 pipelineのステータスは**Execution History**セクションで確認できます。次のセクションで詳しく説明します。 -------------------------------------------------------------------------------- title: "実行ステータスの監視" description: "アプリケーションのエンドユーザーに会話アシスタンスを提供するCatalyst ConvoKraftボットについて学びます。" last_updated: "2026-09-09T11:06:45.815Z" source: "https://docs.catalyst.zoho.com/ja/pipelines/help/triggers/monitor-execution-status/" service: "Pipelines" -------------------------------------------------------------------------------- # 実行ステータスの監視 pipelineの実行が自動的または手動でトリガーされた後、Catalystコンソールからpipelineの実行ステータスを直接確認できます。 1. **Execution History**セクションで、pipelineの実行の詳細を確認できます。 2. 実行レコードをクリックして、実行に関する詳細情報を表示します。**Basic tab**では、pipelineで定義された各stageおよびjobの実行ステータスを概要として確認できます。 **Advanced tab**に切り替えると、pipeline実行のライブログを確認できます。 注意: pipelineの実行中、approval jobがpipelineに設定されている場合、実行は一時停止されます。その場合、レビュアーがjobを承認した後にのみ、pipeline実行が再開されます。レビュアーは**Basic Tab**のコンソールから直接jobを承認できます。 ### パイプライン -------------------------------------------------------------------------------- title: "はじめに" description: "Catalyst Pipelinesの基本、サービスの全体的なワークフロー、およびその実装について学びます。" last_updated: "2026-09-09T11:06:45.815Z" source: "https://docs.catalyst.zoho.com/ja/pipelines/help/pipelines/introduction/" service: "Pipelines" related: - Java SDK (/ja/sdk/java/v1/pipelines/get-pipeline-details) - Nodejs SDK (/ja/sdk/nodejs/v2/pipelines/get-pipeline-details) - Python SDK (/ja/sdk/python/v1/pipelines/get-pipeline-details) - パイプラインの設定 (/ja/pipelines/help/catalyst-pipelines.yaml/implementation) -------------------------------------------------------------------------------- # Pipelines # はじめに pipelineは、Catalyst Pipelinesサービスにおける最上位の作業単位です。コードのコンパイル、テストの実行、アプリケーションのデプロイなど、カスタマイズ可能なstagesのシーケンスが含まれており、ソフトウェアライフサイクルプロセスをシームレスにオーケストレーションします。 pipelineを作成し、Catalystコンソールから直接pipelineのフローを設定できます。詳細な手順については、こちらのセクションで説明します。 pipelineの作成時に、GitLab、GitHub、またはBitbucketなどの外部バージョン管理システムとpipelineを統合することを選択できます。この統合により、バージョン管理システム内の特定のrepositoryをpipelineにリンクでき、repositoryに変更がプッシュされるたびに、pipelineが自動的にトリガーされます。必要に応じて、CatalystコンソールからpipelineをPipelineを手動でトリガーすることもできます。pipelineのトリガーの詳細については、こちらのセクションを参照してください。 Catalyst pipelinesは、catalyst-pipelines.yamlファイルで指定されたYAMLコードに基づいてオーケストレーションされます。Catalyst PipelinesのYAMLスキーマ定義を理解し、特定のニーズに合わせてpipelineをカスタマイズするには、こちらのページを参照してください。このYAMLファイルは、手動トリガーの場合はコンソールから直接実行され、自動トリガーの場合は外部バージョン管理システムから直接実行されます。 アプリケーションコード内でPipelines SDKパッケージを使用して、手動pipelineトリガーの実装や既存のpipelineの詳細を取得することもできます。SDKはJava、Node.js、Pythonで利用可能です。 YAMLファイルでpipelineの実行フローを定義するには、2つのオプションがあります：直感的なアプローチとして組み込みのdrag-and-drop visual builderを使用するか、コードエディターを使用してYAMLコードを設定するかを選択できます。pipelineの設定手順については、こちらのヘルプページを参照してください。 それでは、pipelineのコンポーネント、その階層構造、および使用方法について見ていきましょう。 -------------------------------------------------------------------------------- title: "パイプラインのコンポーネント" description: "Catalyst Pipelinesのさまざまなコンポーネント、その使用方法、機能、および階層について学びます。" last_updated: "2026-09-09T11:06:45.815Z" source: "https://docs.catalyst.zoho.com/ja/pipelines/help/pipelines/components-of-pipeline/" service: "Pipelines" related: - パイプラインの設定 (/ja/pipelines/help/catalyst-pipelines.yaml/implementation) -------------------------------------------------------------------------------- # パイプラインのコンポーネント pipelineには以下のコンポーネントを任意に組み合わせて含めることができ、それぞれがpipelineの実行順序を定義します。pipelineの実行フローの設定方法の詳細については、こちらのヘルプセクションを参照してください。 * **Pipeline** : ソフトウェアアプリケーションのビルド、テスト、デプロイプロセスを自動化するためのツール。 * **Runner** : pipelineを実行するための基盤インフラストラクチャを提供する仮想マシンまたはコンテナ。 * **Image** : pipelineが実行を正常に完了するために依存する、ライブラリ、パッケージ、サービスなどの外部リソース。 * **Variable** : pipelineのスコープ内の複数のインスタンスで再利用できる値のプレースホルダー。 * **Artifact** : アプリケーションのビルドプロセス中に生成され、Catalyst Stratusサービスに保存されるZIP fileで、指定された環境にデプロイできます。 * **When Condition** : pipelineの実行フローを指示するために定義できる条件ロジック。 * **Step** : stepはpipelineの最小構成要素です。コードのコンパイル、テストの実行、アプリケーションのデプロイなど、特定の操作を実行するためのコマンドセットが含まれています。 * **Job** : jobは、pipeline内で実行される一連の順次または並列のstepsです。 * **Stage** : Catalyst Pipelineにおける最上位の組織レベルで、ソフトウェアデリバリープロセスの個別のフェーズを表します。各stageには複数のjobsが含まれます。 上記のコンポーネントのいずれかを、特定の要件に基づいてcatalyst-pipelines.yamlファイルに定義することで、pipelineの実行フローをコーディングできます。 Catalyst pipeline、stages、およびjobs内で、images、runners、variables、conditionsなどの他のコンポーネントを柔軟に設定でき、それぞれがpipelineの実行において異なる役割を果たします。 以下の図は、各レベルで定義できるコンポーネントの包括的な概要を示しています： 各コンポーネントの詳細については、それぞれのヘルプページで説明します。開始するには、こちらのヘルプページを参照してください。 以下の図は、さまざまなpipelineコンポーネントの階層的な順序を示しています。 ## 主な考慮事項 1. pipelineには最大5つのstagesを含めることができ、各stageにはparallel jobsを含めて最大5つのjobsを収容できます。 2. pipelineには少なくとも1つのstageとjobを含めることが必須です。 3. variables、images、runnersは、pipelineレベル、stageレベル、またはjobレベルで定義できます。複数の定義がある場合、最下位レベル（つまりjob）で指定されたものが優先されます。 -------------------------------------------------------------------------------- title: "パイプラインワークフロー" description: "Catalyst Pipelinesサービスに関連するさまざまなCI/CDプロセスについて学びます。" last_updated: "2026-09-09T11:06:45.816Z" source: "https://docs.catalyst.zoho.com/ja/pipelines/help/pipelines/pipeline-workflow/" service: "Pipelines" related: - パイプラインの設定 (/ja/pipelines/help/catalyst-pipelines.yaml/implementation) - パイプライントリガー (/ja/pipelines/help/triggers/introduction) - Catalyst Serverless Functions (/ja/serverless/help/functions/introduction/) - Catalyst AppSail (/ja/serverless/help/appsail/introduction/) -------------------------------------------------------------------------------- # パイプラインワークフロー 以下のアーキテクチャ図は、Catalyst Pipelineのエンドツーエンドのフローを示しています。 ### パイプラインのトリガー Catalyst pipelineを作成する際、サポートされているバージョン管理システム（GitHub、GitLab、またはBitbucket）のいずれかとpipelineを統合することを選択できます。この統合により、pipelineのトリガーモードが決定されます： * **自動パイプライントリガー：** 統合されたバージョン管理システムのリンクされたrepositoryにコード変更をプッシュするたびに、pipelineが自動的にトリガーされます。pipelineがトリガーされると、統合されたGit repositoryからの完全なsource codeがYAMLファイルとともに自動的に取得され、ZIP fileとしてCatalystにダウンロードされます。 * **手動パイプライントリガー：** Catalystコンソールからpipelineを手動でトリガーできます。これは、バージョン管理システムとの統合を必要としない一回限りのタスクに適しています。 上記の両方のケースにおいて、pipelineをトリガーすると、catalyst-pipelines.yamlファイルにコーディングされたpipelineワークフローが実行されます。 Catalyst pipelineのトリガーとその実装の詳細については、こちらのセクションを参照してください。 ### パイプラインの実行 トリガーされると、pipelineは順番に、1つのstageずつ実行されます。pipelineを実行することで一般的に達成される目標には、以下のものがあります： #### ビルド Catalyst Pipelinesサービスを使用して、あらゆる規模のアプリケーションをビルドするようにpipelineを設定できます。一般的にビルドされるアプリケーションの例を以下に示します： * **Webアプリケーション：** ASP.NET、Node.js、Django、Flaskなどのフレームワークで開発されたWebアプリケーションをビルドできます。 * **モバイルアプリケーション：** Xamarin、React Native、Flutterなどのフレームワークを使用して、iOS、Android、またはWindows向けのモバイルアプリをビルドします。 * **APIサービス：** Express.js、ASP.NET Web API、Spring Bootなどのフレームワークを使用して、RESTful APIやマイクロサービスをビルドします。 * **サーバーレスアプリケーション：** Catalyst Serverless Functions、Azure Functions、AWS Lambda、またはGoogle Cloud Functionsを使用してサーバーレスアプリケーションをビルドできます。 * **コンテナ化されたアプリケーション：** Docker、Kubernetes、またはその他のコンテナオーケストレーションツールを使用して、コンテナ化されたアプリケーションをビルドします。 Catalyst Pipelinesサービスを使用して自動的にビルドできるアプリケーションには多くの選択肢があります。アプリケーションを効率的にビルドするために実行する特定のコマンドを、pipelineのstepsコンポーネントに設定する必要があります。 #### テスト アプリケーションが自動的にビルドされたら、任意の環境にデプロイする前にテストを進めることができます。ビルドプロセスと同様に、アプリケーションをテストするために必要なコマンドをcatalyst-pipelines.yamlファイルに指定できます。pipelineで実行できる一般的なテストのリストを以下に示します： * **ユニットテスト：** アプリケーションの個々のコンポーネントまたはモジュールのユニットテストを実行し、それらが単独で正しく機能することを確認します。 * **統合テスト：** アプリケーションのさまざまなコンポーネントまたはモジュール間のインタラクションを検証するための統合テストを実行します。 * **APIテスト：** アプリケーションで使用されるAPIの機能、パフォーマンス、セキュリティをテストします。手動および自動のAPIテストの両方を含みます。 * **回帰テスト：** 最近のコード変更がアプリケーションに新しいバグや回帰を導入していないことを確認するための回帰テストを実行します。 #### デプロイ 特定のニーズに基づいて、開発環境、ステージング環境、本番環境などの任意の環境にアプリケーションをデプロイできます。一般的なデプロイターゲットのリストを以下に示します： * **Platform as a Service（PaaS）：** Catalyst AppSail、Heroku、またはGoogle App Engineなどのプラットフォームは、基盤となるインフラストラクチャを管理する必要なく、Webアプリケーションをデプロイするためのマネージド環境を提供します。開発者はサーバー管理を心配することなく、コードの作成に集中できます。 * **コンテナ化：** Dockerなどのコンテナ化技術を使用して、Webアプリケーションとその依存関係をコンテナにパッケージ化します。これらのコンテナは、異なる環境間で一貫してデプロイでき、移植性とスケーラビリティを提供します。 * **コンテナオーケストレーション：** Kubernetesなどのツールにより、コンテナ化されたアプリケーションの自動デプロイ、スケーリング、管理が可能になります。Kubernetesは、ロードバランシングや自動スケーリングなどの機能を提供し、コンテナの大規模なデプロイと管理を支援します。 一般的なデプロイターゲットとpipelineを設定するためのステップバイステップの手順については、こちらのヘルプページで説明します。 -------------------------------------------------------------------------------- title: "パイプラインの作成" description: "Catalyst Pipelinesサービスと、アプリケーションのエンドユーザーに会話アシスタンスを提供するボットを作成するためのステップバイステップの手順について学びます。" last_updated: "2026-09-09T11:06:45.816Z" source: "https://docs.catalyst.zoho.com/ja/pipelines/help/pipelines/create-a-pipeline/" service: "Pipelines" related: - パイプラインの設定 (/ja/pipelines/help/catalyst-pipelines.yaml/implementation) - YAMLスキーマリファレンス (/ja/pipelines/help/catalyst-pipelines.yaml/schema-reference) -------------------------------------------------------------------------------- # パイプラインの作成 Catalystコンソールでpipelineを作成するには、以下の手順に従ってください： 1. Catalystコンソールの左メニューから**Pipelines**サービスアイコンをクリックします。 2. **Create Pipeline**をクリックします。 3. 表示されるポップアップで、pipelineの名前を入力します。 4. 希望するintegration sourceを選択します。 注意: この手順は完全にオプションです。pipelineをGit providerと統合しない場合は、手順8に直接進むことができます。 5. **+Add account**オプションをクリックして新しいGitアカウントを追加します。以前にCatalystプロジェクトに統合したGitアカウントがある場合は、ドロップダウンに表示されます。アカウントを選択して続行してください。 6. 選択したアカウントが属する組織を選択します。 注意: この属性は、GitHubでの組織名、GitLabでのプロジェクト名、Bitbucketでのワークスペース名を指します。 7. 新しいcatalyst-pipelines.yamlファイルをcommitするrepositoryを選択します。**Continue**をクリックします。 注意: YAMLファイルがrepositoryに既に存在する場合は、必ずcatalyst-pipelines.yamlという名前にしてください。 8. コードエディターが開きます。エディターで必要なpipelineコンポーネントを追加して、pipelineの設定を進めることができます。また、以下のスクリーンショットに示すように、ファイルをcommitするbranchを選択できます。 pipelineの実行フローを定義したら、**Commit**をクリックします。必要に応じて、**Save as Draft**として保存し、後でロジックを作成することもできます。 以下のスクリーンショットに示すように、タブを切り替えて**Builder**モードでpipelineを設定することもできます。 pipelineの設定の詳細については、こちらのヘルプページで説明します。 --- ## API Reference — パイプライン -------------------------------------------------------------------------------- title: "得る Pipeline 詳細" description: "このAPIを使用すると、CatalystコンソールからCatalyst Pipelineの詳細を取得できます。" last_updated: "2026-09-09T11:06:45.822Z" source: "https://docs.catalyst.zoho.com/ja/api/code-reference/pipelines/get-pipeline-details/" service: "Pipelines" -------------------------------------------------------------------------------- # Catalyst Pipelines Catalyst Pipelinesは、アプリケーションのビルド、テスト、デプロイプロセスを自動化するCatalyst CI/CDサービスです。Catalystコンソールからパイプラインを作成できます。次のセクションでは、パイプラインのトリガーと既存のパイプラインの詳細取得に利用できるAPIについて説明します。 # Pipeline詳細の取得 このAPIを使用すると、Catalystコンソールで作成されたパイプラインの詳細を取得できます。これは、リクエストURLにpipeline_idとproject_idを渡すことで行えます。APIは、パイプラインが作成されたプロジェクトの詳細とパイプラインの詳細を取得します。 ### リクエスト詳細 #### リクエストURL <p>{api-domain}/baas/v1/project/{project_id}/pipeline/{pipeline_id}</p> DCのドメインURL パイプラインが作成されたプロジェクトの一意のID 詳細を取得するパイプラインの一意のID #### スコープ pipeline.READ ### レスポンス詳細 パイプライン詳細オブジェクトがレスポンスとして返されます。これには、パイプラインの名前、project_nameやproject_typeを含むプロジェクトの詳細、user_id、email_id、first_name、last_name、user_typeを含むパイプライン作成者の詳細、パイプラインのステータス、パイプラインを変更したユーザーの詳細と変更時間の詳細、およびパイプラインのデフォルトランナー設定が含まれます。 curl -X GET \ https://api.catalyst.zoho.com/baas/v1/project/4000000006007/pipeline/29810101101 \ -H "Authorization: Zoho-oauthtoken 1000.910*************************16.2f*************************57" \ { "status": "success", "data": { "pipeline_id": "29810101101", "name": "test1", "project_details": { "project_name": "Project-Rainfall", "id": "4000000006007", "project_type": "Live" }, "created_by": { "zuid": "20257791", "is_confirmed": false, "email_id": "amelia.burrows@zylker.com", "first_name": "Amelia", "last_name": "Burrows", "user_type": "Admin", "user_id": "5000000000056" }, "created_time": "Mar 19, 2024 11:28 AM", "modified_by": { "zuid": "20257791", "is_confirmed": false, "email_id": "amelia.burrows@zylker.com", "first_name": "Amelia", "last_name": "Burrows", "user_type": "Admin", "user_id": "5000000000056" }, "modified_time": "Mar 19, 2024 11:28 AM", "git_account_id": "", "mask_regex": [ null ], "pipeline_status": "Active", "config_id": 2, "integ_id": 1 } } Get Pipeline Details - Java SDK<br/><br/> Get Pipeline Details - Node.js SDK<br/><br/> Get Pipeline Details - Python SDK -------------------------------------------------------------------------------- title: "実行する Pipeline" description: "このAPIを使用すると、CatalystコンソールからCatalyst Pipelineを実行できます。" last_updated: "2026-09-09T11:06:45.822Z" source: "https://docs.catalyst.zoho.com/ja/api/code-reference/pipelines/execute-pipeline/" service: "Pipelines" -------------------------------------------------------------------------------- # Pipelineの実行 このAPIを使用すると、Gitリポジトリ内の特定のブランチでパイプラインをトリガーできます。これは、リクエストボディでパラメータとしてブランチ名を渡すことで行えます。手動パイプラインをトリガーする場合は、リクエストJSONのブランチ名パラメータを省略できます。 このAPIをトリガーすると、パイプラインが実行され、実行のステータスがレスポンスとして返されます。 # Pipeline詳細の取得 このAPIを使用すると、Catalystコンソールで作成されたパイプラインの詳細を取得できます。これは、リクエストURLにpipeline_idとproject_idを渡すことで行えます。APIは、パイプラインが作成されたプロジェクトの詳細とパイプラインの詳細を取得します。 ### リクエスト詳細 #### リクエストURL <p>{api-domain}/baas/v1/project/{project_id}/pipeline/{pipeline_id}/run</p> DCのドメインURL パイプラインが作成されたプロジェクトの一意のID 詳細を取得するパイプラインの一意のID #### リクエストJSONプロパティ Gitブランチの名前を指定します イベントの詳細を指定します 必要な追加パラメータ 注意: 1. 手動のCatalyst Pipelineをトリガーする場合、BRANCH_NAMEは任意です。 2. EVENTおよびURLキーは環境変数として追加されています。パイプラインの実行に必要なキーをイベントJSONで渡すことができます。 #### スコープ pipeline.execution.CREATE ### レスポンス詳細 パイプライン作成履歴の詳細を含むオブジェクトがレスポンスとして返されます。オブジェクトには、history_id、event_time、history_statusなどの詳細が含まれます。 curl -X POST \ https://api.catalyst.zoho.com/baas/v1/project/4000000006007/pipeline/29810101101/run -H "Authorization: Zoho-oauthtoken 1000.910*************************16.2f*************************57" \ -d '{ "BRANCH_NAME" : "main", \ "EVENT": "push", \ "URL": "https://www.google.com" \ } { "status": "success", "data": { "history_id": "5000000021007", "pipeline_id": "29810101101", "event_time": "Mar 20, 2024 02:02 PM", "event_details": { "BRANCH_NAME": "main", "EVENT": "push", "URL": "https://www.google.com" }, "history_status": "Queued" } } Execute Pipeline - Java SDK<br/><br/> Execute Pipeline - Node.js SDK<br/><br/> Execute Pipeline - Python SDK --- ## SDK — Java — Pipelines -------------------------------------------------------------------------------- title: "Pipelineインスタンスの取得" description: "このページでは、Pipelineインスタンスを取得し、他のPipeline操作に使用する方法について説明します。" last_updated: "2026-09-09T11:06:45.830Z" source: "https://docs.catalyst.zoho.com/ja/sdk/java/v1/pipelines/get-pipeline-instance/" service: "All Services" related: - Catalyst Pipelines (/ja/pipelines/help/pipelines/introduction) - Create a Pipeline (/ja/pipelines/help/pipelines/create-a-pipeline) - Node.js SDK (/ja/sdk/nodejs/v2/pipelines/get-pipeline-instance) - Python SDK (/ja/sdk/python/v1/pipelines/get-pipeline-instance) - REST API (/ja/api/code-reference/pipelines/get-pipeline-details) -------------------------------------------------------------------------------- # Catalyst Pipelines Catalyst Pipelinesは、Webまたはモバイルアプリケーションのビルド、テスト、およびデプロイメントの自動化を可能にするCI/CDアプローチを実装します。 Catalystコンソールからパイプラインを作成できます。以下のSDKを使用して、Catalyst Pipelineの詳細を取得し、アプリケーションにコードスニペットを組み込むことでパイプラインを実行することもできます。 #### サンプルコードスニペット <br> import com.zc.component.pipeline.ZCPipeline; import com.zc.component.pipeline.ZCPipelineDetails; import com.zc.component.pipeline.ZCPipelineRunHistory; # Pipelineインスタンスの取得 コンポーネントインスタンスは、特定のコンポーネントに固有のプロパティにアクセスするために使用できるオブジェクトです。Catalyst Pipelinesで以下にリストされたアクションを実行するために、コンポーネントインスタンスを作成できます。 以下のように新しいpipelines_serviceインスタンスを作成できます。このコンポーネントインスタンスは、Java SDKのすべてのPipeline操作で使用されます。 ZCPipeline pipelines_service = ZCPipeline.getInstance(); -------------------------------------------------------------------------------- title: "Pipeline詳細の取得" description: "このページでは、既存のCatalyst Pipelineのすべての詳細を取得する方法について説明します。" last_updated: "2026-09-09T11:06:45.830Z" source: "https://docs.catalyst.zoho.com/ja/sdk/java/v1/pipelines/get-pipeline-details/" service: "All Services" related: - Node.js SDK (/ja/sdk/nodejs/v2/pipelines/get-pipeline-instance) - Python SDK (/ja/sdk/python/v1/pipelines/get-pipeline-instance) -------------------------------------------------------------------------------- # Pipeline詳細の取得 getPipelineDetails()メソッドにパイプラインIDをパラメータとして渡すことで、Catalyst Pipelineの詳細を取得できます。パイプラインの名前、パイプラインが作成されたCatalystプロジェクトの詳細、パイプラインを作成したユーザーの詳細、作成時刻、変更が行われた場合はパイプラインを変更したユーザーの詳細、変更時刻、パイプラインのステータス、およびランナー仕様などのその他の詳細がこのメソッドのレスポンスとして返されます。 以下で使用されているpipelines_serviceリファレンスは、このコンポーネントインスタンスページで既に定義されています。 ZCPipelineDetails pipeline_details = pipelines_service.getPipelineDetails(16965000000019202L); サンプルレスポンスを以下に示します： { "status": "success", "data": { "pipeline_id": "16965000000019202L", "name": "test1", "project_details": { "project_name": "Project-Rainfall", "id": "5000000000072", "project_type": "Live" }, "created_by": { "zuid": "20257791", "is_confirmed": false, "email_id": "amelia.burrows@zylker.com", "first_name": "Amelia", "last_name": "Burrows", "user_type": "Admin", "user_id": "5000000000056" }, "created_time": "Mar 19, 2024 11:28 AM", "modified_by": { "zuid": "20257791", "is_confirmed": false, "email_id": "amelia.burrows@zylker.com", "first_name": "Amelia", "last_name": "Burrows", "user_type": "Admin", "user_id": "5000000000056" }, "modified_time": "Mar 19, 2024 11:28 AM", "git_account_id": "", "mask_regex": [ null ], "pipeline_status": "Active", "config_id": 2, "integ_id": 1 } } -------------------------------------------------------------------------------- title: "Pipelineの実行" description: "このページでは、Catalyst Pipelineを手動で実行する方法について説明します。" last_updated: "2026-09-09T11:06:45.830Z" source: "https://docs.catalyst.zoho.com/ja/sdk/java/v1/pipelines/execute-pipeline/" service: "All Services" related: - Node.js SDK (/ja/sdk/nodejs/v2/pipelines/get-pipeline-instance) - Python SDK (/ja/sdk/python/v1/pipelines/get-pipeline-instance) -------------------------------------------------------------------------------- # Pipelineの実行 runPipeline()メソッドにパイプラインIDとブランチ名をパラメータとして渡すことで、Catalystパイプラインの実行を開始できます。また、パイプライン実行に必要な環境変数をJSONオブジェクトでこのメソッドに渡すこともでき、これは完全に任意です。このメソッドはレスポンスとしてパイプラインの実行履歴の詳細を返します。 JSONObject env = new JSONObject(); env.put("EVENT", "push"); env.put("URL", "https://www.google.com"); ZCPipelineRunHistory run = pipelines_service.runPipeline(8431000000161112051L,main,env); サンプルレスポンスを以下に示します： { "status": "success", "data": { "history_id": "5000000021007", "pipeline_id": "8431000000161112051L", "event_time": "Mar 20, 2024 02:02 PM", "event_details": { "BRANCH_NAME": "detective_pre", "EVENT": "push", "URL": "https://www.google.com" }, "history_status": "Queued" } } --- ## SDK — Node JS — Pipelines -------------------------------------------------------------------------------- title: "Pipelineインスタンスの取得" description: "このページでは、Pipelineインスタンスを取得し、他のPipeline操作に使用するメソッドについて説明します。" last_updated: "2026-09-09T11:06:45.832Z" source: "https://docs.catalyst.zoho.com/ja/sdk/nodejs/v2/pipelines/get-pipeline-instance/" service: "All Services" related: - Catalyst Pipelines (/ja/pipelines/help/pipelines/introduction) - Create a Pipeline (/ja/pipelines/help/pipelines/create-a-pipeline) - Java SDK (/ja/sdk/java/v1/pipelines/get-pipeline-instance) - Python SDK (/ja/sdk/python/v1/pipelines/get-pipeline-instance) - REST API (/ja/api/code-reference/pipelines/get-pipeline-details) -------------------------------------------------------------------------------- # Catalyst Pipelines Catalyst Pipelinesは、Webまたはモバイルアプリケーションのビルド、テスト、デプロイの自動化を可能にするCI/CDアプローチを実装しています。 Catalystコンソールからパイプラインを作成できます。以下のSDKを使用して、Catalyst Pipelineの詳細を取得したり、コードスニペットをアプリケーションに組み込んでパイプラインを実行したりできます。 # Pipelineインスタンスの取得 コンポーネントインスタンスは、特定のコンポーネントに固有のプロパティにアクセスするために使用できるオブジェクトです。コンポーネントインスタンスを作成して、Catalyst Pipelinesで以下に一覧表示されたアクションを実行できます。 以下のコードで使用されているapp参照は、SDKの初期化時にレスポンスとして返されるNodeオブジェクトです。以下に示すように、新しいpipelines_serviceインスタンスを作成できます。 const pipelines_service = app.pipeline() このコンポーネントインスタンスは、Node.js SDKのすべてのPipeline操作に使用されます。 -------------------------------------------------------------------------------- title: "Pipelineの詳細取得" description: "このページでは、既存のCatalyst Pipelineのすべての詳細を取得するメソッドについて説明します。" last_updated: "2026-09-09T11:06:45.832Z" source: "https://docs.catalyst.zoho.com/ja/sdk/nodejs/v2/pipelines/get-pipeline-details/" service: "All Services" related: - Catalyst Pipelines (/ja/pipelines/help/pipelines/introduction) - Create a Pipeline (/ja/pipelines/help/pipelines/create-a-pipeline) - Java SDK (/ja/sdk/java/v1/pipelines/get-pipeline-instance) - Python SDK (/ja/sdk/python/v1/pipelines/get-pipeline-instance) - REST API (/ja/api/code-reference/pipelines/get-pipeline-details) -------------------------------------------------------------------------------- # Pipelineの詳細取得 パイプラインIDをパラメーターとしてgetPipelineDetails()メソッドに渡すことで、Catalyst Pipelineの詳細を取得できます。パイプラインの名前、パイプラインが作成されたCatalystプロジェクトの詳細、パイプラインを作成したユーザーの詳細、作成時刻、および変更が行われた場合はパイプラインを変更したユーザーの詳細、変更時刻、パイプラインのステータス、ランナー仕様などのその他の詳細がこのメソッドのレスポンスとして返されます。 以下で使用されているpipelines_service参照は、このコンポーネントインスタンスページですでに定義されています。 let pipline_details = pipelines_service.getPipelineDetails("16965000000019146") サンプルレスポンスを以下に示します： { "status": "success", "data": { "pipeline_id": "16965000000019146", "name": "test1", "project_details": { "project_name": "Project-Rainfall", "id": "5000000000072", "project_type": "Live" }, "created_by": { "zuid": "20257791", "is_confirmed": false, "email_id": "amelia.burrows@zylker.com", "first_name": "Amelia", "last_name": "Burrows", "user_type": "Admin", "user_id": "5000000000056" }, "created_time": "Mar 19, 2024 11:28 AM", "modified_by": { "zuid": "20257791", "is_confirmed": false, "email_id": "amelia.burrows@zylker.com", "first_name": "Amelia", "last_name": "Burrows", "user_type": "Admin", "user_id": "5000000000056" }, "modified_time": "Mar 19, 2024 11:28 AM", "git_account_id": "", "mask_regex": [ null ], "pipeline_status": "Active", "config_id": 2, "integ_id": 1 } } -------------------------------------------------------------------------------- title: "Pipelineの実行" description: "このページでは、Catalyst Pipelineを手動で実行するメソッドについて説明します。" last_updated: "2026-09-09T11:06:45.832Z" source: "https://docs.catalyst.zoho.com/ja/sdk/nodejs/v2/pipelines/execute-pipeline/" service: "All Services" related: - Catalyst Pipelines (/ja/pipelines/help/pipelines/introduction) - Create a Pipeline (/ja/pipelines/help/pipelines/create-a-pipeline) - Java SDK (/ja/sdk/java/v1/pipelines/get-pipeline-instance) - Python SDK (/ja/sdk/python/v1/pipelines/get-pipeline-instance) - REST API (/ja/api/code-reference/pipelines/get-pipeline-details) -------------------------------------------------------------------------------- # Pipelineの実行 パイプラインIDとブランチ名をパラメーターとしてrunPipeline()メソッドに渡すことで、Catalystパイプラインの実行を開始できます。また、パイプラインの実行に必要な環境変数をJSONオブジェクトとしてこのメソッドに渡すこともできますが、これは完全に任意です。このメソッドは、パイプラインの実行履歴の詳細をレスポンスとして返します。 以下で使用されているpipelines_service参照は、このコンポーネントインスタンスページですでに定義されています。 let execution_details = pipelines_service.runPipeline("8431000000162051", main,{"EVENT": "push", "URL":"https://www.google.com"}) サンプルレスポンスを以下に示します： { "status": "success", "data": { "history_id": "5000000021007", "pipeline_id": "8431000000162051", "event_time": "Mar 20, 2024 02:02 PM", "event_details": { "BRANCH_NAME": "main", "EVENT": "push", "URL": "https://www.google.com" }, "history_status": "Queued" } } --- ## SDK — Python — Pipelines -------------------------------------------------------------------------------- title: "パイプラインインスタンスの取得" description: "このページでは、パイプラインインスタンスを取得して他のパイプライン操作に使用する方法を説明します。" last_updated: "2026-09-09T11:06:45.834Z" source: "https://docs.catalyst.zoho.com/ja/sdk/python/v1/pipelines/get-pipeline-instance/" service: "All Services" related: - Catalyst Pipelines (/ja/pipelines/help/pipelines/introduction) - Create a Pipeline (/ja/pipelines/help/pipelines/create-a-pipeline) - Java SDK (/ja/sdk/java/v1/pipelines/get-pipeline-instance) - NodeJS SDK (/ja/sdk/nodejs/v2/pipelines/get-pipeline-instance) - REST API (/ja/api/code-reference/pipelines/get-pipeline-details) -------------------------------------------------------------------------------- # Catalyst Pipelines Catalyst Pipelinesは、CI/CDアプローチを実装し、WebまたはモバイルアプリケーションのビルドBuild、テスト、および優先環境へのデプロイの自動化を可能にします。 Catalystコンソールからパイプラインを作成できます。以下のSDKを使用して、Catalyst Pipelineの詳細を取得したり、アプリケーションにコードスニペットを組み込んでパイプラインを実行したりできます。 # パイプラインインスタンスの取得 コンポーネントインスタンスは、特定のコンポーネントに固有のプロパティにアクセスするために使用できるオブジェクトです。Catalyst Pipelinesで以下にリストされているアクションを実行するためのコンポーネントインスタンスを作成できます。 以下のコードで使用されているappリファレンスは、SDK初期化時にレスポンスとして返されるPythonオブジェクトです。以下に示すように、新しいpipelines_serviceインスタンスを作成できます。 pipelines_service = app.pipeline() このコンポーネントインスタンスは、Node.js SDKのすべてのPipeline操作で使用されます。 -------------------------------------------------------------------------------- title: "パイプラインの詳細取得" description: "このページでは、既存のCatalyst Pipelineのすべての詳細を取得する方法を説明します。" last_updated: "2026-09-09T11:06:45.834Z" source: "https://docs.catalyst.zoho.com/ja/sdk/python/v1/pipelines/get-pipeline-details/" service: "All Services" related: - Catalyst Pipelines (/ja/pipelines/help/pipelines/introduction) - Create a Pipeline (/ja/pipelines/help/pipelines/create-a-pipeline) - Java SDK (/ja/sdk/java/v1/pipelines/get-pipeline-instance) - NodeJS SDK (/ja/sdk/nodejs/v2/pipelines/get-pipeline-instance) - REST API (/ja/api/code-reference/pipelines/get-pipeline-details) -------------------------------------------------------------------------------- # パイプラインの詳細取得 パイプラインIDをパラメータとしてget_pipeline_details()メソッドに渡すことで、Catalyst Pipelineの詳細を取得できます。パイプラインの名前、パイプラインが作成されたCatalystプロジェクトの詳細、パイプラインを作成したユーザーの詳細、作成日時、変更が行われた場合はパイプラインを変更したユーザーの詳細、変更日時、パイプラインのステータス、およびランナー仕様などのその他の詳細がこのメソッドのレスポンスとして返されます。 以下で使用されているpipelines_serviceリファレンスは、このコンポーネントインスタンスページですでに定義されています。 pipeline_details = pipelines_service.get_pipeline_details("16965000000027475") サンプルレスポンスを以下に示します： { "status": "success", "data": { "pipeline_id": "16965000000027475", "name": "test1", "project_details": { "project_name": "Project-Rainfall", "id": "5000000000072", "project_type": "Live" }, "created_by": { "zuid": "20257791", "is_confirmed": false, "email_id": "amelia.burrows@zylker.com", "first_name": "Amelia", "last_name": "Burrows", "user_type": "Admin", "user_id": "5000000000056" }, "created_time": "Mar 19, 2024 11:28 AM", "modified_by": { "zuid": "20257791", "is_confirmed": false, "email_id": "amelia.burrows@zylker.com", "first_name": "Amelia", "last_name": "Burrows", "user_type": "Admin", "user_id": "5000000000056" }, "modified_time": "Mar 19, 2024 11:28 AM", "git_account_id": "", "mask_regex": [ null ], "pipeline_status": "Active", "config_id": 2, "integ_id": 1 } } -------------------------------------------------------------------------------- title: "パイプラインの実行" description: "このページでは、Catalyst Pipelineを手動で実行する方法を説明します。" last_updated: "2026-09-09T11:06:45.835Z" source: "https://docs.catalyst.zoho.com/ja/sdk/python/v1/pipelines/execute-pipeline/" service: "All Services" related: - Catalyst Pipelines (/ja/pipelines/help/pipelines/introduction) - Create a Pipeline (/ja/pipelines/help/pipelines/create-a-pipeline) - Java SDK (/ja/sdk/java/v1/pipelines/get-pipeline-instance) - NodeJS SDK (/ja/sdk/nodejs/v2/pipelines/get-pipeline-instance) - REST API (/ja/api/code-reference/pipelines/get-pipeline-details) -------------------------------------------------------------------------------- # パイプラインの実行 パイプラインIDとブランチ名をパラメータとしてrun_pipeline()メソッドに渡すことで、Catalystパイプラインの実行を開始できます。また、パイプライン実行に必要な環境変数をJSONオブジェクトでこのメソッドに渡すこともできますが、これは完全にオプションです。このメソッドは、パイプラインの実行履歴の詳細をレスポンスとして返します。 以下で使用されているpipelines_serviceリファレンスは、このコンポーネントインスタンスページですでに定義されています。 execution_details = pipelines_service.run_pipeline("18014000000023048", "main", {"EVENT": "push","URL":"https://www.google.com"}) サンプルレスポンスを以下に示します： { "status": "success", "data": { "history_id": "5000000021007", "pipeline_id": "18014000000023048", "event_time": "Mar 20, 2024 02:02 PM", "event_details": { "BRANCH_NAME": "main", "EVENT": "push", "URL": "https://www.google.com" }, "history_status": "Queued" } }