🔥

【過去Blogからの移行記事】Integromatを使って、Bitbucket で発生した課題やプルリクからTrelloのカードを作る

2022/09/18に公開

Integromat について日本語による情報が乏しい現状のようなので、
こないだ把握した掲題のセッティング方法をWebへ共有しておきたいと思います。

Integromat がいったい何をする者なのか知りたければ、下記の記事が参考になると思います。

■前提

本記事は次の準備を終えていることを前提とした内容となっています。

  1. Bitbucket に自分のアカウントを持ち、任意のリポジトリを作成済みで、そのリポジトリの設定で「課題管理」を有効化済みである。
  2. Trello に自分のアカウントを持ち、任意の board に任意の list を作成済みである。
  3. Integromat に自分のアカウントを持っている。

■本記事のストーリー

  1. 「bitbucket課題からTrelloカード作成」

    • cron のような定期実行のシナリオ作成の手順を記述します。
  2. 「bitbucketプルリクからTrelloカード作成」

    • プルリク生成時にIntegromatのwebhookモジュールをBitbucket側からキックするように設定し、その際にBitbucketからPOSTされたJSONデータを使ってTrelloカードの内容が作成されるシナリオの作成手順を記述します。

【Story-1. 定期実行型シナリオ: Bitbucket で発生した課題からTrelloのカードを作る】

ここでは、「Bitbacketのとあるリポジトリにて、新たに登録された課題があるかどうかを2時間おきにチェックし、あれば該当する課題それぞれをTrello側の指定boardの指定listへカードとして作成する」というシナリオを、Integromatへ作成する手順を記述します。

1. Integromat にログインし、画面左側メニューから Scenarios をクリック

2. Scenarios画面内の「+ Create a new scenario」ボタンをクリックする

3. 対象サービスが一覧されている画面にて、課題(issue)の発生源である「Bitbucket」を選択し、「Continue >」ボタンをクリック

4. シナリオ作成画面にて、画面中央に鎮座する大きな「?」アイコンをクリックしてBitbucketモジュールを選択し、TRIGGERSセクション内にある「Watch issues」を選択する

Story-1_4.png

5. Bitbucketモジュールの設定画面にて、次の操作を行う

  1. Connection欄の「Add」ボタンから自身のアクセス権のあるBitbucketリポジトリと接続する

Story-1_5-1.png

  1. Repository欄にて任意のリポジトリを選択する
  2. Watch欄にて「Only new issues」を選択する。
  3. 「OK」ボタンをクリックする

Story-1_5-4.png

  1. シナリオ処理の開始対象となるissueの条件を選択する(よくわからなかったら「All issues」でいいんじゃないかな)

Story-1_5-5.png

6. 画面下部の「+」(Add)アイコンからモジュール選択のリストを表示し、「Trello」を選択する

Story-1_6.png

  1. Actionセクション内にある「Create a card」を選択する

Story-1_6-1.png

  1. 画面上に生成されたTrellモジュールのアイコンと元々あったBitbucketモジュールのアイコンとを、BitbucketモジュールをStartとして繋げる。

  2. Trelloモジュールのアイコンをクリックする

  3. Connection欄の「Add」ボタンから自身のアクセス権のあるTrelloアカウントと接続する

  4. Enter a list ID欄にて「Select」を選択し、Board欄にて任意のボードを選択し、List欄にて任意のリストを選択する。

Story-1_6-5.png

  1. Name欄にフォーカスを当てて、Bitbucketのissueオブジェクトの持つキー一覧の中から適当に組み合わせてカードのNameを作成する

Story-1_6-6.png

  1. Description欄にフォーカスを当て、Bitbucketのissueオブジェクトの持つキー一覧の中から適当に組み合わせてカードの詳細説明文を作成する。

Story-1_6-7.png

  1. 「OK」ボタンをクリックする

7. 画面下部のCONTROLS欄からSaveアイコンをクリック

8. Run scenario欄にて「At regular intervals」を選択し、Interval欄にて「120」(秒)を入力し、「OK」ボタンをクリックする

Story-1_8.png

9. 画面下部のSCHEDULING の「ON/OFF」スイッチをクリック

10. あとは定期実行を待つだけだが、シナリオ編集画面下部にある「[▷] Run once」アイコンから当該シナリオの即時実行が出来ます。


【Story-2. 発生時webhook起動型シナリオ: Bitbucket でプルリク生成を契機にTrelloのカードを作る】

