이 문서에서는 Azure CLI를 사용하여 기존 Azure 배포 환경 프로젝트에서 환경을 만들고 액세스하는 방법을 설명합니다.
필수 조건
| 카테고리 | 요구 사항 |
|---|---|
| 설치 | Azure 배포 환경에 대한 Azure CLI 확장입니다. |
| Procedure | Azure CLI를 사용하여 개발 센터 만들기 및 구성 완료 |
| Procedure | Azure CLI를 사용하여 프로젝트 만들기 및 구성 완료 |
| Permissions | 환경을 만들려면 배포 환경 사용자 역할, DevCenter 프로젝트 관리자 역할 또는 적절한 권한이 있는 기본 제공 역할입니다. |
환경 만들기
환경을 만들면 필요한 리소스와 이를 저장할 리소스 그룹이 자동으로 만들어집니다. 리소스 그룹 이름은 패턴을 {projectName}-{environmentName}따릅니다. Azure Portal에서 리소스 그룹을 볼 수 있습니다.
Azure CLI에서 다음 단계를 완료하여 환경을 만들고 리소스를 구성합니다. ARM 템플릿(특정 Azure Resource Manager 템플릿)에 정의된 대로 출력을 볼 수 있습니다.
비고
배포 환경 사용자 역할, DevCenter 프로젝트 관리자 역할 또는 적절한 권한이 있는 기본 제공 역할이 있는 사용자만 환경을 만들 수 있습니다. 배포 환경 읽기 권한자 역할이 있는 사용자는 다른 사용자가 만든 고유한 환경 및 환경을 볼 수 있습니다.
Azure CLI에 로그인합니다.
az loginCLI용 Azure 개발자 센터 확장을 설치하거나 업그레이드합니다.
az extension add --name devcenter --upgrade액세스 권한이 있는 모든 Azure 배포 환경 프로젝트를 나열합니다.
az graph query -q "Resources | where type =~ 'microsoft.devcenter/projects'" -o table기본 구독을 프로젝트가 포함된 구독으로 구성합니다.
az account set --subscription <subscriptionName>기본 리소스 그룹을 프로젝트가 포함된 리소스 그룹으로 구성합니다.
az config set defaults.group=<resourceGroupName>특정 프로젝트에서 만들 수 있는 환경 유형을 나열합니다.
az devcenter dev environment-type list --dev-center <devcenterName> --project-name <projectName> -o table특정 프로젝트에 사용할 수 있는 환경 정의를 나열합니다 .
az devcenter dev environment-definition list --dev-center <devcenterName> --project-name <projectName> -o table사용 가능한 환경 정의 목록에서 환경 정의 ( environment.yaml 파일에 정의된 코드 기반 인프라 템플릿)를 사용하여 환경을 만듭니다.
az devcenter dev environment create --dev-center-name <devcenterName> --project-name <projectName> --environment-name <environmentName> --environment-type <environmentType> --environment-definition-name <environmentDefinitionName> --catalog-name <catalogName>특정 환경 정의 에 매개 변수가 필요한 경우 매개 변수를 JSON 문자열 또는 JSON 파일로 사용하고
--parameters제공합니다. 다음은 그 예입니다.$params = "{ 'name': 'firstMsi', 'location': 'northeurope' }" az devcenter dev environment create --dev-center-name <devcenterName> --project-name <projectName> --environment-name <environmentName> --environment-type <environmentType> --environment-definition-name <environmentDefinitionName> --catalog-name <catalogName> --parameters $params
비고
--help을 사용하여 명령, 허용되는 인수 및 예제에 대한 자세한 내용을 볼 수 있습니다. 예를 들어 환경 만들기에 대한 자세한 내용을 보려면 사용합니다 az devcenter dev environment create --help .
권한 오류 문제 해결
배포 환경 사용자 역할, DevCenter 프로젝트 관리자 역할 또는 환경을 만드는 데 필요한 권한이 있는 기본 제공 역할이 있어야 합니다.
올바른 권한이 없으면 환경이 만들어지지 않습니다. 다음 예제와 같은 오류 메시지가 나타날 수 있습니다.
(EnvironmentNotFound) The environment resource was not found.
Code: EnvironmentNotFound
Message: The environment resource was not found.
이 문제를 해결하려면 올바른 권한을 할당합니다. 개발 팀에 대한 액세스 권한을 부여합니다.
환경에 액세스
환경에 액세스하려면 다음을 수행합니다.
특정 프로젝트에서 사용할 수 있는 기존 환경을 나열합니다.
az devcenter dev environment list --dev-center <devcenterName> --project-name <projectName>ARM 템플릿 출력에 정의된 대로 다양한 리소스에 대한 액세스 엔드포인트를 봅니다.
엔드포인트를 사용하여 특정 리소스에 액세스합니다.
환경 배포
az devcenter dev environment deploy --action-id "deploy" --dev-center-name <devcenterName> \
-g <resourceGroupName> --project-name <projectName> --environment-name <environmentName> --parameters <parametersJsonString>
환경 삭제
az devcenter dev environment delete --dev-center-name <devcenterName> --project-name <projectName> --environment-name <environmentName> --user-id "me"