Azure 개발자 CLI(azd
)는 명령을 사용하여 CI/CD 설정을 간소화합니다 azd pipeline config
. 이 명령은 템플릿에 포함된 파이프라인 정의 파일을 사용하여 Azure에서 azd
앱 리소스에 대한 프로비저닝 및 배포 파이프라인을 자동화합니다. 템플릿과 파이프라인 azd
을 통합하면 원활한 CI/CD 환경을 구현할 수 있으므로 일관성 있고 안정적인 배포를 보장하면서 개발에 집중할 수 있습니다.
파이프라인 기능
azd pipeline config
명령을 실행할 때, azd
는 CI/CD 파이프라인을 설정하기 위해 다음 단계를 수행합니다.
- Azure를 사용하여 인증: 로그인하고 필요한 권한이 있는지 확인합니다.
- CI/CD 플랫폼 선택: GitHub Actions 또는 Azure Pipelines 중에서 선택하라는 메시지가 표시됩니다.
- 리포지토리 구성: 리포지토리에 연결하거나 리포지토리를 만드는 방법을 안내합니다.
- 서비스 주체 설정: 보안 배포를 위해 서비스 주체를 자동으로 만들고 구성합니다.
-
인증 구성:
- GitHub의 경우: OIDC(OpenID Connect) 또는 클라이언트 자격 증명을 설정합니다.
- Azure Pipelines의 경우: 클라이언트 자격 증명을 설정하고 PAT(개인 액세스 토큰)를 요청합니다.
-
파이프라인 파일 설정: 템플릿에서 리포지토리로 적합한 파이프라인 정의 파일(
azure-dev.yml
)을 복사합니다. - 파이프라인 변수 및 비밀 설정: 배포에 필요한 변수 및 비밀을 구성합니다.
- 변경 내용 커밋 및 푸시: 파이프라인 구성을 커밋하고 리포지토리에 푸시합니다.
- 파이프라인 실행 시작: Azure 리소스를 생성하거나 업데이트하고 앱을 배포합니다.
플랫폼별 세부 정보
이 azd pipeline config
명령은 각각 고유한 고려 사항이 있는 GitHub Actions와 Azure Pipelines를 모두 지원합니다.
GitHub Actions:
- GitHub에서 호스트되는 리포지토리에서 작동합니다.
-
.github/workflows
구성 파일에 대한azure-dev.yml
디렉터리를 사용합니다. - 기본적으로 보안 인증을 위해 OIDC(OpenID Connect)를 지원합니다.
- 클라이언트 자격 증명을 대체 인증 방법으로 사용할 수 있습니다.
Azure Pipelines :
- Azure Pipelines에서 호스트되는 리포지토리에서 작동합니다.
-
.azuredevops/pipelines
또는.azdo/pipelines
디렉터리를azure-dev.yml
구성 파일에 사용합니다. - 인증에 클라이언트 자격 증명을 사용합니다(OIDC는 현재 지원되지 않음).
- 특정 범위의 PAT(개인용 액세스 토큰)가 필요합니다.
- 끌어오기 요청 워크플로를 사용하여 메인 브랜치 보호를 지원합니다.
템플릿 통합
Azure 개발자 CLI 템플릿에는 명령과 호환되는 미리 구성된 CI/CD 파이프라인 정의 파일(azure-dev.yml
)이 azd pipeline config
포함될 수 있습니다. 템플릿을 복제할 때 구성 파일을 처음부터 만들지 않고 즉시 실행 azd pipeline config
하여 CI/CD 파이프라인을 설정할 수 있습니다.
템플릿에는 파일을 통해 더 많은 변수, 비밀 및 환경별 설정이 있는 사용자 지정된 파이프라인 구성이 azure.yaml
포함될 수 있으므로 파이프라인을 다양한 프로젝트 요구 사항에 쉽게 적응할 수 있습니다.
샘플 워크플로
일반적인 사용 azd pipeline config
워크플로에는 다음이 포함됩니다.
- 원하는
azd
템플릿 리포지토리를 로컬 컴퓨터에 복제합니다. -
azd pipeline config
명령을 실행하고 프롬프트에 따라 파이프라인을 설정합니다. 첫 번째 실행은 필요한 Azure 리소스를 프로비전하고 앱을 배포하는 워크플로를 트리거합니다. - 파이프라인을 만든 후 리포지토리에 변경 내용을 커밋하고 푸시하여 배포 파이프라인을 트리거하고 앱을 업데이트합니다.
- CI/CD 플랫폼에서 파이프라인 실행을 모니터링하여 성공적인 배포를 보장하거나 문제를 해결합니다.
각 플랫폼에 대한 자세한 워크플로를 살펴봅니다.
고유한 파이프라인 정의 파일을 만들거나 고급 구성을 탐색하는 방법을 알아봅니다.