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

이 문서에서는 Azure Deployment Environments 개발자 센터 또는 프로젝트에서 카탈로그를 추가하고 구성하는 방법을 설명합니다.

카탈로그를 사용하면 개발 팀이 환경을 만들 수 있도록 환경 정의라고도 하는 큐레이팅된 IaC(Infrastructure-as-Code) 템플릿 세트를 제공할 수 있습니다. GitHub 또는 Azure DevOps에서 사용자 고유의 소스 제어 리포지토리를 카탈로그로 연결하고 환경 정의가 있는 폴더를 지정할 수 있습니다. 배포 환경은 폴더에서 환경 정의를 검색하고 개발 팀이 환경을 만들 수 있도록 합니다.

템플릿의 보안을 강화하기 위해 카탈로그가 암호화됩니다. Azure Deployment Environments는 Microsoft for Azure Services가 관리하는 플랫폼 관리형 암호화 키를 사용하여 미사용 데이터 암호화를 지원합니다.

• GitHub에서 리포지토리를 호스팅하는 방법을 알아보려면 GitHub 시작을 참조하세요.
• Azure Repos 프로젝트에서 Git 리포지토리를 호스팅하는 방법을 알아보려면 Azure Repos를 참조하세요.

Microsoft는 개발자 센터에 추가할 수 있는 빠른 시작 카탈로그와 리포지토리로 사용할 수 있는 샘플 카탈로그를 제공합니다. 또한 고유의 프라이빗 리포지토리를 사용하거나 샘플 카탈로그에서 환경 정의를 포크하고 사용자 지정할 수 있습니다.

이 문서에서는 다음 방법을 설명합니다.

1. 프로젝트 수준 카탈로그 구성
2. 관리 ID 구성
3. Azure Repos 또는 GitHub에서 카탈로그 추가
4. 카탈로그 업데이트
5. 카탈로그 삭제
6. 카탈로그 동기화 오류 해결

프로젝트 수준 카탈로그 구성

프로젝트 수준에서 카탈로그를 연결하면 플랫폼 엔지니어가 개발 팀과 관련된 큐레이팅된 환경 정의를 제공할 수 있습니다. 또한 프로젝트 관리자로 할당된 개발 팀 리더가 팀에서 사용할 수 있는 환경 정의를 관리할 수 있습니다.

플랫폼 엔지니어는 프로젝트 수준에서 카탈로그 사용을 완전히 제어할 수 있습니다. 프로젝트에 카탈로그를 추가하려면 먼저 개발자 센터 수준에서 프로젝트 수준 카탈로그를 사용하도록 설정해야 합니다. 플랫폼 엔지니어는 프로젝트 수준에서 사용할 수 있는 카탈로그 항목 유형(예: 환경 정의)을 구성할 수도 있습니다.

기본적으로 프로젝트 수준에서는 카탈로그가 사용하지 않도록 설정되며 카탈로그 항목 형식도 사용하도록 설정되지 않습니다. 프로젝트 수준 카탈로그의 환경 정의는 해당 개발자 센터 수준에서 두 프로젝트 기반 카탈로그가 활성화되고 프로젝트에 대해 환경 정의가 사용하도록 설정된 경우에만 동기화되고 사용할 수 있습니다.

관리 ID 구성

개발자 센터를 만든 후 카탈로그를 연결하기 전에 개발자 센터에 대한 MSI(관리되는 서비스 ID)라고도 하는 관리 ID를 구성해야 합니다. 시스템 할당 관리 ID(시스템 할당 MSI) 또는 사용자 할당 관리 ID(사용자 할당 MSI)를 연결할 수 있습니다. 그런 다음, 관리 ID에 역할을 할당하여 개발자 센터 또는 프로젝트에서 구독에 환경 유형을 만들고 카탈로그 리포지토리가 포함된 Azure Repos 프로젝트를 읽을 수 있도록 합니다.

개발자 센터 또는 프로젝트에 MSI가 연결되어 있지 않은 경우 관리 ID 구성의 단계에 따라 관리 ID를 만들고 관리 ID에 대한 역할을 할당합니다.

관리 ID에 대한 자세한 내용은 Azure 리소스에 대한 관리 ID란?을 참조하세요.

카탈로그 추가

Azure Repos 리포지토리 또는 GitHub 리포지토리에서 카탈로그를 추가할 수 있습니다. MSI에 권한을 할당하거나 키 자격 증명 모음에 저장하는 PAT를 사용하여 인증하도록 선택할 수 있습니다.

