無料でビルドを開始
CircleCI.comアカデミーブログコミュニティサポート

トリガーの概要

1+ year ago1 min read
クラウド
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 アプリからパイプラインをトリガーする

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

  1. ダッシュボードの上部にあるブランチフィルターを使用して、ブランチを選択します。

    screenshot showing location of branch filter on pipelines dashboard
  2. Trigger Pipeline をクリックします。 この時点で、パイプラインパラメーターを指定するかどうかを選択できます。

    screenshot showing the popup you will see when slicking the trigger pipeline button in the web app
  3. 再度 Trigger Pipeline (または Cancel) をクリックすると新しいパイプラインが開始されます。

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

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

  1. まだ設定していない場合は、 API 開発者向けガイド のステップに従って、API v2 を使用するように設定します。

  2. 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>"}'
  3. CircleCI Web アプリに戻ると、実行中のパイプラインがダッシュボードに表示されます。

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

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

次のステップ

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


Suggest an edit to this page

Make a contribution
Learn how to contribute