Microsoft Teams에서 Azure Repos 사용
Azure DevOps Services
Microsoft Teams 및 Azure Repos 사용하는 경우 Teams용 Azure Repos 앱을 사용하여 리포지토리를 모니터링할 수 있습니다. 앱은 Git 및 TFVC(Team Foundation 버전 제어) 리포지토리 모두 모니터링을 지원하지만 GitHub 리포지토리와의 통합은 지원하지 않습니다.
이 문서에서는 다음 작업을 수행하는 방법을 알아봅니다.
- Microsoft Teams에서 팀에 Azure Repos 앱 추가
- 리포지토리에 Azure Repos 앱 연결
- 채널에서 리포지토리 관련 이벤트에 대한 구독 관리
- 작성 확장을 사용하여 PR 정보 검색 및 공유
- PR URL 미리 보기
- 채널에서 구독 및 리포지토리 제거
사전 요구 사항
- 구독을 관리하여 코드가 푸시 또는 체크 인되거나 PR(끌어오기 요청)이 생성, 업데이트 또는 병합될 때마다 채널에서 알림을 받습니다. 리포지토리 관련 이벤트에 대한 구독을 만들려면 프로젝트 관리자 그룹의 구성원이거나 팀 관리자여야 합니다. 추가하려면 프로젝트 수준 권한 변경 또는 팀 관리자 추가를 참조하세요.
- 알림을 받으려면 Azure DevOps organization OAuth 설정을 통해 타사 애플리케이션 액세스를 사용하도록 설정합니다. organization 대한 애플리케이션 액세스 정책 변경을 참조하세요.
참고
- 알림은 현재 직접 메시지 내에서 지원되지 않습니다.
- Microsoft Teams용 Azure Repos 앱을 Azure DevOps Services 호스트되는 프로젝트에만 연결할 수 있습니다.
Microsoft Teams의 팀에 Azure Repos 앱 추가
Microsoft Teams, Microsoft Teams > Azure Repos Azure Repos 앱으로 이동합니다.
추가를 선택하거나 이미 앱을 다운로드한 경우 열기 옆에 있는 드롭다운 메뉴를 선택한 다음 팀에 추가를 선택합니다.
팀 또는 채널 이름을 입력한 다음, 봇 설정을 선택합니다.
리포지토리에 Azure Repos 앱 연결
팀에 앱이 설치되면 회신 필드에 다음 텍스트를 입력합니다.
@azure repos signinMicrosoft Teams 및 Azure Boards 서로 다른 테넌트에서 다른 전자 메일로 로그인을 선택합니다.
프로젝트의 모든 Git 리포지토리를 모니터링하려면 채널을 입력
@azure repos subscribe [project url]합니다. 프로젝트 URL을 추가해야 합니다. 프로젝트 URL은 프로젝트 내의 모든 페이지일 수 있습니다(리포지토리에 대한 URL 제외).를 사용하여 특정 리포지토리를
@azure repos subscribe [repo url]모니터링할 수도 있습니다.리포지토리 URL은 리포지토리 이름이 있는 리포지토리 내의 모든 페이지(예
@azure repos subscribe https://dev.azure.com/myorg/myproject/_git/myrepo: ) 또는 TFVC 리포지@azure repos subscribe https://dev.azure.com/myorg/myproject/_versionControl토리의 경우 일 수 있습니다.명령은
subscribe기본 구독으로 시작합니다. Git 리포지토리의 경우 채널은 끌어오기 요청 생성 이벤트(대상 분기 = 기본 포함)를 구독합니다. TFVC 리포지토리의 경우 채널은 체크 인된 코드 이벤트를 구독합니다.
구독 관리
채널에 대한 구독을 보고, 추가하고, 제거하려면 텍스트를 @azure repos subscriptions입력합니다.
채널에 대한 모든 현재 구독 목록이 표시되고 새 구독을 추가하거나 기존 구독을 제거할 수 있습니다. 다음 섹션에 설명된 대로 다양한 필터를 사용하여 알림을 사용자 지정합니다.
참고
팀 관리자는 프로젝트 관리자가 만든 구독을 제거하거나 수정할 수 없습니다.
필터를 사용하여 원하는 알림만 가져옵니다.
를 사용하여 리포지토리 @azure repos subscribe를 구독하면 필터가 적용되지 않은 기본 구독이 만들어집니다.
사용자는 특정 조건이 충족될 때만 알림을 받도록 이러한 구독을 사용자 지정해야 하는 경우가 많습니다.
다음 스크린샷은 팀이 PR에 대한 검토자 목록에 있는 경우에만 알림을 설정하는 예제를 보여 줍니다.
채널
@azure repos subscriptions에 다음 텍스트를 입력합니다.구독 목록에서 원하지 않거나 수정해야 하는 구독이 있는 경우 제거 를 선택하여 삭제합니다.
구독 추가 단추를 선택합니다.
이벤트 유형을 선택한 다음, 다음을 선택합니다.
리포지토리를 선택한 다음 , 다음을 선택합니다.
적절한 필터를 선택하여 구독을 사용자 지정한 다음 제출을 선택합니다.
참고
- 모든 필터는 일반적으로 드롭다운입니다. 그러나 드롭다운에 100개 이상의 항목이 있는 경우 값을 수동으로 입력해야 합니다.
- TFVC 코드 체크 인 이벤트의 경우 경로 아래 필터는 형식
$/myproject/path이어야 합니다.
작성 확장을 사용하여 끌어오기 요청 정보 검색 및 공유
사용자가 끌어오기 요청에 대한 정보를 검색하고 공유할 수 있도록 Microsoft Teams용 Azure Repos 앱은 작성 확장을 지원합니다. ID 또는 이름으로 끌어오기 요청을 검색할 수 있습니다. 확장이 작동하려면 를 입력 @azure repos signin 하거나 작성 확장에 직접 로그인하여 Azure Repos 프로젝트에 로그인합니다.
끌어오기 요청 URL 미리 보기
PR의 URL을 붙여넣으면 미리 보기는 다음 이미지의 URL과 같이 표시되므로 PR 관련 대화를 상황별 및 정확하게 유지하는 데 도움이 됩니다. 로그인해야 하며 팀의 모든 채널에서 URL에 대한 PR을 미리 볼 수 있습니다.
채널에서 구독 및 리포지토리 제거
프로젝트의 리포지토리와 관련된 모든 구독을 삭제하고 채널에서 리포지토리를 제거하려면 Teams @azure repos unsubscribe all [project url]에 다음 텍스트를 입력합니다. 프로젝트 URL을 입력해야 합니다. 프로젝트 관리자만 이 작업을 수행할 수 있습니다.
스레드 알림
관련 알림 집합을 연결하고 채널의 알림이 차지하는 공간을 줄이기 위해 알림이 스레드됩니다. 특정 끌어오기 요청에 연결된 모든 알림은 함께 연결됩니다.
스레드 알림의 압축 보기 스레드 알림
스레드 알림의 확장된 보기 스레드 알림
명령 참조
다음 표에는 Teams 채널에서 사용할 수 있는 모든 azure repos 명령이 나와 있습니다.
| 명령 | 기능 |
|---|---|
@azure repos subscribe [repo url/ project url] |
리포지토리 또는 프로젝트의 모든 리포지토리를 구독하여 알림을 받습니다. |
@azure repos subscriptions |
이 채널에 대한 구독 추가 또는 제거 |
@azure repos signin |
Azure Repos organization 로그인 |
@azure repos signout |
Azure Repos organization 로그아웃 |
@azure repos feedback |
문제 보고 또는 기능 제안 |
@azure repos unsubscribe all [project url] |
채널에서 모든 리포지토리(프로젝트에 속) 및 연결된 구독 제거 |
다중 테넌트 지원
Microsoft Teams 및 Azure DevOps에 다른 전자 메일 또는 테넌트 를 사용하는 경우 사용 사례에 따라 다음 단계에 따라 로그인합니다.
| 사용 사례 | Email ID + Microsoft Teams 테넌트 | Email ID + Azure DevOps 테넌트 | 단계 |
|---|---|---|---|
| 1 | email1@abc.com (테넌트 1) | email1@abc.com (테넌트 1) | 로그인을 선택합니다. |
| 2 | email1@abc.com (테넌트 1) | email1@abc.com (테넌트 2) | Azure DevOps에 로그인합니다. 동일한 브라우저에서 새 탭을 시작하고 로 https://teams.microsoft.com/이동합니다. 로그인 명령을 실행하고 로그인을 선택합니다. |
| 3 | email1@abc.com (테넌트 1) | email2@pqr.com (테넌트 2) | 다른 전자 메일 주소로 로그인을 선택한 다음 이메일 ID 선택기에서 email2를 사용하여 Azure DevOps에 로그인합니다. |
| 4 | email1@abc.com (테넌트 1) | email2@pqr.com (기본값이 아닌 테넌트 3) | 이 시나리오는 지원되지 않습니다. |
문제 해결
Azure Repos 앱을 사용할 때 다음과 같은 오류가 발생하는 경우 이 섹션의 절차를 따릅니다.
죄송합니다. 오류가 발생했습니다. 다시 시도하세요.
Azure Repos 앱은 OAuth 인증 프로토콜을 사용하며, organization 사용하도록 설정하려면 OAuth를 통한 타사 애플리케이션 액세스가 필요합니다. 이 설정을 사용하려면 조직 설정>보안>정책으로 이동하고 OAuth를 통해 타사 애플리케이션 액세스를 설정하여 organization 설정을 켜기로 설정합니다.
구성하지 못했습니다. organization '{organization name}'이 있고 충분한 권한이 있는지 확인하세요.
브라우저를 사용하여 Azure DevOps https://aka.ms/VsSignout 에서 로그아웃합니다.
In private 또는 incognito 브라우저 창을 열고 로 이동하여 https://aex.dev.azure.com/me 로그인합니다. 왼쪽 프로필 아이콘 아래의 드롭다운에서 구독하려는 리포지토리가 포함된 organization 포함하는 디렉터리를 선택합니다.
동일한 브라우저에서 새 탭을 시작하고 에 로그인합니다https://teams.microsoft.com/. 명령을 실행한 @Azure Repos signout 다음 Microsoft Teams용 @Azure Repos signin Azure Repos 앱이 설치된 채널에서 명령을 실행합니다.
Sign in 단추를 선택하면 다음 예제와 같은 동의 페이지로 리디렉션됩니다. 전자 메일 옆에 표시된 디렉터리가 이전 단계에서 선택한 디렉터리와 동일한지 확인합니다. 로그인 프로세스를 수락하고 완료합니다.
이러한 단계가 인증 문제를 resolve 않는 경우 Developer Community 문의하세요.