Azure 개발자 CLI 환경 작업

Azure 개발자 CLI(azd)를 사용하면 개발, 테스트 및 prod와 같은 자체 구성으로 환경을 만들고 관리할 수 있습니다. 이 문서에서는 환경을 만들고 관리하는 방법과 Bicep 인프라 파일에서 환경을 사용하는 방법을 보여 줍니다.

환경 만들기

다음 명령을 사용하여 새 환경을 만듭니다 azd env new .

azd env new <environment-name>

예를 들어 개발 환경을 만들려면 다음을 수행합니다.

azd env new dev

같은 azd up 명령을 실행하면 azd deployazd 새 환경에 대한 Azure 구독 및 위치를 선택하라는 메시지가 표시됩니다. 프롬프트 설정은 새 환경 .env 또는 config.json 파일에 저장됩니다.

또한 명령에서 직접 구독 및 위치를 지정할 수 있습니다.

azd env new prod --subscription "My Production Subscription" --location eastus2

환경 나열

프로젝트에 사용 가능한 모든 환경을 보려면 다음을 사용합니다.

azd env list

이 명령은 현재 활성 환경을 강조 표시하여 만든 모든 환경을 표시합니다.

NAME      DEFAULT   LOCAL     REMOTE
dev       true      true      false
test      false     true      false
prod      false     true      false

환경 간 전환

다른 환경으로 전환하려면 다음 azd env select 명령을 사용합니다.

azd env select <environment-name>

예를 들어 프로덕션 환경으로 전환하려면 다음을 수행합니다.

azd env select prod

비고

이 명령은 활성 환경을 변경하여 이후 azd 명령과 같은 provision 또는 deploy에 영향을 줍니다.

기본 환경 이해

전역 구성 파일 .azure/config.json 은 현재 선택한 환경을 추적합니다. 실행 azd init 중이며 아직 azd 환경이 없으면 첫 번째 환경이 자동으로 만들어지고 기본값으로 설정됩니다. 이미 하나 이상의 환경이 있고 실행 azd env new <name>azd 중인 경우 새 환경을 기본 환경으로 지정할지 여부를 선택하라는 메시지가 표시됩니다. 거절하면 새 환경이 만들어지지만 현재 선택은 변경되지 않습니다.

플래그를 사용하여 단일 명령에 대한 기본 환경을 일시적으로 재정의할 --environment 수 있습니다. 이 플래그를 사용하면 이후 명령에 대한 기본값이 변경되지 않습니다.

환경 설정 새로 고침

명령을 사용하여 azd env refresh 로컬 환경 변수를 새로 고칠 수 있습니다. 이 명령은 앱에 대한 최신 Azure 배포를 찾고, 이름으로 환경 변수 값을 검색한 다음, 선택한 환경에 대한 최신 값으로 로컬 .env 파일을 업데이트합니다. 예를 들어 버전과 prod 버전을 dev 모두 프로비전하고 현재 환경이 dev 선택된 경우 해당 배포에서 최신 출력을 검색하여 .env 파일을 채웁니다.

azd env refresh

비고

이 azd env refresh 명령은 리소스를 다시 배포하지 않습니다. Azure의 현재 상태와 일치하도록 로컬 환경 구성만 업데이트합니다.

환경 새로 고침은 다음과 같은 경우에 유용합니다.

로컬 .env 파일이 인프라의 최신 출력(예: 연결 문자열, 엔드포인트 등)을 반영하는지 확인하려고 합니다.
팀 동료가 환경을 업데이트한 후 환경 변수를 동기화해야 합니다.

다른 팀 구성원이 환경 구성을 변경했거나 Azure Portal을 통해 변경한 경우 다음을 사용하여 로컬 환경 설정을 새로 고칠 수 있습니다.

특정 환경에서 명령 실행

또는 -e 플래그를 사용하여 --environment 활성 환경을 변경하지 않고 특정 환경에서 많은 azd 명령을 실행할 수 있습니다.

azd up --environment dev

이 명령은 활성 환경을 변경하지 않고 환경에서 워크플로(프로비전 및 배포)dev를 실행 up 합니다.

또는 먼저 원하는 환경으로 전환할 수 있습니다.

azd env select test
azd up

비고

Teams는 명령과 같은 azd upazd provision명령을 사용하여 직접 배포하는 대신 명령을 통해 azd pipeline config CICD 파이프라인을 사용하는 것을 고려해야 합니다.

환경 리소스 삭제

명령을 사용하여 특정 환경에 대한 Azure 리소스를 삭제하려면 다음을 수행합니다 azd down .

azd down <environment-name>

비고

현재는 명령을 사용하여 환경을 직접 삭제하거나 이름을 바꿀 azd 수 없습니다. 환경의 이름을 바꿔야 하는 경우:

환경 리소스를 삭제하는 데 사용합니다 azd down .
실행 azd env new <new-name> 하여 새 환경을 만듭니다.
에서 이전 .env 폴더 .azure를 수동으로 삭제합니다.

인프라 파일에서 환경 이름 사용

환경 파일의 .env 변수를 AZURE_ENV_NAME 사용하여 Bicep에서 인프라 배포를 사용자 지정할 수 있습니다. 이는 현재 환경에 따라 리소스를 명명, 태그 지정 또는 구성하는 데 유용합니다.

비고

환경 변수를 사용하여 Azure 개발자 CLI 프로젝트를 구성하는 방법에 대해 자세히 알아보려면 환경 변수로 작업하세요.

azd AZURE_ENV_NAME 는 프로젝트를 초기화할 때 환경 변수를 설정합니다.
```
AZURE_ENV_NAME=dev
```

main.parameters.json 파일에서 환경 변수를 참조하여 azd 해당 값을 대체합니다.

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentParameters.json#",
  "contentVersion": "1.0.0.0",
  "parameters": {
    "environmentName": {
      "value": "${AZURE_ENV_NAME}"
    }
  }
}

함께 azd배포하면 해당 값이 .에서 .envmain.parameters.jsonBicep 파일로 전달됩니다.

Bicep 템플릿에서 환경 이름에 대한 매개 변수를 정의합니다.
```
param environmentName string
```

매개 변수를 environmentName 사용하여 리소스에 태그를 지정하여 리소스가 속한 환경을 쉽게 식별할 수 있습니다.

param environmentName string

resource storageAccount 'Microsoft.Storage/storageAccounts@2022-09-01' = {
  name: 'mystorage${uniqueString(resourceGroup().id)}'
  location: resourceGroup().location
  sku: {
    name: 'Standard_LRS'
  }
  kind: 'StorageV2'
  tags: {
    Environment: environmentName
    Project: 'myproject'
  }
}

이 방법은 각 리소스를 배포 환경과 연결하여 리소스 관리, 비용 추적 및 자동화에 도움이 됩니다.

다음 단계

Azure Developer CLI에서 환경 변수 관리

후크를 사용하여 Azure 개발자 CLI 워크플로 사용자 지정

피드백

이 페이지가 도움이 되었나요?

Last updated on 2025-08-15