다음을 통해 공유

Azure CLI를 사용하여 환경 만들기 및 액세스

  • 아티클

이 가이드에서는 Azure CLI를 사용하여 기존 Azure Deployment Environments 프로젝트에서 환경을 만들고 액세스하는 방법을 설명합니다.

필수 조건

환경 만들기

환경을 만들면 필요한 리소스와 이를 저장할 리소스 그룹이 자동으로 만들어집니다. 리소스 그룹 이름은 {projectName}-{environmentName} 패턴을 따릅니다. Azure Portal에서 리소스 그룹을 볼 수 있습니다.

Azure CLI에서 다음 단계를 완료하여 환경을 만들고 리소스를 구성합니다. 특정 ARM 템플릿(Azure Resource Manager 템플릿)에 정의된 대로 출력을 볼 수 있습니다.

참고 항목

배포 환경 사용자 역할, DevCenter 프로젝트 관리자 역할 또는 적절한 권한이 있는 기본 제공 역할이 있는 사용자만 환경을 만들 수 있습니다. 배포 환경 읽기 권한자 역할이 있는 사용자는 자신의 환경과 다른 사용자가 만든 환경을 볼 수 있습니다.

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

    az login

  2. CLI용 Azure 개발자 센터 확장을 설치합니다.

    az extension add --name devcenter --upgrade

  3. 액세스 권한이 있는 모든 Azure 배포 환경 프로젝트를 나열합니다.

    az graph query -q "Resources | where type =~ 'microsoft.devcenter/projects'" -o table

  4. 프로젝트를 포함하는 구독으로 기본 구독을 구성합니다.

    az account set --subscription <subscriptionName>

  5. 프로젝트를 포함하는 리소스 그룹으로 기본 리소스 그룹을 구성합니다.

    az config set defaults.group=<resourceGroupName>

  6. 특정 프로젝트에서 만들 수 있는 환경 형식을 나열합니다.

    az devcenter dev environment-type list --dev-center <devcenterName> --project-name <projectName> -o table

  7. 특정 프로젝트에서 사용할 수 있는 환경 정의를 나열합니다.

    az devcenter dev environment-definition list --dev-center <devcenterName> --project-name <projectName> -o table

  8. 사용 가능한 환경 정의 목록에서 environment-definition(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>

    특정 environment-definition에 매개 변수가 필요한 경우 --parameters를 사용하고 JSON 문자열 또는 JSON 파일로 매개 변수를 제공합니다. 예시:

    $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.

문제를 해결하려면 개발팀에 액세스 권한 부여와 같이 올바른 권한을 할당합니다.

환경에 액세스

환경에 액세스하려면:

  1. 특정 프로젝트에서 사용할 수 있는 기존 환경을 나열합니다.

     az devcenter dev environment list --dev-center <devcenterName> --project-name <projectName>

  2. ARM 템플릿 출력에 정의된 대로 다양한 리소스에 대한 액세스 엔드포인트를 봅니다.

  3. 엔드포인트를 사용하여 특정 리소스에 액세스합니다.

환경 배포

az devcenter dev environment deploy-action --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"

관련 콘텐츠