사용하려는 리포지토리 및 인증 유형에 대한 탭을 선택합니다.

MSI를 사용한 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. 개발자 센터 또는 프로젝트의 카탈로그에서 카탈로그가 표시되는지 확인합니다. 연결이 성공하면 상태가 동기화 성공으로 표시됩니다. 카탈로그에 처음 연결하는 데 몇 분 정도 걸릴 수 있습니다.

PAT가 포함된 Azure Repos 리포지토리

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

• 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. 카탈로그에서 카탈로그가 표시되는지 확인합니다. 연결에 성공하면 상태는 연결됨입니다.

GitHub 리포지토리 DevCenter 앱

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

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. 카탈로그에서 카탈로그가 표시되는지 확인합니다. 연결이 성공하면 상태가 동기화 성공으로 표시됩니다.

   

PAT를 사용한 GitHub 리포지토리

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

• 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. 나중에 사용할 수 있도록 생성된 토큰을 복사하고 저장합니다.

Important

GitHub 조직 내에 저장된 프라이빗 리포지토리를 사용하는 경우 GitHub PAT가 올바른 조직 및 해당 조직 내의 리포지토리에 대한 액세스 권한을 부여하도록 구성되어 있는지 확인해야 합니다.

• 조직 내의 클래식 토큰은 생성된 후 특정 조직에 SSO 권한이 부여되어야 합니다.
• 세분화된 토큰에는 조직 자체에 권한을 부여할 토큰 집합의 소유자가 있어야 합니다.

잘못 구성된 PAT로 인해 리포지토리를 찾을 수 없음 오류가 발생할 수 있습니다.

주요 자격 증명 모음 만들기

리포지토리에 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. 카탈로그에서 카탈로그가 표시되는지 확인합니다. 연결이 성공하면 상태가 동기화 성공으로 표시됩니다.

동기화된 카탈로그 항목 보기

사용하는 리포지토리 유형에 관계없이 카탈로그에서 동기화된 카탈로그 항목을 볼 수 있습니다.

1. 개발자 센터 또는 프로젝트 왼쪽 메뉴의 환경 구성에서 카탈로그를 선택합니다.

2. 카탈로그 창에서 카탈로그 이름을 선택합니다.

   

3. 성공적으로 동기화된 카탈로그 항목 목록이 표시됩니다.

   

카탈로그 업데이트

연결된 리포지토리에서 정의 또는 템플릿 콘텐츠를 업데이트하는 경우 카탈로그를 동기화하여 개발 팀에 최신 환경 정의 세트를 제공할 수 있습니다. 카탈로그를 수동으로 또는 자동으로 동기화할 수 있습니다.

카탈로그 수동 동기화

카탈로그를 수동으로 동기화하는 경우 Deployment Environments는 리포지토리를 검색하고 개발자 센터의 모든 관련 프로젝트에서 최신 환경 정의 목록을 사용할 수 있도록 합니다.

1. 개발자 센터 왼쪽 메뉴의 환경 구성에서 카탈로그를 선택합니다.

2. 특정 카탈로그를 선택한 다음, 명령 모음에서 동기화를 선택합니다.

   

카탈로그 자동 동기화

카탈로그를 자동으로 동기화하도록 구성하는 경우 Deployment Environments는 30분 간격으로 리포지토리를 검색하고 개발자 센터의 모든 관련 프로젝트에서 최신 환경 정의 목록을 사용할 수 있도록 합니다.

1. 개발자 센터 또는 프로젝트 왼쪽 메뉴의 환경 구성에서 카탈로그를 선택합니다.

2. 특정 카탈로그를 선택한 다음, 편집을 선택합니다.

   

3. 카탈로그 편집 창에서 이 카탈로그 자동 동기화를 선택한 다음, 저장을 선택합니다.

   

카탈로그 삭제

카탈로그를 삭제하여 Azure Deployment Environments 개발자 센터 또는 프로젝트에서 제거할 수 있습니다. 삭제된 카탈로그의 템플릿은 개발 팀이 새 환경을 배포할 때 사용할 수 없습니다. 삭제된 카탈로그의 환경 정의를 사용하여 만든 기존 환경에 대한 환경 정의 참조를 업데이트합니다. 참조가 업데이트되지 않고 환경이 재배포되면 배포가 실패합니다.

