トピック

検索して、検索ビューを表示してください。

GitHubとAsanaの連携

この記事の内容

AsanaとGitHubのインストールアクション
主な機能
よくある質問

Asana for GitHubとの連携は、Asana Starter、Advanced、Enterprise、Enterprise +の各ランク、および従来のPremium、Business、Legacy Enterpriseの各ランクでご利用いただけます。

詳しくは、料金ページをご覧ください。

Asana for GitHubとの連携により、GitHubプルリクエストのステータス更新をAsanaタスクに自動的に同期し、部門間のコラボレーションを改善できます。

この統合は、技術チームと非技術チームの間のエンジニアリング作業に関する可視性と透明性を高めるのに役立ちます。この新しい連携により、開発者はAsanaを介して簡単にコミュニケーションをとることができ、チームや部門横断的な関係者に情報を提供し、仕事の見落としを防ぐことができます。

この統合はGitHub Enterprise Serverをサポートしていません。

AsanaとGitHubのインストールアクション

AsanaとGitHubを連携してプルリクエストのステータスを同期します。連携を利用するには、Asanaで構成を設定し、GitHubでも追加機能を設定します。

Asanaでの設定方法:

screen of adding app with customize menu

Asana for GitHub連携をインストールするAsanaプロジェクトに移動します。右上隅にある[カスタマイズ]ボタンをクリックします。
[アプリ]まで下にスクロールし、[アプリを追加]を選択します

GitHubを選択

指示に従って、GitHubアカウントを認証します。
Asana for GitHubの連携はプロジェクトレベルでインストールされます。

おめでとうございます。GitHubのプルリクエストをAsanaのタスクに接続できるようになりました。連携の追加機能を有効にしたい場合は、次のセクションを確認してください。それ以外の場合は、以下のキー機能にスキップしてください。

GitHubアクションを構成する方法：

このセクションでは、gitとGitHubリポジトリシークレットに基本的に精通していることを前提としています。リポジトリシークレットを設定するアクセス権がない場合は、リポジトリの所有者に連絡してください。

2種類のGitHubアクションをサポートしています。

AsanaでGitHubプルリクエスト通知を自動化:このアクションは、Asanaタスクのプルリクエストのステータスをコメントします。プルリクエストのタイトルと、関連するAsanaタスクへのリンクが含まれています。これを設定するには、GitHubアクションページにアクセスしてください。
GitHubのプルリクエストの説明からAsanaにプルリクエストの添付ファイルを接続:このアクションでは、AsanaのタスクのURLをプルリクエストの説明に追加することで、GitHubのプルリクエストをAsanaのタスクに自動的に接続します。これを設定するには、GitHubアクションページにアクセスしてください。

他のGitHubアクションと同様に、アクションを設定したリポジトリでイベントが発生した場合にのみ実行されます。たとえば、誰かがプルリクエストをマージしたりコメントしたりするたびに実行するアクションを設定できます。

同じリポジトリに複数の同じアクションがある場合を除き、これらのGitHubアクションはそれぞれ個別に設定する必要があります。たとえば、テストが完了したときにプルリクエストの説明でタスクにコメントするアクションと、プルリクエストがマージされたときにタスクに別のコメントを追加する別のアクションを設定できます。

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

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

前のセクションでGitHubアクションを設定した場合、シークレットトークンを取り消すことができます。この設定ページにアクセスし、[すべて取り消す]を選択します。

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

ノート

引き続き、この連携を追加した既存のAsanaプロジェクトでプルリクエスト情報を確認できます。

主な機能

プルリクエストをAsanaタスクに添付する方法(Asana内):

AsanaにGitHubとの連携をインストールすると、関連するプロジェクトのすべてのタスクにGitHubフィールドが表示されます。

プルリクエスト

をAsanaタスクに添付するには、プルリクエストのURLを取得し、空のGitHubフィールドに貼り付けます。これで、GitHub内のレビューステータス、ビルドステータス、PRステータス、ライン変更、会話数などの詳細が記載されたウィジェットがAsanaタスクに表示されるようになりました。

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

AsanaにGitHub連携をインストールし、GitHubアクションを設定したら、GitHubプルリクエストの説明からAsanaタスクにプルリクエストを自動的に添付できるようになりました。

GitHubプルリクエストの説明

で、AsanaタスクのURLを取得し、説明に貼り付けます。 Asanaでタスクを表示すると、「レビューステータス」、「ビルドステータス」、「PRステータス」、「ライン変更」といった詳細を含むウィジェットが表示されるようになりました。

ノート

エラーは、GitHub内の[GitHubアクション]タブに反映される必要があります。

プルリクエストのマージと更新の終了を受信する方法:

プルリクエストは、適切なチームが変更を確認してマージした後、GitHubで閉じることができます。 Asanaウィジェットのステータスは自動的に更新されます。

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

AsanaにGitHubとの連携をインストールし、GitHub Actionsを設定すると、オープンなプルリクエストが添付されたAsanaタスクに対するコメントが届きます。これには、プルリクエストがマージまたはクローズされたかどうかの更新が含まれます。

よくある質問

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

はい

チームメイトは、プルリクエストにアクセスできなくても、Asanaタスクに添付したプルリクエストに関する情報を見ることができますか？

はい。プルリクエストをタスクに添付すると、タスクを閲覧できる全員がウィジェットの情報を閲覧できます。

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

いいえ、古いシークレットトークンは引き続き機能します。既存のシークレットトークンを無効にしたい場合は、ここで行うことができます。

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

はい

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

2要素認証を使用しており、コマンドラインでGitHubと対話している場合、GitHubは個人アクセストークンをパスワードとして使用する必要があります。ワークフロースコープを使用して新しいGitHubパーソナルアクセストークンを作成してください。

これらのGitHubアクセス許可を要求する理由は何ですか？

この連携では、プルリクエストの読み取りと書き込みのみが行われます。認証ページの権限は、プルリクエストにアクセスするためにGitHubが要求できる最も制限的な権限です。

GitHubアクションが、連携が有効になっていないプロジェクト内のタスクにプルリクエストを添付した場合はどうなりますか？

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

ノート

あなたが見ているものが好きですか？今すぐAsanaの無料トライアルを始めましょう。無料でお試しください。

ノート
この記事は AI によって翻訳されています。
翻訳に関するフィードバックを送る。

製品情報

おすすめ機能

ASANA AI

プラン一覧

会社の規模別活用方法

チーム別活用方法

業界別

活用事例

学ぶ

サポート

サービス

トピック

トピック

GitHubとAsanaの連携