ここでは、「Bitbacketのとあるリポジトリにて、プルリクエストが生成されたらその内容を元にTrello側の指定boardの指定listへカードを作成する」というシナリオを、Integromatへ作成する手順を記述します。

1. Integromat にログインし、画面左側メニューから Scenarios をクリック

2. Scenarios画面内の「+ Create a new scenario」ボタンをクリックする

3. 対象サービスが一覧されている画面にて「Webhooks」を選択し、「Continue >」ボタンをクリック

Story-2_3.png

4. シナリオ作成画面にて、画面中央に鎮座する大きな「?」アイコンをクリックしてWebhooksモジュールを選択し、TRIGGERSセクション内にある「Custom webhook」を選択する

Story-2_4.png

5. Webhooksモジュールの設定画面にて、次の操作を行う

  1. 「Add」ボタンから開くウィンドウにて任意のhook名をつけ、「OK」ボタンでウィンドウを閉じる。(IP restrictions はひとまず指定しなくても良い)

Story-2_5-1.png

  1. この時点でWebhooksのモジュール設定画面は次の状態となる

当該WebhookのURLが表示される
Story-2_5-2.png

このURLを控えておくこと(この後のBitbucket側のwebhook追加画面の入力内容に使用する)。
また、[Stop]のボタン表示は今回の場合、次の項での設定による「Bitbucket側からプルリク発生時に Integromat の Webhook へPOSTされるデータ」を解析するために「POSTリクエスト受信待ち」のということです。

6. Bitbucket にログインし、任意のリポジトリにて次の操作を行う

  1. リポジトリ内メニューより「設定」をクリック
  2. 設定メニューより「Webhooks」をクリックし、Webhooksコンテンツから「Add webhook」ボタンをクリック

Story-2_6-2.png

  1. webhook追加画面にて、次の操作を行う

    i. Title: 任意のタイトルを入力
    ii. URL: Integromat側のWebhooksモジュール作成中に生成され控えておいたURLを貼り付ける
    iii. Triggers: 「Choose from a full list of triggers」を選択し、プルリクエスト欄の「作成」のみを選択状態にする
    Story-2_6-3.png
    iv. 他の項目には手を加えずに「save」ボタンで保存する

  2. 当該リポジトリにて適当なプルリクエストを生成する

Story-2_6-4.png

この時、Intgromat側で作成中のwebhooksモジュールにて「POSTリクエスト受信待ち」だった[Stop]ボタンが「Successfuly determined. 」に変わっていることを確認する

Story-2_6-4-0.png

※変わっていなければ、おそらくBitbucket側リポジトリの Add webhook でセットしたURLが間違っています

7. Integromat側の Webhooksモジュール設定画面を[OK]ボタンで閉じる

8. Webhooksモジュールアイコンの右側に飛び出た部分にマウスポインタを合わせてクリックし、追加モジュール選択画面にて「 Add another module」

  1. Trelloを選択する
    Story-2_8-1.png

  2. ACTIONSセクション内にある「Create a card」を選択する
    Story-2_8-2.png

  3. Connection欄の「Add」ボタンから自身のアクセス権のあるTrelloアカウントと接続する

  4. Enter a list ID欄にて「Select」を選択し、Board欄にて任意のボードを選択し、List欄にて任意のリストを選択する。
    Story-2_8-4.png

  5. Name欄にフォーカスを当てて、Custom webhookで解析されたpullrequestデータ構造の持つキー一覧の中から適当に組み合わせてカードのNameを作成する

  6. Description欄にフォーカスを当て、Custom webhookで解析されたpullrequestデータ構造の持つキー一覧の中から適当に組み合わせてカードの詳細説明文を作成する。
    Story-2_8-6.png

  7. 「OK」ボタンをクリックする

9. Run scenario欄にて「Immediately」が選択されていることを確認しておく

Story-2_9.png

10. 画面下部のCONTROLS欄からSaveアイコンをクリックしてシナリオ一覧画面へ戻る

Story-2_10.png

11. Scenariosメニューにて、作成したシナリオの「ON/OFF」スイッチを ON にする

Story-2_11.png

12. Bitbucketの当該リポジトリ画面にて、再度適当なプルリクエストを生成し、Integromat側で指定した内容のカードがTrelloへ作成されていることを確認する

Story-2_12.png

本日の記事は以上になります。

Discussion