Azure Pipelines를 사용하여 App Configuration에서 스냅샷 만들기

Azure 앱 구성 스냅샷 작업은 Azure 앱 구성에서 스냅샷을 만들도록 설계되었습니다.

필수 조건

• Azure 구독 - 체험 구독 만들기
• App Configuration 저장소 - 무료로 만들기
• Azure DevOps 프로젝트 - 무료로 한 개 만들기
• 자체 호스팅 에이전트에서 작업을 실행하기 위한 Azure Pipelines 에이전트 버전 2.144.0 이상 및 노드 버전 16 이상.

서비스 연결 만들기

서비스 연결을 통해 Azure DevOps 프로젝트에서 Azure 구독의 리소스에 액세스할 수 있습니다.

1. Azure DevOps에서 대상 파이프라인이 포함된 프로젝트로 이동합니다. 왼쪽 하단에서 프로젝트 설정을 선택합니다.

2. 파이프라인 아래에서 서비스 연결을 선택합니다. 오른쪽 상단에서 새 서비스 연결을 선택합니다.

3. 새 서비스 연결에서 Azure Resource Manager를 선택합니다.

   

4. 인증 방법 대화 상자에서 워크로드 ID 페더레이션(자동)을 선택하여 새 워크로드 ID 페더레이션을 만들거나 워크로드 ID 페더레이션(수동)을 선택하여 기존 워크로드 ID 페더레이션을 사용합니다.

5. 구독, 리소스 그룹 및 서비스 연결 이름을 입력합니다.

새 서비스 주체를 만든 경우 서비스 연결에 할당된 서비스 주체의 이름을 찾습니다. 다음 단계에서 이 서비스 주체에 새 역할 할당을 추가합니다.

1. 프로젝트 설정>서비스 연결로 이동합니다.

2. 새 서비스 연결을 선택합니다.

3. 서비스 주체 관리를 선택합니다.

4. 표시 이름의 값을 확인합니다.

   

역할 할당 추가

태스크가 App Configuration 저장소에 액세스할 수 있도록 작업 내에서 사용되는 자격 증명에 적절한 App Configuration 역할 할당을 할당합니다.

1. 대상 App Configuration 저장소로 이동합니다.

2. 왼쪽 메뉴에서 액세스 제어(IAM)를 선택합니다.

3. 오른쪽 창에서 역할 할당 추가를 선택합니다.

   

4. 역할에 대해 앱 구성 데이터 소유자를 선택합니다. 이 역할을 통해 App Configuration 저장소에서 읽고 쓰는 작업을 수행할 수 있습니다.

5. 이전 섹션에서 만든 서비스 연결과 연관된 서비스 주체를 선택합니다.

   

6. 검토 + 할당을 선택합니다.

빌드에 사용

이 섹션에서는 Azure DevOps 빌드 파이프라인에서 Azure 앱 구성 스냅샷 작업을 사용하는 방법을 알아봅니다.

1. 파이프라인>파이프라인을 클릭하여 빌드 파이프라인 페이지로 이동합니다. 빌드 파이프라인에 대한 자세한 내용은 첫 번째 파이프라인 만들기를 참조하세요.
   • 새 빌드 파이프라인을 만드는 경우 프로세스 마지막 단계의 검토 탭에 있는 파이프라인 오른쪽에서 도우미 표시를 선택합니다.

     

   • 기존 빌드 파이프라인을 사용하는 경우 오른쪽 위에서 편집 단추를 클릭합니다.

     

2. Azure 앱 구성 스냅샷 작업을 검색합니다.

   

3. App Configuration 저장소에서 스냅샷을 만드는 작업에 필요한 매개 변수를 구성합니다. 매개 변수에 대한 설명은 아래의 매개 변수 섹션과 각 매개 변수 옆의 도구 설명에서 사용할 수 있습니다.

   

4. 빌드를 저장하고 큐에 넣습니다. 빌드 로그는 태스크를 실행하는 동안 발생한 모든 오류를 표시합니다.

릴리스에 사용

이 섹션에서는 Azure DevOps 릴리스 파이프라인에서 Azure 앱 구성 스냅샷 작업을 사용하는 방법을 알아봅니다.

