Azure 배포 환경 CLI 변수 참조

아티클
04/17/2024

ADE(Azure 배포 환경)는 사용자 지정 이미지를 작성하는 동안 참조할 수 있는 환경과 관련된 많은 변수를 설정합니다. 작업 스크립트(deploy.sh 또는 delete.sh) 내에서 아래 변수를 사용하여 이미지를 상호 작용하는 환경에 유연하게 만들 수 있습니다.

컨테이너 내에서 ADE에서 사용하는 파일의 경우 모두 초기 디렉터리의 하위 폴더에 존재 ade 합니다.

사용 가능한 환경 변수 목록은 다음과 같습니다.

ADE_ERROR_LOG

에 있는 /ade/temp/error.log파일을 참조합니다. 파일은 error.log 배포 또는 삭제 실패의 결과로 환경의 오류 세부 정보를 채우는 표준 오류 출력을 저장합니다. 이 파일은 ADE 관리 로그 파일에 표준 출력 및 표준 오류 콘텐츠를 기록하는 데 사용됩니다 ade execute. 명령을 사용하는 ade execute 경우 다음 명령을 사용하여 표준 오류 로깅을 이 파일 위치로 리디렉션합니다.

ade execute --operation $ADE_OPERATION_NAME --command "{YOUR_COMMAND}" 2> >(tee -a $ADE_ERROR_LOG)

이 방법을 사용하면 개발자 포털 내에서 배포 또는 삭제 오류를 볼 수 있습니다. 이렇게 하면 사용자 지정 이미지를 만들 때 더 빠르고 성공적인 디버깅 반복이 수행되고 실패한 작업의 근본 원인을 더 빠르게 진단할 수 있습니다.

ADE_OUTPUTS

에 있는 /ade/temp/output.json파일을 참조합니다. 파일은 output.json 환경 배포의 모든 출력을 영구 스토리지에 저장하므로 나중에 Azure CLI를 사용하여 액세스할 수 있습니다. 사용자 지정 이미지에 출력을 저장할 때 다음 예제와 같이 출력이 지정된 파일에 업로드되었는지 확인합니다.

echo "$deploymentOutput" > $ADE_OUTPUTS

ADE_STORAGE

에 있는 /ade/storage디렉터리를 참조합니다. 핵심 이미지의 진입점 중에 ADE는 환경의 스토리지 컨테이너에서 특수하게 명명된 storage.zip 파일을 끌어와 이 디렉터리를 채운 다음 작업이 완료되면 디렉터리를 zip 파일로 다시 스토리지 컨테이너로 다시 로드합니다. 상태 파일과 같은 후속 재배포 시 사용자 지정 이미지 내에서 참조하려는 파일이 있는 경우 이 디렉터리 내에 배치합니다.

ADE_CLIENT_ID

환경의 프로젝트 환경 형식에 대한 MSI(관리 서비스 ID)의 개체 ID를 나타냅니다. 이 변수를 사용하여 인프라 배포와 같이 컨테이너 내에서 활용할 수 있는 권한에 대한 Azure CLI의 유효성을 검사할 수 있습니다.

ADE_TENANT_ID

환경의 테넌트 GUID를 참조합니다.

ADE_SUBSCRIPTION_ID

환경의 구독 GUID를 참조합니다.

ADE_TEMPLATE_FILE

환경 정의의 'templatePath' 속성에 지정된 기본 템플릿 파일이 컨테이너 내에 있는 위치를 나타냅니다. 이 경로는 카탈로그를 연결한 파일 경로 수준에 따라 카탈로그 위치의 소스 제어를 대략 미러. 파일은 대략 에 있습니다 /ade/repository/{CATALOG_NAME}/{PATH_TO_TEMPLATE_FILE}. 이 메서드는 주로 기본 배포 단계에서 배포를 기반으로 참조되는 파일로 사용됩니다.

다음은 Azure CLI 사용 예입니다.

az deployment group create --subscription $ADE_SUBSCRIPTION_ID \
    --resource-group "$ADE_RESOURCE_GROUP_NAME" \
    --name "$deploymentName" \
    --no-prompt true --no-wait \
    --template-file "$ADE_TEMPLATE_FILE" \
    --parameters "$deploymentParameters" \
    --only-show-errors

사용자 지정 이미지에서 사용하려는 IaC 파일 또는 파일 지원과 같은 추가 파일은 카탈로그 내에 있는 컨테이너 내의 템플릿 파일에 대한 상대 위치에 저장됩니다. 예를 들어 다음 디렉터리를 수행합니다.

├───SampleCatalog
   ├───EnvironmentDefinition1
      │   file1.bicep
      │   main.bicep
      │   environment.yaml
      │
      └───TestFolder
              test1.txt
              test2.txt

이 경우, $ADE_TEMPLATE_FILE=/ade/repository/SampleCatalog/EnvironmentDefinition1/main.bicep입니다. 또한 file1.bicep과 같은 파일은 컨테이너의 위치에 /ade/repository/SampleCatalog/EnvironmentDefinition1/file1.bicep있고 test2.txt /ade/repository/SampleCatalog/EnvironmentDefinition1/TestFolder/test2.txt있습니다.

ADE_ENVIRONMENT_NAME

배포 시 지정된 환경의 이름입니다.

ADE_ENVIRONMENT_LOCATION

환경이 배포되는 위치입니다. 이 위치는 프로젝트의 지역입니다.

ADE_RESOURCE_GROUP_NAME

리소스를 배포하기 위해 ADE에서 만든 리소스 그룹의 이름입니다.

ADE_ENVIRONMENT_TYPE

이 환경을 배포하는 데 사용되는 프로젝트 환경 형식의 이름입니다.

ADE_OPERATION_PARAMETERS

환경을 배포하기 위해 제공된 매개 변수의 JSON 개체입니다. 매개 변수 개체의 예는 다음과 같습니다.

{
    "location": "locationInput",
    "name": "nameInput",
    "sampleObject": {
        "sampleProperty": "sampleValue"
    },
    "sampleArray": [
        "sampleArrayValue1",
        "sampleArrayValue2"
    ]
}

ADE_OPERATION_NAME

환경에서 수행되는 작업의 유형입니다. 현재 이 값은 'deploy' 또는 'delete'입니다.

ADE_HTTP__OPERATIONID

환경에서 수행되는 작업에 할당된 작업 ID입니다. 작업 ID는 ADE CLI를 사용하기 위한 유효성 검사로 사용되며 과거 작업에서 로그를 검색할 때 기본 식별자입니다.

ADE_HTTP__DEVCENTERID

환경의 개발자 센터 ID입니다. 개발자 센터 ID는 ADE CLI를 사용하기 위한 유효성 검사로도 사용됩니다.

다음을 통해 공유