ご質問がおありですか?

GitHub 統合

 

monday-dev-banner (2).png

 

 

monday.com は、ソースコードツールと monday.com の堅牢な統合がいかに大事であるかを理解しています。そこで、GitHub 統合をご紹介します。

GitHub との統合を一度インストールするだけで強力なテンプレートが提供されるため、チームは monday dev でのスプリントの計画と追跡から GitHub での完璧なコードの実行まで、シームレスなソフトウェア開発フローで作業できます。

統合は、アカウントレベルでの権限の統合です。わずか数ステップで統合がプリインストールされると、チーム全員、誰でも新しいテンプレートを作成できるようになります。

 

ヒント: GitHub 統合を正常に同期させるには、まず monday.com のアプリケーションを GitHub にインストールする必要があります。また、アプリケーションをインストールするには、monday.com アカウントの管理者であり、GitHub の組織に対する管理者権限を持っている必要があります。
まず、github.com/apps/monday-com-github にアクセスし、GitHub に monday.com アプリをインストールします。

Devs Install GitHub.png

 

アカウントで組織を選択するよう求められます:

Devs Choose Organization.png

 

次に、GitHub アカウントで monday.com を承認するよう求められます:

Devs monday Permissions.png

これがインストールされると、ユーザーは新しい GitHub テンプレートを追加でき、GitHub アカウントで自動的に認証されます。

 

ここをクリックして、これらのアクセス権の詳細をご確認ください

monday.com は、お客様のデータの名前や場所など、機能性を確保するために必要なデータのみにアクセスします。これらのアクセス権は次のとおりです:

  • コードへのアクセス - TODO テンプレート特有のものであり、monday.com はコードを保存せずに PR の変更を読み取り、monday  のアイテムに接続します。 
  • 問題 - monday.com は、該当する monday の自動化をトリガーするために、問題に関する情報にアクセスする必要があります。
  • メタデータ - monday.com は、該当する monday の自動化をトリガーするために、メタデータを含む読み取り専用エンドポイントのコレクションにアクセスする必要があります。これらのエンドポイントは、機密性の高いプライベートリポジトリ情報を提供することはありません。
  • プルリクエスト- monday.com は、関連する monday  自動化と monday の双方向同期テンプレートをトリガーするために、PR の変更を読み取り、プルリクエストに関する書き込み権限にアクセスする必要があります。

 

ワークフローに追加する

GitHub 統合テンプレートを目的のボードに追加するには、そのボードに移動し、右上隅にある統合 をクリックします。Group 64 (54).png

 

自動化センターに移動したら、検索バーに「GitHub」と入力します。Group 64 (55).png

 

GitHub バナーをクリックすると、統合で利用できるテンプレートが表示されます。Screenshot 2024-07-07 at 17.46.19 1.png

 

その後、ボードに追加したいテンプレートを選択したら完了です。

 

monday.com にサポートされている統合テンプレートは以下の通りです。
  • 問題がこのリポジトリの何かラベル付けされている場合は、アイテムを作成します。
  • プルリクエストがこれらのリポジトリにマージされ、そこにアイテム ID が記載されている場合、ステータス何かに変更します。
  • これらのリポジトリで問題が作成されたら、 アイテムを作成します。
  • これらのリポジトリでプルリクエストが作成され、そこにアイテム ID が記載されている場合、ステータス何かに変更します。
  • これらのリポジトリでプルリクエストが作成され、そこにアイテム ID が記載されている場合は、プルリクエストのリンクをリンクカラムに追加します。
  • これらのリポジトリにブランチが作成されたら、アイテムを作成します。
  • これらのリポジトリで問題のステータス何かに変化し、そこにアイテム ID が記載されている場合は、ステータスを何かに設定します。
  • github ユーザーこれらのリポジトリに TODO コメントをプッシュするとアイテムアイテムが作成されます。
  • これらのリポジトリで課題が作成され、そこにアイテム ID が記載されている場合は、このリンクカラムにリンクを追加してください。
  • これらのリポジトリでプルリクエストのステータス何かに変化し、そこにアイテム ID が記載されている場合は、ステータスを何かに設定します。
  • 問題がこのリポジトリで何かでラベル付けされ、アイテム ID が言及されている場合、ステータス何かに設定します。
  • プルリクエストのステータスがこれらのリポジトリで何かに変化し、アイテム ID がそこに記載されている場合は、更新を作成します。
  • プルリクエストがこのリポジトリ内の何かでラベル付けされ、アイテム ID が言及されている場合、ステータス何かに設定します。
  • これらのリポジトリで問題が作成されたら、アイテムを作成し、将来の変更を同期します。
  • これらのラベルを使用してこのリポジトリで問題が作成されたら、アイテム を作成し、将来の変更を同期します。
  • これらのリポジトリでプルリクエストが作成または更新されると、アイテム作成して今後の変更を同期します
  • アイテムが作成または更新されるときに、これらのフィールドを使用してこのリポジトリに問題を作成し、今後同期します

 

