Azure DevOps 서비스 | Azure DevOps Server | Azure DevOps Server 2022
이 빠른 시작에서는 GitHub Azure Boards 앱을 설치하여 Azure Boards GitHub 리포지토리에 연결합니다. Azure Boards 프로젝트를 GitHub.com 리포지토리와 연결하는 경우 GitHub 커밋과 끌어오기 요청 간에 작업 항목에 대한 연결을 지원합니다. Azure Boards 사용하여 작업을 계획하고 추적하는 동안 소프트웨어 개발에 GitHub 사용할 수 있습니다. GitHub 계정 또는 조직에 GitHub Azure Boards 앱을 설치한 후 프로젝트에서 연결할 GitHub 리포지토리를 선택합니다.
GitHub Azure Boards 앱에서 지원하는 통합에 대한 개요는 Azure Boards-GitHub 통합 참조하세요.
Prerequisites
| Category | Requirements |
|---|---|
| Permissions | - 프로젝트 컬렉션 관리자 그룹구성원입니다. 프로젝트를 만든 경우 사용 권한이 있습니다. Azure Boards 앱을 설치하기 위한 GitHub 조직의 - 관리자 또는 소유자. GitHub 리포지토리에 대한 - Read 권한 |
| 프로젝트 멤버 자격 | 프로젝트 멤버. |
Important
OAuth와 같은 다른 인증 유형을 사용하여 리포지토리가 이미 연결된 경우 GitHub 앱을 사용하여 다시 연결하기 전에 기존 연결에서 해당 리포지토리를 제거해야 합니다. GitHub 앱을 구성하기 전에 이 문서의 뒷부분에 있는 GitHub 리포지토리 추가 또는 제거에 제공된 단계를 따르십시오.
해당 리포지토리의 관리자인 경우 Azure DevOps 조직을 여러 GitHub 리포지토리에 연결할 수 있습니다. GitHub 리포지토리를 둘 이상의 Azure DevOps 조직에 연결해서는 안 됩니다.
Azure Boards 앱 설치 및 구성
설치 순서는 계정 구성에 따라 달라질 수 있습니다. 필요한 경우 다음 단계 사이의 화면 프롬프트를 따릅니다.
GitHub Marketplace Azure Boards 앱으로 이동합니다.
요금제 및 가격 책정의 무료 아래에서 설치를 선택합니다.
Azure Boards 설치 및 권한 부여에서 Azure Boards에 연결할 리포지토리를 선택한 다음, 설치 및 권한 부여를 선택합니다.
이 예제에서는 모든 리포지토리를 사용합니다.
GitHub.com 연결하려는 Azure DevOps 조직 및 Azure Boards 프로젝트를 선택합니다.
스크린샷은 조직 및 프로젝트를 선택할 수 있는 Azure Boards 프로젝트 설정 페이지를 보여줍니다. 한 번에 하나의 프로젝트만 연결할 수 있습니다. 연결하려는 다른 프로젝트가 있는 경우 나중에 이 문서의 뒷부분에 있는 다른 프로젝트 또는 리포지토리 구성에 설명된 대로 이 작업을 수행할 수 있습니다.
Azure Boards 조직에 액세스 권한 부여
필요한 경우 Azure DevOps 조직에 GitHub 액세스 권한을 부여하려면 다음 단계를 수행합니다.
GitHub 웹 포털의 프로필 메뉴에서 settings 엽니다.
통합에서 애플리케이션을 선택합니다.
Authorized GitHub Apps>Azure Boards 선택합니다.
조직 액세스에서 나타날 수 있는 문제를 해결합니다. 권한 부여를 선택하여 액세스 요청이 보류 중인 것으로 표시되는 모든 조직에 대한 액세스 권한을 부여합니다.
타사 애플리케이션 액세스 정책 확인
GitHub 조직에서 Azure Boards 앱에 대한 타사 애플리케이션 액세스를 허용하는지 확인합니다. 타사 액세스가 제한된 경우 Azure DevOps 리포지토리를 추가하면 빈 목록이 표시되거나 오류가 발생할 수 있습니다.
액세스를 사용하도록 설정하려면 다음을 수행합니다.
GitHub 조직을 열고 설정 > OAuth 앱 정책으로 이동합니다.
Azure Boards 앱을 특별히 승인하거나(권장) 모든 타사 애플리케이션에 대한 제한을 제거합니다.
비고
이 설정을 변경하려면 조직 소유자 또는 관리자여야 합니다.
연결을 사용하세요
이 시점에서 Azure Boards GitHub 통합이 완료됩니다. 다음 단계를 건너뛰거나 이를 통해 연결에서 지원되는 기능을 이해할 수 있습니다.
보드에서 Azure Boards 프로젝트에서 사용하는 프로세스 모델에 따라 새 작업 항목을 선택하여 "README에 배지 추가"(문제(기본), 사용자 스토리(Agile) 또는 제품 백로그 항목(스크럼)이라는 새 작업 항목을 입력합니다.
README에 배지 추가라는 제목의 작업 항목이 보드에 나타납니다.
작업 항목을 열고 개발 섹션으로 이동한 다음 링크 추가를 선택합니다.
Link 형식에서 GitHub 끌어오기 요청 선택합니다.
리포지토리를 선택하고 끌어오기 요청 ID 및 선택적 주석을 입력합니다.
링크 추가를 선택합니다.
백그라운드에서 자동으로 수행되는 작업은 다음과 같습니다.
- 연결된 GitHub 리포지토리 목록에서 첫 번째 리포지토리의 추가 정보 파일에 배지를 추가합니다.
- 추가 정보 파일에 배지를 추가하여 업데이트에 대한 GitHub 커밋을 만듭니다.
- 추가 정보 파일에 대한 변경 내용을 병합하는 GitHub 끌어오기 요청을 만듭니다.
- GitHub 커밋 및 끌어오기 요청을 1단계에서 만든 작업 항목에 연결합니다.
작업 항목에서 첫 번째 끌어오기 요청 링크를 선택합니다.
스크린샷은 GitHub에서 열린 끌어오기 요청의 문제 양식을 보여줍니다. GitHub 끌어오기 요청이 새 브라우저 탭에서 열립니다.
병합 풀 리퀘스트를 선택합니다.
리포지토리 추가 정보 파일로 이동하여 추가된 배지를 봅니다.
자세한 내용은 GitHub 리포지토리에 대한 상태 배지 추가 참조하세요.
다른 프로젝트 또는 리포지토리 구성
다른 Azure Boards/Azure DevOps 프로젝트나 GitHub.com 리포지토리를 구성하거나, Azure Boards 앱 페이지에서 현재 구성을 변경할 수 있습니다. 자세한 내용은 리포지토리 추가 또는 제거 또는 Azure Boards 연결을 제거하세요.
리포지토리 추가 또는 제거 또는 Azure Boards 연결 제거
연결에 문제가 발생하는 경우 연결을 제거하고 새 연결로 다시 시작하는 것이 좋습니다.
Azure DevOps 프로젝트에서 프로젝트 설정>GitHub 연결로 이동합니다.
리포지토리를 추가하거나 제거하려면 연결에 대한 기타 옵션 줄임표를 선택하고 메뉴에서 리포지토리 추가 또는 리포지토리 제거를 선택합니다.
모든 리포지토리 및 연결을 제거하려면 연결 제거 옵션을 선택합니다. 그런 다음 제거를 선택하여 확인합니다.
리포지토리 액세스 변경
GitHub 웹 포털의 프로필 메뉴에서 settings 엽니다.
통합>애플리케이션을 선택합니다. 사용 GitHub 앱 아래에서 Configure 선택합니다.
스크린샷에는 Azure Boards와 설정 옵션을 포함한 설치된 GitHub 앱이 표시됩니다. Azure Boards 구성 페이지가 열립니다.
리포지토리 액세스 섹션까지 아래로 스크롤합니다.
원하는 옵션을 선택하세요, 모든 저장소 또는 선택한 저장소만.
선택된 리포지토리만을 선택하는 경우, Azure Boards 통합에 참여할 리포지토리를 선택합니다.
저장을 선택합니다.
Azure Boards 통합 일시 중단 또는 제거
이전 절차의 2단계부터 위험 영역 섹션까지 아래로 스크롤합니다.
통합을 일시 중단하려면 일시 중단을 선택합니다. 확인 창에서 확인을 선택하여 일시 중단을 확인합니다.
통합을 일시 중단 해제하려면 일시 중단 취소를 선택합니다.
Azure Boards 앱을 제거하려면 유인스톨을 선택한 다음 팝업 확인 창에서 OK 선택합니다.
Azure Boards GitHub 연결 업데이트
GitHub Azure Boards 앱에서 지원하는 리포지토리를 변경하면 Azure Boards GitHub 연결로 리디렉션될 수 있습니다. 더 이상 GitHub 연결할 수 없는 Azure Boards 리포지토리를 제거하는 것이 좋습니다. 자세한 내용은 GitHub 리포지토리 추가 또는 제거 참조하세요.
GitHub Azure Boards 앱을 제거하면 다음 메시지가 Azure Boards 프로젝트 설정>GitHub 연결에 표시됩니다. 연결 제거을 선택하여 기존에 설정된 모든 GitHub 연결을 제거합니다. 자세한 내용은 GitHub 리포지토리 추가 또는 제거 참조하세요.
