トリガーの概要

クラウド

Server v4.x

Server v3.x

このページの内容

パイプラインは、アクションに応答してトリガーされるか、特定の時間と頻度で実行するようにスケジュール実行されます。ここでは、パイプラインをトリガーする方法について説明します。

コードリポジトリへのプッシュ時にパイプラインをトリガーする

プロジェクトが CircleCI に連携されると、.circleci/config.yml ファイルが含まれるブランチでコミットがプッシュされるたびにパイプラインがトリガーされます。コミットがプッシュされると、実行中のパイプラインがパイプラインダッシュボードに表示されます。CircleCI Web アプリの左側のサイドバーにある Dashboard を選択すると、このダッシュボードにアクセスできます。

Screenshot showing running pipelines in the CircleCI dashboard.

Figure 1. ダッシュボードに表示された実行中のパイプライン

CircleCI Web アプリからパイプラインをトリガーする

現在この機能は GitLab アカウントではご利用いただけません。

CircleCI Web アプリで特定のブランチを選択すると、Trigger Pipeline ボタンが有効になります。

ダッシュボードの上部にあるブランチフィルターを使用して、ブランチを選択します。
Trigger Pipeline をクリックします。この時点で、パイプラインパラメーターを指定するかどうかを選択できます。
再度 Trigger Pipeline (または Cancel) をクリックすると新しいパイプラインが開始されます。

API を使ってパイプラインをトリガーする

新しいパイプラインをトリガーするためのエンドポイントを使って、特定のプロジェクト用のパイプラインをトリガーすることができます。

まだ設定していない場合は、 API 開発者向けガイドのステップに従って、API v2 を使用するように設定します。
curl を使用してコマンドラインからパイプラインをトリガーするには、このサンプルリクエストをコピー & ペーストし、< > の内容を自分用の情報に置き換えます。VCS は gh または bb にできます。
```
curl -X POST https://circleci.com/api/v2/project/<VCS>/<your-vcs-org-or-username>/<your-repo-name>/pipeline \
  --header "Circle-Token: $CIRCLE_TOKEN" \
  --header "content-type: application/json" \
  --data '{"branch":"<your-branch-name>"}'
```
CircleCI Web アプリに戻ると、実行中のパイプラインがダッシュボードに表示されます。

API を使用してパイプラインをトリガーした場合は、パイプラインのパラメーターを指定することもできます。詳細は、 API v2 のドキュメントを参照してください。

パイプラインのスケジュール実行

パイプラインのスケジュール実行により、スケージュールに沿って定期的にパイプラインをトリガーすることができます。これをプロジェクトで設定するには、CircleCI Web アプリを使用するか API v2 を使用します。両方の方法の詳細は、パイプラインのスケジュール実行のドキュメントを参照してください。

次のステップ

ワークフローを使ったジョブのオーケストレーションのページで、パイプラインに含まれる作業要素のオーケストレーションについてお読みください。

ドキュメントの改善にご協力ください

このガイドは、CircleCI の他のドキュメントと同様にオープンソースであり、 GitHub でご利用いただけます。ご協力いただき、ありがとうございます。

このページの編集をご提案ください (最初に「コントリビューションガイド」をご覧ください)。
ドキュメントの問題点を報告する、またはフィードバックやコメントを送信するには、GitHub で issue を作成してください。
CircleCI は、ユーザーの皆様の弊社プラットフォームにおけるエクスペリエンスを向上させる方法を常に模索しています。フィードバックをお寄せいただける場合は、リサーチコミュニティにご参加ください。

サポートが必要ですか

CircleCI のサポートエンジニアによる、サービスに関する問題、請求およびアカウントについての質問への対応、設定の構築に関する問題解決のサポートを行っています。サポートチケットを送信して、CircleCI のサポートエンジニアにお問い合わせください。日本語でお問い合わせいただけます。

または、サポートサイトから、サポート記事やコミュニティフォーラム、トレーニングリソースをご覧いただけます。

CircleCI Documentation by CircleCI is licensed under a Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International License.