GitHub & Asana | 製品ガイド

概要

Asana for GitHub の連携を使用すると、GitHub のプルリクエストのステータス更新を Asana のタスクに自動的に同期できるため、部門間のコラボレーションがさらに容易になります。

この連携を使用すれば、技術チームと非技術チームの間でエンジニアリング業務の可視性と透明性を高めることができます。また、開発者は Asana を介して簡単にコミュニケーションをとれるようになるため、チームや他部門の関係者にも情報を提供できるようになり、仕事の見落としも防げます。

Asana for GitHub との連携は、すべての PremiumBusiness、および Enterprise のお客様にご利用いただける機能です。

Asana と GitHub Actions の連携のインストール

Asana と GitHub を連携してプルリクエストのステータスを同期します。この連携を活用するための設定は Asana 内で行われますが、他の機能も使う場合は GitHub 内でも設定が行われます。

カスタマイズメニュー付きのアプリを追加している様子を示したスクリーンショット

Asana で設定する方法:

  1. Asana for GitHub との連携をインストールする Asana プロジェクトを開きます。右上隅にある「カスタマイズ」メニューのドロップダウンをクリックします。
  2. アプリ」まで下にスクロールして、「+アプリを追加」を選択します。

GitHub アプリ

  • +プロジェクトに追加」をクリックして「GitHub」を選択します。
  • 画面の指示に従って、GitHub アカウントを認可します。
  • Asana for GitHub との連携はプロジェクトレベルでインストールされます。
  • 次の画面で、この連携を追加する他のプロジェクトを選択できます。

これで GitHub のプルリクエストを Asana タスクに連携できるようになりました。この連携で利用できる他の機能を有効化する場合は、次のセクションをお読みください。そうでない場合は、下の主な機能にお進みください。

GitHub Actionsを設定する方法

このセクションでは、git と、GitHub のリポジトリシークレットに関する基礎知識をお持ちであると想定して解説します。リポジトリシークレットをセットアップするためのアクセス権をお持ちでない方は、リポジトリのオーナーにお問い合わせください。

Asana では 2 種類の GitHub Actions をサポートしています

  1. Asana で GitHub のプルリクエストに関する通知を自動化する: このアクションを実行すると、プルリクエストのステータスに関するコメントが Asana タスクに表示されます。これには、プルリクエストのタイトルと関連付けられている Asana タスクが含まれます。これをセットアップするには、GitHub Action ページをご確認ください。
  2. GitHub のプルリクエストの説明にあるプルリクエストの添付を Asana に接続する: このアクションを実行すると、Asana タスクの URL がプルリクエストの説明に追加され、GitHub のプルリクエストが自動的に Asana タスクに接続されます。これをセットアップするには、GitHub Action ページをご確認ください。

他の GitHub Actions と同様に、これらはアクションをセットアップしたリポジトリのイベントが発生するときにだけ実行されます。たとえば、誰かがプルリクエストをマージしたり、プルリクエストに対してコメントをしたりする度に実行されるアクションをセットアップするといったことができます。

こうした GitHub Actions は、同じリポジトリに全く同じアクションが複数個ない限り、一つずつセットアップする必要があります。たとえば、テストが完了した時点でプルリクエストの説明の中にタスクのコメントを追加するアクションを 1 つセットアップし、プルリクエストがマージされた時点でタスクに別のコメントを追加する別のアクションをセットアップするといったことができます。

GitHub Actions は、既存のワークフローの一部として追加することもできます。詳細については、GitHub Actions リソースガイドを参照してください。

シークレットトークンの取り消し

前のページで GitHub Actions をセットアップしている場合は、シークレットトークンを取り消すことができます。こちらのセットアップページにアクセスして、すべて取り消すを選択してください。

これにより、GitHub Actions の既存のシークレットトークンがすべて取り消されます。

プルリクエストの情報は、この連携を追加した既存の Asana プロジェクトには引き続き表示されます。

主な機能

プルリクエストを Asana タスクに添付する方法 (Asana で行う場合)

GitHub との連携を Asana にインストールした後は、関連付けられているプロジェクトの各タスクに GitHub フィールドが表示されます。

タスクに表示される GitHub フィールド

プルリクエストを Asana タスクに添付するには、プルリクエストの URL を取得して、空の GitHub フィールドにペーストします。GitHub 内のレビューステータス、ビルドステート、プルリクエストステータス、変更行数、コメント数といった詳細が含まれたウィジェットが Asana タスクに表示されます。

GitHub プルリクエストのリンク

プルリクエストを Asana タスクに添付する方法 (GitHub で行う場合)

GitHub との連携を Asana にインストールし、GitHub Actions をセットアップした後は、GitHub プルリクエストの説明から自動的にプルリクエストを Asana タスクに添付できるようになります。

GitHub プルリクエストの説明

Asana タスクの URL を取得し、GitHub プルリクエストの説明の中にペーストします。Asana でタスクを表示するときには、レビューステータス、ビルドステータス、プルリクエストステータス、変更行数といった詳細が含まれたウィジェットが表示されるようになります。

エラーが発生する場合は、GitHub 内の GitHub Actions タブに反映されます。

プルリクエストのマージとクローズの最新情報を受信する方法

担当チームが変更内容をレビューし、マージした後は、GitHub 内でプルリクエストをクローズできます。Asana ウィジェットのステータスは自動的に更新されます。

新しい GitHub プルリクエストを追加する場合は、Asana タスクの URL を新しい GitHub プルリクエストの説明に追加することで、ウィジェットが自動的に置き換えられます。また、Asana の画面右上のメニューをクリックして、Asana からプルリクエストを削除することもできます。削除したあとは、新しい GitHub プルリクエスト URL を入力することができます。

GitHub との連携を Asana にインストールし、GitHub Actions をセットアップした後は、Asana タスクに関するコメントがオープンの状態のプルリクエストと一緒に送られてきます。これには、プルリクエストがマージされたのか、クローズされたのかを知らせる最新情報が含まれます。

最新情報

FAQ

  • 生成された同じシークレットを複数のリポジトリで使用できますか?
    • はい
  • 私が Asana タスクに添付するプルリクエストにアクセスできないチームメイトは、そのプルリクエストの情報を見ることができますか?
    • はい。タスクにプルリクエストを添付すると、タスクを表示できるメンバー全員がウィジェット内の情報を見ることができます。
  • 新しいトークンを生成すると、古いシークレットトークンは無効になりますか?
    • いいえ。古いシークレットトークンは引き続き使用できます。既存のシークレットトークンを無効化する場合は、こちらから行えます。
  • 生成された同じシークレットを複数のリポジトリで使用できますか?
    • はい
  • ワークフローファイルをプッシュしようとすると、私のトークンにはワークフローを作成するアクセス権がないと git に表示されます。どうすればいいですか?
  • こうした GitHub の権限をリクエストするのはどうしてですか?
    • この連携では、プルリクエストから読み取る、または書き込むという操作しか行いません。認証ページで付与する権限は、GitHub でプルリクエストにアクセスするためにリクエストできる最も制限の強い権限です。
  • GitHub Action により、連携が有効化されていないプロジェクトのタスクにプルリクエストが添付された場合はどうなりますか?
    • プルリクエストにリンクする添付はタスクのコメントセクションに表示されますが、プルリクエストのステータスを同期するウィジェットは表示されません。

申し訳ありませんが、このブラウザーはサポートされていません

Asana は現在お使いのインターネットブラウザーに対応していません。こちらの対応ブラウザーのいずれかを使ってご登録ください。

言語を選択

言語を選択すると asana.com の言語および / またはコンテンツが変更されます。