GitHub 또는 Azure Repos에서 카탈로그 추가 및 구성

카탈로그를 추가하려면 다음 작업을 완료합니다.

• 관리 ID에 대해 Azure Repos에서 권한을 할당합니다.
• 리포지토리를 카탈로그로 추가합니다.

관리 ID에 대해 Azure Repos에서 권한 할당

Azure Repos의 리포지토리에 관리 ID 권한을 부여해야 합니다.

1. Azure DevOps 조직에 로그인합니다.

   참고 항목

   Azure DevOps 조직은 개발자 센터 또는 프로젝트가 포함된 Azure 구독과 동일한 디렉터리에 있어야 합니다.

2. 조직 설정을 선택합니다.

   

3. 개요 페이지에서 사용자를 선택합니다.

   

4. 사용자 페이지에서 사용자 추가를 선택합니다.

   

5. 다음 정보를 입력하거나 선택하여 새 사용자 추가를 완료한 다음, 추가를 선택합니다.

   속성	값
   사용자 또는 서비스 주체	개발자 센터 또는 프로젝트의 이름을 입력합니다. 시스템 할당 MSI를 사용하는 경우 관리되는 계정의 개체 ID가 아닌 개발자 센터 또는 프로젝트의 이름을 지정합니다. 사용자 할당 MSI를 사용하는 경우 관리되는 계정의 이름을 사용합니다.
   액세스 수준	기본을 선택합니다.
   프로젝트에 추가	리포지토리가 포함된 프로젝트를 선택합니다.
   Azure DevOps 그룹	프로젝트 Readers를 선택합니다.
   이메일 초대 보내기(사용자에게만)	확인란의 선택을 취소합니다.

   

리포지토리를 카탈로그로 추가

Azure Deployment Environments는 Azure Repos 리포지토리 및 GitHub 리포지토리 연결을 지원합니다. 큐레이팅된 IaC 템플릿 세트를 리포지토리에 저장할 수 있습니다. 리포지토리를 개발자 센터 또는 프로젝트에 카탈로그로 연결하면 개발 팀이 템플릿에 액세스할 수 있으며 일관된 환경을 빠르게 만들 수 있습니다.

다음 단계를 통해 Azure Repos 리포지토리를 연결할 수 있습니다.

1. Azure Portal에서 개발자 센터 또는 프로젝트로 이동합니다.

2. 환경 구성 아래 왼쪽 메뉴에서 카탈로그를 선택한 다음 추가를 선택합니다.

   

3. 카탈로그 추가에서 다음 정보를 입력한 다음 추가를 선택합니다.

   필드	값
   이름	카탈로그 이름을 입력합니다.
   카탈로그 위치	Azure DevOps를 선택합니다.
   인증 유형	관리 ID를 선택합니다.
   조직	Azure DevOps 조직을 선택합니다.
   프로젝트	프로젝트 목록에서 리포지토리를 저장하는 프로젝트를 선택합니다.
   리포지토리	리포지토리 목록에서 추가할 리포지토리를 선택합니다.
   Branch	분기를 선택합니다.
   폴더 경로	Dev Box는 분기의 폴더 목록을 검색합니다. IaC 템플릿을 저장하는 폴더를 선택합니다.

   

4. 개발자 센터 또는 프로젝트의 카탈로그에서 카탈로그가 표시되는지 확인합니다. 연결이 성공하면 상태가 동기화 성공으로 표시됩니다. 카탈로그에 처음 연결하는 데 몇 분 정도 걸릴 수 있습니다.

카탈로그를 추가하려면 다음 작업을 완료합니다.

• Azure Repos 리포지토리의 복제 URL을 가져옵니다.
• PAT(개인용 액세스 토큰)를 만듭니다.
• PAT를 Azure Key Vault에 키 자격 증명 모음 비밀로 저장합니다.
• 리포지토리를 카탈로그로 추가합니다.

Azure Repos 리포지토리의 복제 URL 가져오기

