GitHub과 Asana | 제품 가이드

개요

Asana for GitHub 연동을 사용하면 GitHub 끌어오기 요청의 상태 업데이트를 Asana 작업에 자동으로 동기화하여 부서 간 협업을 개선할 수 있습니다.

이 연동은 기술 팀과 비기술 팀 간에 수행하는 엔지니어링 업무의 가시성과 투명성을 높이는 데 도움이 됩니다. 이 새로운 연동을 사용하면 개발자는 Asana를 통해 수월하게 소통할 수 있어 팀과 다른 부서의 이해관계자에게 지속적으로 정보를 제공할 수 있고 업무를 놓치는 일을 방지할 수 있습니다.

Asana for GitHub 연동은 모든 Premium, Business, 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는 두 가지 유형의 GitHub Actions를 지원합니다.

  1. Asana에서 GitHub 끌어오기 요청 알림 자동화하기: 이 동작은 끌어오기 요청의 상태를 Asana 작업에 댓글로 표시합니다. 댓글에는 끌어오기 요청 제목과 관련 Asana 작업의 링크가 포함됩니다. 이 동작을 설정하려면 GitHub Action 페이지를 방문하세요.
  2. GitHub 끌어오기 요청 설명에 있는 끌어오기 요청 첨부 파일을 Asana에 연결하기: 이 동작은 Asana 작업 URL을 끌어오기 요청 설명에 추가하여 GitHub 끌어오기 요청을 Asana 작업에 자동으로 연결합니다. 이 동작을 설정하려면 GitHub Action 페이지를 방문하세요.

여타 GitHub Actions와 마찬가지로, 이 두 동작은 동작을 설정한 리포지토리에서 이벤트가 발생할 때만 실행됩니다. 예를 들어, 끌어오기 요청이 병합되거나 댓글이 달릴 때마다 동작이 실행되도록 설정할 수 있습니다.

이러한 GitHub Actions는 동일한 리포지토리에 다수의 동일한 동작이 있지 않는 한 개별적으로 설정되어야 합니다. 예를 들어, 테스트가 완료되면 끌어오기 요청 설명에서 작업에 댓글을 다는 동작을 설정하고 끌어오기 요청이 병합되면 작업에 또 다른 댓글을 추가하는 동작을 설정할 수 있습니다.

기존 워크플로의 일부로 GitHub Actions를 추가할 수도 있습니다. 자세한 내용은 GitHub Actions 리소스 가이드를 참고하세요.

시크릿 토큰 취소하기

이전 섹션에서 Github Actions를 설정한 경우, 시크릿 토큰을 취소할 수 있습니다. 이 설정 페이지에 방문하여 Revoke all(모두 취소)를 선택하세요.

이렇게 하면 기존의 모든 GitHub Actions 시크릿 토큰이 취소됩니다.

이 연동을 추가했던 기존의 Asana 프로젝트에서 끌어오기 요청 정보를 여전히 확인할 수 있습니다.

주요 기능

Asana에서 Asana 작업에 끌어오기 요청을 첨부하는 방법

Asana에서 GitHub 연동을 설치하고 나면 관련 프로젝트에 있는 모든 작업에서 GitHub 필드를 확인할 수 있습니다.

Asana 작업에 표시되는 GitHub 필드

Asana 작업에 끌어오기 요청을 첨부하려면 끌어오기 요청 URL을 검색하여 빈 GitHub 필드에 붙여넣습니다. 그러면 GitHub 내의 검토 상태, 빌드 상태, PR 상태, 라인 변경, 대화 수와 같은 세부 정보가 포함된 위젯이 Asana 작업에 표시됩니다.

GitHub 끌어오기 요청 링크

GitHub에서 Asana 작업에 끌어오기 요청을 첨부하는 방법

Asana에서 GitHub 연동을 설치하고 GitHub Actions를 설정한 뒤 Github 끌어오기 요청 설명에서 Asana 작업으로 끌어오기 요청을 자동 첨부할 수 있습니다.

GitHub 끌어오기 요청 설명

GitHub 끌어오기 요청 설명에서 Asana 작업 URL을 검색하고 설명에 붙여 넣습니다. Asana에서 작업을 확인할 때 검토 상태, 빌드 상태, PR 상태, 라인 변경 정보과 같은 세부 정보가 포함된 위젯이 Asana 작업에 표시됩니다.

오류는 GitHub 내의 GitHub Actions 탭에 반영되어야 합니다.

끌어오기 요청의 통합 및 종결 관련 업데이트를 받는 방법

담당 팀이 검토한 후 변경 사항을 통합하면 GitHub에서 끌어오기 요청을 종결할 수 있습니다. Asana 위젯의 상태는 자동으로 업데이트됩니다.

새로운 GitHub 끌어오기 요청을 첨부하려는 경우, 신규 GitHub 끌어오기 요청 설명에 Asana 작업 URL을 추가하면 위젯이 자동으로 교체됩니다. 또는 오른쪽 상단 메뉴를 클릭하여 Asana 내에서 종결된 끌어오기 요청을 제거할 수 있습니다. 요청이 제거되면 신규 GitHub 끌어오기 요청 URL을 입력할 수 있습니다.

Asana에 GitHub 연동을 설치하고 GitHub Actions를 설정하고 나면 첨부된 오픈 상태의 끌어오기 요청과 함께 Asana 작업에서 댓글을 받을 수 있습니다. 댓글에는 끌어오기 요청이 통합되었는지 또는 종결되었는지를 알려주는 업데이트가 포함됩니다.

업데이트

FAQ

  • 생성된 동일한 시크릿을 여러 리포지토리에서 사용할 수 있나요?
  • 팀원이 제가 Asana 작업에 첨부한 끌어오기 요청에 대한 액세스 권한을 가지고 있지 않더라도 해당 요청에 관한 정보를 볼 수 있나요?
    • 예. 작업에 끌어오기 요청을 첨부하면 작업을 볼 수 있는 모든 사람이 위젯에서 정보를 확인할 수 있습니다.
  • 새로운 토큰을 생성하면 이전의 시크릿 토큰은 사용할 수 없게 되나요?
    • 아니요. 이전의 시크릿 토큰을 계속 사용할 수 있습니다. 기존 시크릿 토큰을 비활성화하려면 여기에서 설정할 수 있습니다.
  • 생성된 동일한 시크릿을 여러 리포지토리에서 사용할 수 있나요?
  • 워크플로 파일을 푸시하려 하는데 git에서는 제 토큰에 워크플로를 생성하기 위한 액세스 권한이 없다고 합니다. 어떻게 해야 하나요?
  • 이러한 GitHub 권한을 요청하는 이유는 무엇인가요?
    • 이 연동에서는 끌어오기 요청에서 읽고 쓰는 작업만 수행합니다. 권한 부여 페이지의 권한은 GitHub에서 끌어오기 요청에 액세스하기 위해 요청하도록 허용하는 권한 중 가장 제한적인 권한입니다.
  • GitHub Action이 연동이 활성화되지 않은 프로젝트의 작업에 끌어오기 요청을 첨부하면 어떻게 되나요?
    • 끌어오기 요청에 연결되는 첨부는 작업의 댓글 섹션에서 볼 수 있지만, 끌어오기 요청 상태를 동기화하는 위젯은 표시되지 않습니다.

죄송합니다. 이 브라우저는 지원하지 않습니다

Asana는 현재 사용 중인 인터넷 브라우저와 호환되지 않습니다. 지원되는 브라우저 중 하나를 사용하여 가입하세요.

언어 선택

언어를 선택하면 asana.com의 언어 및/또는 내용이 변경됩니다