카탈로그를 삭제하려면 다음을 수행합니다.

1. 개발자 센터 또는 프로젝트 왼쪽 메뉴의 환경 구성에서 카탈로그를 선택합니다.

2. 특정 카탈로그를 선택한 다음 삭제를 선택합니다.

3. 카탈로그 삭제 대화 상자에서 계속을 선택하여 카탈로그를 삭제합니다.

카탈로그 동기화 오류 해결

카탈로그를 추가하거나 동기화할 때 동기화 오류 또는 경고가 발생할 수 있습니다. 동기화 오류는 카탈로그가 성공적으로 동기화되지 못했음을 나타냅니다. 동기화 경고는 카탈로그 항목의 일부 또는 전체에 오류가 있음을 나타냅니다. Azure Portal에서 동기화 상태 및 오류를 보거나 Azure CLI 및 REST API를 사용하여 오류를 처리하고 해결할 수 있습니다.

카탈로그 동기화 상태 보기

Azure Portal에서 상태 링크를 선택하여 카탈로그 동기화 상태 및 경고 또는 오류에 대한 자세한 정보를 얻을 수 있습니다. 상태 링크는 동기화 상태, 추가된 환경 정의 수 및 무시되거나 실패한 환경 정의 수를 보여 주는 창을 엽니다.

카탈로그 동기화 실패 보기

1. 개발자 센터 또는 프로젝트 왼쪽 메뉴의 환경 구성에서 카탈로그를 선택합니다.

2. 상태 열에서 동기화에 실패한 카탈로그의 상태 링크를 선택합니다.

   

3. 마지막 동기화의 변경 내용, 동기화 오류 수 및 오류 유형을 보여 주는 세부 정보 창이 표시됩니다.

   

카탈로그 동기화 경고 보기

1. 개발자 센터 또는 프로젝트 왼쪽 메뉴의 환경 구성에서 카탈로그를 선택합니다.

2. 상태 열에서 동기화되었지만 경고를 보고하는 카탈로그의 상태 링크를 선택합니다.

   

3. 마지막 동기화의 변경 내용, 항목 오류 수 및 각 오류의 유형 및 원본을 보여 주는 세부 정보 창이 표시됩니다.

   

4. 동기화 오류도 보고하는 카탈로그에서 성공적으로 동기화된 항목을 볼 수 있습니다. 카탈로그 창에서 카탈로그 이름을 선택합니다.

   

5. 성공적으로 동기화된 카탈로그 항목 목록이 표시됩니다.

   

Azure CLI를 사용하여 카탈로그 동기화 오류 문제 해결

Azure CLI 또는 REST API를 사용하여 카탈로그를 가져옵니다. GET 응답은 다음과 같은 오류 형식을 보여 줍니다.

• 중복된 것으로 검색된 환경 정의를 무시했습니다.
• 스키마, 참조 또는 유효성 검사 오류로 인해 실패한 잘못된 환경 정의입니다.

무시된 환경 정의 오류 해결

이름이 같은 두 개 이상의 환경 정의를 추가하면 무시된 환경 정의 오류가 발생합니다. 각 환경 정의가 카탈로그 내에서 고유한 이름을 가지도록 환경 정의의 이름을 변경하여 이 문제를 해결할 수 있습니다.

잘못된 환경 정의 오류 해결

다음과 같은 다양한 이유로 잘못된 환경 정의 오류가 발생할 수 있습니다.

• 매니페스트 스키마 오류. 환경 정의 환경 파일이 필요한 스키마와 일치하는지 확인합니다.

• 확인 오류. 유효성 검사 오류를 해결하려면 다음 항목의 유효성을 검사합니다.

  • 환경 파일의 엔진 형식이 올바르게 구성되었는지 확인합니다.
  • 환경 정의 이름이 3자에서 63자 사이여야 합니다.
  • 환경 정의 이름에 URL에 유효한 문자(영숫자 문자 및 ~!,.';:=-_+()*&$@ 기호)만 포함되어 있는지 확인합니다.

• 참조 오류. 환경 파일에서 참조하는 템플릿 경로가 리포지토리의 파일에 대한 유효한 상대 경로인지 확인합니다.

관련 콘텐츠

• 개발자 센터에 대한 환경 형식 구성
• Azure CLI를 사용하여 프로젝트 만들기 및 구성
• 프로젝트 환경 유형 구성