1. 팀 컬렉션의 홈페이지(예: https://contoso-web-team.visualstudio.com)로 이동한 다음 프로젝트를 선택합니다.

2. Azure Repos Git 리포지토리의 복제 URL을 가져옵니다.

3. URL을 복사하고 저장합니다.

Azure Repos에서 개인용 액세스 토큰 만들기

1. 팀 컬렉션의 홈페이지(예: https://contoso-web-team.visualstudio.com)로 이동하여 프로젝트를 선택합니다.

2. PAT를 만듭니다.

3. 나중에 사용할 수 있도록 생성된 토큰을 복사하고 저장합니다.

주요 자격 증명 모음 만들기

리포지토리에 대한 Azure 액세스 권한을 부여하는 데 사용되는 PAT를 저장하려면 Azure Key Vault가 필요합니다. 키 자격 증명 모음은 액세스 정책 또는 RBAC(역할 기반 액세스 제어)를 사용하여 액세스를 제어할 수 있습니다. 기존 키 자격 증명 모음이 있는 경우 사용할 수 있지만 액세스 정책 또는 RBAC 할당을 사용하여 액세스를 제어하는지 확인해야 합니다. 키 자격 증명 모음에 대한 액세스 정책 구성에 대한 도움말은 Key Vault 액세스 정책 할당을 참조하세요.

다음 단계를 수행하여 RBAC 키 자격 증명 모음을 만듭니다.

1. Azure Portal에 로그인합니다.

2. 검색 상자에 Key Vault를 입력합니다.

3. 결과 목록에서 Key Vault를 선택합니다.

4. Key Vault 페이지에서 만들기를 선택합니다.

5. 키 자격 증명 모음 만들기 탭에서 다음 정보를 제공합니다.

   속성	값
   이름	키 자격 증명 모음의 이름을 입력합니다.
   구독	키 자격 증명 모음을 만들려는 구독을 선택합니다.
   리소스 그룹	기존 리소스 그룹을 사용하거나 새로 만들기를 선택하고 리소스 그룹에 사용할 이름을 입력합니다.
   위치	키 자격 증명 모음을 만들려는 위치 또는 지역을 선택합니다.

   다른 옵션은 기본값으로 그대로 둡니다.

6. 액세스 정책 탭에서 Azure 역할 기반 액세스 제어를 선택한 다음, 검토 + 만들기를 선택합니다.

7. 검토 + 만들기 탭에서 만들기를 선택합니다.

조직의 정책에 따라 Key Vault를 인터넷에서 비공개로 유지해야 하는 경우 신뢰할 수 있는 Microsoft 서비스가 방화벽 규칙을 무시할 수 있도록 Key Vault를 설정할 수 있습니다.

신뢰할 수 있는 Microsoft 서비스가 방화벽을 우회하도록 허용하는 방법을 알아보려면 Azure Key Vault 네트워킹 설정 구성을 참조하세요.

키 자격 증명 모음에 개인용 액세스 토큰 저장

1. Key Vault의 왼쪽 메뉴에서 비밀을 선택합니다.

2. 비밀 페이지에서 생성/가져오기를 선택합니다.

3. 비밀 만들기 페이지에서 다음을 수행합니다.

   • 이름 상자에 비밀을 설명하는 이름을 입력합니다.
   • 비밀 값 상자에 이전에 복사한 PAT를 붙여넣습니다.
   • 만들기를 실행합니다.

비밀 식별자 가져오기

키 자격 증명 모음에서 만든 비밀의 경로를 가져옵니다.

1. Azure Portal에서 키 자격 증명 모음으로 이동합니다.

2. 키 자격 증명 모음의 왼쪽 메뉴에서 비밀을 선택합니다.

3. 비밀 페이지에서 이전에 만든 비밀을 선택합니다.

4. 버전 페이지에서 현재 버전을 선택합니다.

5. 현재 버전 페이지의 비밀 식별자에서 복사를 선택합니다.

리포지토리를 카탈로그로 추가

1. Azure Portal에서 개발자 센터 또는 프로젝트로 이동합니다.

2. 개발자 센터 또는 프로젝트에 연결된 ID가 개인용 액세스 토큰이 저장된 키 자격 증명 모음 비밀에 액세스할 수 있는지 확인합니다.

3. 환경 구성 아래 왼쪽 메뉴에서 카탈로그를 선택한 다음 추가를 선택합니다.

4. 카탈로그 추가에서 다음 정보를 입력한 다음 추가를 선택합니다.

   필드	값
   이름	카탈로그 이름을 입력합니다.
   카탈로그 위치	Azure DevOps를 선택합니다.
   인증 유형	개인용 액세스 토큰을 선택합니다.
   조직	카탈로그 리포지토리를 호스트하는 조직을 선택합니다.
   프로젝트	카탈로그 리포지토리를 저장하는 프로젝트를 선택합니다.
   Rep	카탈로그를 저장하는 리포지토리를 선택합니다.
   폴더 경로	IaC 템플릿을 포함하는 폴더를 선택합니다.
   비밀 식별자	리포지토리에 대한 PAT가 포함된 비밀 식별자를 입력합니다. 비밀 식별자를 복사하면 연결 문자열 끝에 다음 예와 같이 버전 식별자가 포함됩니다. https://contoso-kv.vault.azure.net/secrets/GitHub-repo-pat/9376b432b72441a1b9e795695708ea5a. 버전 식별자를 제거하면 배포 환경이 키 자격 증명 모음에서 최신 버전의 비밀을 가져옵니다. PAT가 만료되면 키 자격 증명 모음만 업데이트해야 합니다. 비밀 식별자 예: https://contoso-kv.vault.azure.net/secrets/GitHub-repo-pat

   

5. 카탈로그에서 카탈로그가 표시되는지 확인합니다. 연결에 성공하면 상태는 연결됨입니다.

카탈로그를 추가하려면 다음 작업을 완료합니다.

1. Microsoft 개발자 센터 앱 설치 및 구성
2. 리포지토리에 대해 GitHub에서 권한을 할당합니다.
3. 리포지토리를 카탈로그로 추가합니다.

Microsoft 개발자 센터 앱 설치

1. Azure Portal에 로그인합니다.

2. 개발자 센터 또는 프로젝트로 이동합니다.

3. 환경 구성 아래 왼쪽 메뉴에서 카탈로그를 선택한 다음 추가를 선택합니다.

4. 카탈로그 추가 창에서 다음을 입력하거나 선택합니다.

   필드	값
   이름	카탈로그 이름을 입력합니다.
   카탈로그 원본	GitHub를 선택합니다.
   인증 유형	GitHub 앱을 선택합니다.

5. Microsoft 개발자 센터 앱을 설치하려면 리포지토리 구성을 선택합니다.

   

6. GitHub에 인증하라는 메시지가 표시되면 인증합니다.

7. Microsoft DevCenter 페이지에서 구성을 선택합니다.

   

8. 카탈로그로 추가하려는 리포지토리가 포함된 GitHub 조직을 선택합니다. 이 앱을 설치하려면 조직의 소유자여야 합니다.

   

9. Microsoft DevCenter 설치 페이지에서 리포지토리만 선택을 선택하고 카탈로그로 추가하려는 리포지토리를 선택한 다음 설치를 선택합니다.

   

   여러 리포지토리를 선택하여 카탈로그로 추가할 수 있습니다. 리포지토리를 카탈로그로 추가에 설명된 대로 각 리포지토리를 별도의 카탈로그로 추가해야 합니다.

10. Microsoft의 Microsoft DevCenter에서 다음에 대한 권한 요청 페이지에서 필요한 권한을 검토한 후 Microsoft 개발자 센터에 권한 부여을 선택합니다.

    

리포지토리를 카탈로그로 추가

1. Azure Portal로 다시 전환합니다.

2. 카탈로그 추가에서 다음 정보를 입력한 다음 추가를 선택합니다.

   필드	값
   리포지토리	카탈로그로 추가하려는 리포지토리를 선택합니다.
   Branch	분기를 선택합니다.
   폴더 경로	환경 정의를 보관하는 하위 폴더가 포함된 폴더를 선택합니다.

   

3. 카탈로그에서 카탈로그가 표시되는지 확인합니다. 연결이 성공하면 상태가 동기화 성공으로 표시됩니다.

   

카탈로그를 추가하려면 다음 작업을 완료합니다.

• GitHub 리포지토리의 복제 URL을 가져옵니다.
• GitHub에서 PAT(개인용 액세스 토큰)를 만듭니다.
• PAT를 Azure Key Vault에 키 자격 증명 모음 비밀로 저장합니다.
• 리포지토리를 카탈로그로 추가합니다.

GitHub 리포지토리의 복제 URL 가져오기

1. 템플릿 정의가 포함된 GitHub 리포지토리의 홈페이지로 이동합니다.

2. GitHub 리포지토리 복제 URL을 가져옵니다.

3. URL을 복사하고 저장합니다.

GitHub에서 개인용 액세스 토큰 만들기

Azure Deployment Environments는 클래식 토큰 또는 세분화된 토큰을 사용하여 GitHub 리포지토리에 대한 인증을 지원합니다. 이 예제에서는 세분화된 토큰을 만듭니다.

1. 템플릿 정의가 포함된 GitHub 리포지토리의 홈페이지로 이동합니다.

2. GitHub의 오른쪽 위에서 프로필 이미지를 선택한 다음 설정을 선택합니다.

3. 왼쪽 사이드바에서 개발자 설정>개인용 액세스 토큰>세분화된 토큰을 선택합니다.

4. Generate new token(새 토큰 생성)을 탭합니다.

5. 새 세분화된 개인용 액세스 토큰 페이지에서 다음 정보를 제공합니다.

   속성	값
   토큰 이름	토큰의 설명이 포함된 이름을 입력합니다.
   만료	토큰 만료 기간(일)을 선택합니다.
   설명	토큰에 대한 설명을 입력합니다.
   리소스 소유자	리포지토리의 소유자를 선택합니다.
   리포지토리 액세스	리포지토리만 선택을 선택합니다.
   리포지토리 선택	환경 정의가 포함된 리포지토리를 선택합니다.
   리포지토리 권한	리포지토리 권한을 확장하고 콘텐츠에 대해 Access 목록에서 코드 읽기를 선택합니다.

   

6. 토큰 생성을 선택합니다.

7. 나중에 사용할 수 있도록 생성된 토큰을 복사하고 저장합니다.

주요 자격 증명 모음 만들기

리포지토리에 Azure 액세스 권한을 부여하는 데 사용되는 PAT를 저장하려면 Azure Key Vault가 필요합니다. 키 자격 증명 모음은 액세스 정책 또는 RBAC(역할 기반 액세스 제어)를 사용하여 액세스를 제어할 수 있습니다. 기존 키 자격 증명 모음이 있는 경우 사용할 수 있지만 액세스 정책 또는 RBAC 할당을 사용하여 액세스를 제어하는지 확인해야 합니다. 키 자격 증명 모음에 대한 액세스 정책 구성에 대한 도움말은 키 자격 증명 모음 액세스 정책 할당을 참조하세요.

다음 단계를 수행하여 RBAC 키 자격 증명 모음을 만듭니다.

1. Azure Portal에 로그인합니다.

2. 검색 상자에 Key Vault를 입력합니다.

3. 결과 목록에서 Key Vault를 선택합니다.

4. Key Vault 페이지에서 만들기를 선택합니다.

5. 키 자격 증명 모음 만들기 탭에서 다음 정보를 제공합니다.

   속성	값
   이름	키 자격 증명 모음의 이름을 입력합니다.
   구독	키 자격 증명 모음을 만들려는 구독을 선택합니다.
   리소스 그룹	기존 리소스 그룹을 사용하거나 새로 만들기를 선택하고 리소스 그룹에 사용할 이름을 입력합니다.
   위치	키 자격 증명 모음을 만들려는 위치 또는 지역을 선택합니다.

   다른 옵션은 기본값으로 그대로 둡니다.

6. 액세스 정책 탭에서 Azure 역할 기반 액세스 제어를 선택한 다음, 검토 + 만들기를 선택합니다.

7. 검토 + 만들기 탭에서 만들기를 선택합니다.

조직의 정책에 따라 Key Vault를 인터넷에서 비공개로 유지해야 하는 경우 신뢰할 수 있는 Microsoft 서비스가 방화벽 규칙을 무시할 수 있도록 Key Vault를 설정할 수 있습니다.

신뢰할 수 있는 Microsoft 서비스가 방화벽을 우회하도록 허용하는 방법을 알아보려면 Azure Key Vault 네트워킹 설정 구성을 참조하세요.

키 자격 증명 모음에 개인용 액세스 토큰 저장

1. Key Vault의 왼쪽 메뉴에서 비밀을 선택합니다.

2. 비밀 페이지에서 생성/가져오기를 선택합니다.

3. 비밀 만들기 페이지에서 다음을 수행합니다.

   • 이름 상자에 비밀을 설명하는 이름을 입력합니다.
   • 비밀 값 상자에 PAT를 붙여넣습니다.
   • 만들기를 실행합니다.

비밀 식별자 가져오기

키 자격 증명 모음에서 만든 비밀의 경로를 가져옵니다.

1. Azure Portal에서 키 자격 증명 모음으로 이동합니다.

2. 키 자격 증명 모음의 왼쪽 메뉴에서 비밀을 선택합니다.

3. 비밀 페이지에서 이전에 만든 비밀을 선택합니다.

4. 버전 페이지에서 현재 버전을 선택합니다.

5. 현재 버전 페이지의 비밀 식별자에서 복사를 선택합니다.

리포지토리를 카탈로그로 추가

1. Azure Portal에서 개발자 센터 또는 프로젝트로 이동합니다.

2. 개발자 센터 또는 프로젝트에 연결된 관리 ID가 개인용 액세스 토큰이 저장된 키 자격 증명 모음 비밀에 액세스할 수 있는지 확인합니다.

3. 환경 구성 아래 왼쪽 메뉴에서 카탈로그를 선택한 다음 추가를 선택합니다.

4. 카탈로그 추가에서 다음 정보를 입력한 다음, 추가를 선택합니다.

   필드	값
   이름	카탈로그 이름을 입력합니다.
   카탈로그 위치	GitHub를 선택합니다.
   리포지토리	GitHub 리포지토리 또는 Azure Repos 리포지토리에 대한 복제 URL을 입력하거나 붙여넣습니다. 샘플 카탈로그 예: https://github.com/Azure/deployment-environments.git
   Branch	연결할 리포지토리 분기를 입력합니다. 샘플 카탈로그 예: main
   폴더 경로	환경 정의를 포함하는 하위 폴더가 포함된 복제 URI와 관련된 폴더 경로를 입력합니다. 폴더 경로는 환경 정의 환경 파일 자체가 있는 폴더가 아니라 환경 정의 환경 파일을 포함하는 하위 폴더가 있는 폴더에 대한 것입니다. 다음 이미지는 샘플 카탈로그 폴더 구조를 보여줍니다. 샘플 카탈로그 예: /Environments 폴더 경로는 슬래시(/)를 사용하거나 사용하지 않고 시작할 수 있습니다.
   비밀 식별자	리포지토리에 대한 PAT가 포함된 비밀 식별자를 입력합니다. 비밀 식별자를 복사하면 연결 문자열 끝에 다음 예와 같이 버전 식별자가 포함됩니다. https://contoso-kv.vault.azure.net/secrets/GitHub-repo-pat/9376b432b72441a1b9e795695708ea5a. 버전 식별자를 제거하면 Deployment Environments가 키 자격 증명 모음에서 최신 버전의 비밀을 가져옵니다. PAT가 만료되면 키 자격 증명 모음만 업데이트해야 합니다. 비밀 식별자 예: https://contoso-kv.vault.azure.net/secrets/GitHub-repo-pat

   

5. 카탈로그에서 카탈로그가 표시되는지 확인합니다. 연결이 성공하면 상태가 동기화 성공으로 표시됩니다.