双方向同期を作成

双方向同期は、monday.com から GitHub にデータがプッシュされる時、またGitHub から monday.com にデータがプルされる時に行われます。こうすることで、両プラットフォームでデータが一致し、最新の状態を保つことができます。

Group 64 (56).png

 

双方向同期を作成するには、ドロップダウンメニューで 双方向 を選択します。

たとえば、monday.com のアイテムのオーナーカラムと GitHub の担当者フィールドを対応させたい場合は、それぞれのドロップダウンでそれらのフィールドを選択します。その後、方向を選択ドロップダウンの下にある、双方向を選択します。

GitHub Two-Way Sync.gif

 

アイテム ID とは?

統合テンプレートの中には、2つのプラットフォームを同期するために monday.com と GitHub 間の「一意の接続」が必要なものもあります。アイテム ID はアイテムに関連付けられた一意の番号として機能します。

 

注:monday.com アイテム ID カラムが接続されたことを認識できるように、GitHub の番号の前に「#」記号を付ける必要があります。例: GitHub では「376479」ではなく「#376479」と表記する必要があります。 

 

Group 64 (57) (1) 1.png

 

例として統合テンプレートを見てみましょう。「このリポジトリでプルリクエストが作成されると、 アイテム ID  がプルリクエスト名に記載され、ステータスを何かに変更します。」

プルリクエストが GitHub で作成されると、システムは monday.com のアイテム ID を使用して、変更が必要なアイテムを識別します。

ヒント:アイテム ID カラムをクリックすると、ボードから自動的に値を簡単にコピーできます。

 

GitHub のアクション

GitHub アクションは、GitHub に組み込まれたツールで、ソフトウェア開発のワークフロー内のタスクを自動化することができます。繰り返しの作業をなくすことで、開発プロセスを合理化し、効率性を高めることができます。Screenshot 2024-07-07 at 17.29.51 1.png

GitHub アクションで何ができますか

  • CI/CDパイプラインの自動化:これにより、変更があるたびにコードをビルド、テスト、デプロイする自動プロセスを設定できるようになります。これはバグを早期に発見し、リリースプロセスを合理化するのに役立ちます。
  • ワークフローをイベントに基づいて実行: GitHub アクションはレポジトリの様々なイベントに基づいてワークフローをトリガーします。例えば、プルリクエストが提出されるたびに自動的にテストを実行するワークフローを作成できます。
  • アクションの大きなコミュニティ使用: 様々なタスクに使える、膨大な数のビルド済みアクションが用意されています。これらには、さまざまなプラットフォームへのコードの展開から、プロジェクト管理ツールでのチケットの作成まで、あらゆるものが含まれます。また、独自のカスタムアクションを作成することもできます。

特定の結論で終わる特定のワークフローに関するアイテムを開く、GitHub 統合のテンプレートを見つけることができます。アイテムにはワークフローデータを入力することができます。

テンプレートを使用するには自動化センター を開いて、GitHub を検索します。そこから、以下のようにテンプレートをクリックします。download (19).gif

注:GitHub アクションを使用するには、GitHub 組織管理者が「アクションリード権限」設定を許可する必要があります。問題に遭遇した場合は、当社にお問い合わせ下さい。 

 

他のどのようなヘルプが必要ですか?

アプリケーションを GitHub にインストールしなくても、新しい統合は機能しますか?

  • いいえ。アプリケーションが GitHub にインストールされていないと統合できません。

monday.com アカウントを GitHub の複数の組織に接続できますか?

  • もちろんです!monday.com アカウントを複数の GitHub の組織に接続することができます。

次に、GitHub から monday.com アプリケーションをアンインストールするには、GitHub アカウント > [設定] > [アプリケーション] に移動し、monday.com を見つけます。「危険ゾーン」まで下にスクロールし、「アンインストール」をクリックします。

 

カスタム統合の構築におけるサポートが必要な場合は、monday.com の認定パートナーによる有償でのサポートもご利用いただけます。ご興味のある方は、こちらのフォームにご記入ください。担当者からすぐにご連絡いたします。

 

ご不明な点がございましたら、こちらから担当チームにお問い合わせください。24時間年中無休でお答え致します。