1. 파이프라인 릴리스를 선택하여 릴리스 파이프라인> 페이지로 이동합니다. 릴리스 파이프라인에 대한 자세한 내용은 첫 번째 파이프라인 만들기로 이동하세요.
2. 기존 릴리스 파이프라인을 선택합니다. 기존 릴리스 파이프라인이 없는 경우 + 새로 만들기를 선택하여 새 항목을 만듭니다.
3. 오른쪽 위 모서리에서 편집 단추를 선택하여 릴리스 파이프라인을 편집합니다.
4. 작업 드롭다운에서 작업을 추가할 스테이지를 선택합니다. 스테이지에 대한 자세한 내용은 단계 추가, 종속성 및 조건에서 찾을 수 있습니다.

   

5. 새 작업을 추가할 작업 옆을 클릭합니다 + .

   

6. 작업 추가 대화 상자에서 Azure 앱 구성 스냅샷을 검색 상자에 입력하고 선택합니다.
7. 작업 내에서 필요한 매개 변수를 구성하여 App Configuration 저장소 내에서 스냅샷을 만듭니다. 매개 변수에 대한 설명은 아래 매개 변수 섹션과 각 매개 변수 옆에 있는 도구 설명에 있습니다.
8. 릴리스를 저장하고 큐에 넣습니다. 릴리스 로그는 태스크를 실행하는 동안 발생한 모든 오류를 표시합니다.

매개 변수

다음 매개 변수는 App Configuration 스냅샷 태스크에서 사용됩니다.

• Azure 구독: 사용 가능한 Azure 서비스 연결이 포함된 드롭다운입니다. 사용 가능한 Azure 서비스 연결 목록을 업데이트하고 새로 고치려면 텍스트 상자 오른쪽에서 Azure 구독 새로 고침 단추를 누릅니다.

• 앱 구성 엔드포인트: 선택한 구독에서 사용 가능한 구성 저장소 엔드포인트를 로드하는 드롭다운입니다. 사용 가능한 구성 저장소 엔드포인트 목록을 업데이트하고 새로 고치려면 텍스트 상자 오른쪽에 있는 앱 구성 엔드포인트 새로 고침 단추를 누릅니다.

• 스냅샷 이름: 스냅샷의 이름을 지정합니다.

• 컴퍼지션 형식: 기본값은 Key입니다.

  • 키: 이 컴퍼지션 형식에 대한 순서대로 필터가 적용됩니다. 스냅샷의 각 키 값은 키로만 고유하게 식별됩니다. 동일한 키와 여러 레이블을 가진 여러 키 값이 있는 경우 마지막으로 적용 가능한 필터를 기준으로 하나의 키 값만 유지됩니다.

  • 키 레이블: 필터가 적용되고 결과 스냅샷의 모든 키-값이 키와 레이블로 고유하게 식별됩니다.

• 필터: App Configuration 스냅샷을 빌드하는 데 사용되는 키 및 레이블 필터를 나타냅니다. 필터는 유효한 JSON 형식이어야 합니다. 예 [{"key":"abc*", "label":"1.0.0"}]. 하나 이상의 필터를 지정해야 하며 최대 3개의 필터를 지정할 수 있습니다.

• 보존 기간: 기본값은 30일입니다. 스냅샷이 보관된 후 보존되는 일 수를 나타냅니다. 보관된 스냅샷은 보존 기간 동안 복구할 수 있습니다.

• 태그: 형식의 {"tag1":"val1", "tag2":"val2"}JSON 개체로, App Configuration 저장소에서 만든 각 스냅샷에 추가되는 태그를 정의합니다.

문제 해결

예기치 않은 오류가 발생하면 파이프라인 변수 system.debug를 true로 설정하여 디버그 로그를 사용하도록 설정할 수 있습니다.

다음 단계

매개 변수에 대한 전체 참조 또는 YAML 파이프라인에서 이 파이프라인 작업을 사용하려면 다음 문서를 참조하세요.

App Configuration 저장소에서 키-값을 내보내고 Azure 파이프라인 변수로 설정하는 방법을 알아보려면 다음 문서를 계속 진행합니다.

구성 파일에서 App Configuration 저장소로 키-값을 가져오는 방법을 알아보려면 다음 문서를 계속 진행합니다.