다음을 통해 공유


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

이 문서에서는 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 프로젝트 관리자 역할 또는 적절한 권한이 있는 기본 제공 역할이 있는 사용자만 환경을 만들 수 있습니다. 배포 환경 읽기 권한자 역할이 있는 사용자는 다른 사용자가 만든 고유한 환경 및 환경을 볼 수 있습니다.

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

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

환경에 액세스

환경에 액세스하려면 다음을 수행합니다.

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

     az devcenter dev environment list --dev-center <devcenterName> --project-name <projectName>
    
  2. ARM 템플릿 출력에 정의된 대로 다양한 리소스에 대한 액세스 엔드포인트를 봅니다.

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

환경 배포

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"