Loading
製品
AI Platform
おすすめ機能
会社の規模別活用方法
チーム別活用方法
業界別
活用事例
学ぶ
サポート
サービス
ヘルプセンター
search-icon

トピック

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

GitHub と Asana の連携

この記事の内容

この機能を利用できるユーザー
StarterAdvancedEnterpriseEnterprise+PremiumBusiness旧 Enterprise

詳細は料金ページをご確認ください。

Asana for GitHub の連携は、Asana Starter、Advanced、Enterprise、Enterprise+ プラン、および旧プランの Premium、Business、旧 Enterprise プランでご利用いただけます。

詳細は料金ページをご確認ください。

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

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

この連携は、GitHub Enterprise Server をサポートしていません。

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

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

screen of adding app with customize menu

Asana での設定方法:

  1. Asana for GitHub との連携をインストールする Asana プロジェクトを開きます。画面右上隅にある「カスタマイズ」ボタンをクリックします。
  2. 「アプリ」まで下にスクロールして、「+ アプリを追加」を選択します。
Github app
  • 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 をセットアップしている場合は、シークレットトークンを取り消すことができます。こちらのセットアップページにアクセスして、「Revoke all (すべて取り消す)」を選択してください。

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

ノート iconノート

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

主な機能

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

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

Github field on task

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

Github pull request link

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

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

Github pull request description

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

ノート iconノート

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

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

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

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

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

updates

FAQ

生成された同じシークレットを複数のリポジトリで使用できますか？

はい

私が Asana タスクに添付するプルリクエストにアクセスできないチームメイトは、そのプルリクエストの情報を見ることができますか？

はい。タスクにプルリクエストを添付すると、タスクを表示できるメンバー全員がウィジェット内の情報を見ることができます。

新しいトークンを生成すると、古いシークレットトークンは無効になりますか？

いいえ。古いシークレットトークンは引き続き使用できます。既存のシークレットトークンを無効化する場合は、こちらから行えます。

生成された同じシークレットを複数のリポジトリで使用できますか？

はい

ワークフローファイルをプッシュしようとすると、私のトークンにはワークフローを作成するアクセス権がないとgitに表示されます。どうすればいいですか？

二要素認証を有効にしていて、かつコマンドラインでGitHubを操作している場合、GitHubはパーソナルアクセストークンをパスワードとして使用することを要求します。ワークフローのスコープに対して GitHub の新しいパーソナルアクセストークンを作成してください。

こうした GitHub の権限をリクエストするのはどうしてですか？

この連携では、プルリクエストから読み取る、または書き込むという操作しか行いません。認証ページで付与する権限は、GitHub でプルリクエストにアクセスするためにリクエストできる最も制限の強い権限です。

GitHub Action により、連携が有効化されていないプロジェクトのタスクにプルリクエストが添付された場合はどうなりますか？

プルリクエストにリンクする添付はタスクのコメントセクションに表示されますが、プルリクエストのステータスを同期するウィジェットは表示されません。

ノート iconノート

Asana を体験してみませんか？Asana のトライアルを、今すぐ無料で始められます。無料で試す。

Note iconノート

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

翻訳に関するフィードバックを送る。

関連記事

読み込み中
GitHub と Asana の連携の使い方 | Asana ヘルプセンター