Loading

トピック

このトピックに関する記事は見つかりませんでした。

このトピックに関する記事は見つかりませんでした。

このトピックに関する記事は見つかりませんでした。

ノート iconノート

この機能は早期アクセス段階にあり、一部のお客様のみが利用できます。

コマンドのソース管理連携により、GitHub のリポジトリがコマンドバイ Asana に接続され、プルリクエストのアクティビティがチケットと同期されます。リポジトリと個人用 GitHub アカウントを接続すると、プルリクエストのイベントに基づいてチケットのステータスが更新され、レビュー担当者の受信トレイに通知が届き、GitHub と Command の間でコメントが同期されるようになります。

ドメインの GitHub 連携のセットアップ

ドメイン管理者は、組織全体でコーディングエージェントの連携を有効にできます。

  1. コマンドモードに切り替えます。
  2. サイドパネルで「管理者」を選択します。このオプションは、ドメインの管理者にのみ表示されます。
  3. GitHubの横にある「接続」をクリックします。
  4. GitHub が別のウィンドウで開きます。アプリをインストールする組織またはリポジトリを選択し、「インストール」をクリックして接続を認証します。
  5. Asana に戻ります。リポジトリ連携が接続されると、コントロールが「連携を解除」に変わり、オートメーション設定が利用可能になります。

個々のユーザーの GitHub アカウントをセットアップする

  1. プロフィール設定に移動します。
  2. アプリ」セクションに切り替えます。
  3. 「個人用 GitHub アカウント」の横にある「接続」をクリックして、GitHub アカウントを連携します。この接続により、GitHub のコメントが Asana ドメインユーザーにマッピングされます。

オートメーションルールの設定

GitHub を接続した後、プルリクエストイベントに基づいてチケットのステータスを更新するオートメーションルールを設定します。チームスペース設定で「連携」セクションに移動し、「選択」ドロップダウンを使って各イベントのチケットステータスを選択します。

  • 下書きのプルリクエストが作成されたら、ステータスを...に更新する
  • プルリクエストがオープンされたときに、ステータスを...に更新
  • プルリクエストにレビューリクエストまたはアクティビティがある場合、ステータスを次の値に更新します...
  • プルリクエストのマージ準備が整ったら、ステータスを次の状態に更新します…
  • プルリクエストがマージされたら、ステータスを…に更新

たとえば、プルリクエストがオープンになったときにチケットを「レビュー中」に移動するように設定できます。プルリクエストイベントが発生した後、チケットのステータスとリンクされたプルリクエストの情報が更新されるまで数秒お待ちください。

プルリクエストをチケットにリンクする

プルリクエストをコマンドチケットにリンクする方法は 2 つあります。

  1. プルリクエストのタイトルにチケット ID を追加する。「[CODE-620] ログインのバグを修正」のように、CommandチケットIDをタイトルに直接含めます。
  2. プルリクエストの説明にマジックワードを使用する。サポートされているキーワードを追加し、その後に 1 つ以上のチケットの URL または ID を続けます。サポートされているキーワードには、タスクタスクチケットチケット、参照、参照、参照一部関連貢献向け向けが含まれます。マジックワードの後に複数のチケットの URL または ID を含めることで、プルリクエストを複数のチケットにリンクできます。

プルリクエストを作成すると、連携によってプルリクエストがチケットにリンクされ、設定されたステータスオートメーションが適用されます。レビュアーは Asana で受信トレイの通知を受け取ることができ、コメントは GitHub とリンクされたチケット間で同期されます。

リンクされているプルリクエストの表示

リンクされたプルリクエストは、チケットの「バージョン管理」セクションに表示されます。プルリクエストをクリックすると、レビュー担当者の詳細、レビューにかかった時間、現在のレビューステータス、プルリクエストへのリンクが表示されます。ステータスには、変更リクエスト保留中などがあります。

複数のプルリクエストを 1 つのチケットにリンクすることで、チームは関連するコードの変更を 1 か所で追跡できます。

フォワードオンリーのステータス保護

この連携では、チケットのステータス更新にフォワードオンリー保護を使用します。GitHubイベントは、チケットをワークフロー内で前方に進めることはできますが、後続のステータスに到達した後でチケットを後方に戻すことはできません。

たとえば、チケットがすでに「レビュー中」になっていて、チケットを「未着手」に移行するように設定された下書きのプルリクエストをリンクした場合、チケットは「レビュー中」のままになります。下書きのプルリクエストは引き続きリンクされますが、ステータスは元の状態に戻りません。

コメント同期を理解する

リンクされているプルリクエストのコメントは、関連するコマンドチケットに表示されます。個人用 GitHub アカウントを接続すると、GitHub のコメントは Asana ドメインのユーザーに紐付けられます。

同期されたコメントには、コメントのテキスト、プルリクエストのタイトル、コメントとプルリクエストへのリンクが含まれます。複数のリンクされたプルリクエストのコメントが同じチケットに表示されることがあります。

 

Note iconノート

この記事は AI によって翻訳されています。

翻訳に関するフィードバックを送る。
読み込み中
コマンド GitHub 連携 | Asana ヘルプセンター