Microsoft.Resources deploymentScripts

아티클
10/19/2024

Bicep 리소스 정의

deploymentScripts 리소스 종류는 다음을 대상으로 하는 작업으로 배포할 수 있습니다.

리소스 그룹 - 리소스 그룹 배포 명령 참조

각 API 버전에서 변경된 속성 목록은 변경 로그참조하세요.

발언

배포 중에 스크립트를 실행하는 방법에 대한 자세한 내용은 Bicep 배포 스크립트 사용 또는 ARM 템플릿배포 스크립트 사용 참조하세요.

리소스 형식

Microsoft.Resources/deploymentScripts 리소스를 만들려면 템플릿에 다음 Bicep을 추가합니다.

resource symbolicname 'Microsoft.Resources/deploymentScripts@2023-08-01' = {
  name: 'string'
  location: 'string'
  tags: {
    tagName1: 'tagValue1'
    tagName2: 'tagValue2'
  }
  kind: 'string'
  identity: {
    type: 'UserAssigned'
    userAssignedIdentities: {
      {customized property}: {}
    }
  }
  // For remaining properties, see deploymentScripts objects
}

deploymentScripts 개체

종류 속성을 설정하여 개체 유형을 지정합니다.

azureCLI경우 다음을 사용합니다.

  kind: 'AzureCLI'
  properties: {
    arguments: 'string'
    azCliVersion: 'string'
    cleanupPreference: 'string'
    containerSettings: {
      containerGroupName: 'string'
      subnetIds: [
        {
          id: 'string'
          name: 'string'
        }
      ]
    }
    environmentVariables: [
      {
        name: 'string'
        secureValue: 'string'
        value: 'string'
      }
    ]
    forceUpdateTag: 'string'
    primaryScriptUri: 'string'
    retentionInterval: 'string'
    scriptContent: 'string'
    storageAccountSettings: {
      storageAccountKey: 'string'
      storageAccountName: 'string'
    }
    supportingScriptUris: [
      'string'
    ]
    timeout: 'string'
  }

azurePowerShell경우 다음을 사용합니다.

  kind: 'AzurePowerShell'
  properties: {
    arguments: 'string'
    azPowerShellVersion: 'string'
    cleanupPreference: 'string'
    containerSettings: {
      containerGroupName: 'string'
      subnetIds: [
        {
          id: 'string'
          name: 'string'
        }
      ]
    }
    environmentVariables: [
      {
        name: 'string'
        secureValue: 'string'
        value: 'string'
      }
    ]
    forceUpdateTag: 'string'
    primaryScriptUri: 'string'
    retentionInterval: 'string'
    scriptContent: 'string'
    storageAccountSettings: {
      storageAccountKey: 'string'
      storageAccountName: 'string'
    }
    supportingScriptUris: [
      'string'
    ]
    timeout: 'string'
  }

속성 값

deploymentScripts

이름	묘사	값
이름	리소스 이름	string(필수)
위치	배포 스크립트에 대한 ACI 및 스토리지 계정의 위치입니다.	string(필수)
태그	리소스 태그.	태그 이름 및 값의 사전입니다. 템플릿 태그를 참조하세요.
종류	개체 유형 설정	AzureCLI AzurePowerShell (필수)
신원	선택적 속성입니다. 이 배포 스크립트에 사용할 관리 ID입니다. 현재 사용자 할당 MSI만 지원됩니다.	ManagedServiceIdentity

AzureCliScript

이름	묘사	값
종류	스크립트의 형식입니다.	'AzureCLI'(필수)
속성	Azure CLI 스크립트 개체의 속성입니다.	AzureCliScriptProperties (필수)

AzureCliScriptProperties

이름	묘사	값
인수	스크립트에 전달할 명령줄 인수입니다. 인수는 공백으로 구분됩니다. ex: -Name blue* -Location '미국 서부 2'	문자열
azCliVersion	사용할 Azure CLI 모듈 버전입니다.	string(필수)
cleanupPreference	스크립트 실행이 터미널 상태에 있을 때의 정리 기본 설정입니다. 기본 설정은 'Always'입니다.	'Always' 'OnExpiration' 'OnSuccess'
containerSettings	컨테이너 설정.	ContainerConfiguration
environmentVariables	스크립트에 전달할 환경 변수입니다.	EnvironmentVariable[]
forceUpdateTag	스크립트 리소스가 변경되지 않은 경우에도 배포 스크립트를 강제로 실행하는 방법을 가져오거나 설정합니다. 현재 타임스탬프는 GUID일 수 있습니다.	문자열
primaryScriptUri	스크립트의 URI입니다. 외부 스크립트의 진입점입니다.	문자열
retentionInterval	서비스가 터미널 상태에 도달한 후 스크립트 리소스를 유지하는 간격입니다. 이 기간이 만료되면 리소스가 삭제됩니다. 기간은 ISO 8601 패턴을 기반으로 합니다(예: P1D는 1일을 의미).	string(필수)
scriptContent	스크립트 본문입니다.	문자열
storageAccountSettings	스토리지 계정 설정입니다.	StorageAccountConfiguration
supportingScriptUris	외부 스크립트에 대한 지원 파일입니다.	string[]
타임 아웃	ISO 8601 형식으로 지정된 최대 허용 스크립트 실행 시간입니다. 기본값은 P1D입니다.	문자열

ContainerConfiguration

이름	묘사	값
containerGroupName	컨테이너 그룹 이름을 지정하지 않으면 이름이 자동으로 생성됩니다. 'containerGroupName'을 지정하지 않으면 시스템이 Azure Policy를 비준수로 플래그를 지정할 수 있는 고유한 이름을 생성하도록 나타냅니다. 특정 명명 규칙을 예상하는 Azure Policy가 있거나 이름을 완전히 제어하려는 경우 'containerGroupName'을 사용합니다. 'containerGroupName' 속성은 1자에서 63자 사이여야 하고 소문자, 숫자 및 대시만 포함해야 하며 대시로 시작하거나 끝낼 수 없으며 연속 대시는 허용되지 않습니다. 'containerGroupName'을 지정하려면 속성에 다음 개체를 추가합니다. { "containerSettings": { "containerGroupName": "contoso-container" } }. 'containerGroupName'을 지정하지 않으려면 'containerSettings' 속성을 추가하지 마세요.	문자열 제약 조건: 최소 길이 = 1 최대 길이 = 63
subnetIds	컨테이너 그룹의 서브넷 리소스 ID입니다.	ContainerGroupSubnetId[]

ContainerGroupSubnetId

이름	묘사	값
아이디	서브넷의 리소스 ID입니다.	string(필수)
이름	서브넷의 이름입니다.	문자열

EnvironmentVariable

이름	묘사	값
이름	환경 변수의 이름입니다.	string(필수)
secureValue	보안 환경 변수의 값입니다.	문자열 제약 조건: 중요한 값입니다. 보안 매개 변수로 전달합니다.
값	환경 변수의 값입니다.	문자열

StorageAccountConfiguration

이름	묘사	값
storageAccountKey	스토리지 계정 액세스 키입니다.	문자열 제약 조건: 중요한 값입니다. 보안 매개 변수로 전달합니다.
storageAccountName	스토리지 계정 이름입니다.	문자열

AzurePowerShellScript

이름	묘사	값
종류	스크립트의 형식입니다.	'AzurePowerShell'(필수)
속성	Azure PowerShell 스크립트 개체의 속성입니다.	AzurePowerShellScriptProperties (필수)

AzurePowerShellScriptProperties

이름	묘사	값
인수	스크립트에 전달할 명령줄 인수입니다. 인수는 공백으로 구분됩니다. ex: -Name blue* -Location '미국 서부 2'	문자열
azPowerShellVersion	사용할 Azure PowerShell 모듈 버전입니다.	string(필수)
cleanupPreference	스크립트 실행이 터미널 상태에 있을 때의 정리 기본 설정입니다. 기본 설정은 'Always'입니다.	'Always' 'OnExpiration' 'OnSuccess'
containerSettings	컨테이너 설정.	ContainerConfiguration
environmentVariables	스크립트에 전달할 환경 변수입니다.	EnvironmentVariable[]
forceUpdateTag	스크립트 리소스가 변경되지 않은 경우에도 배포 스크립트를 강제로 실행하는 방법을 가져오거나 설정합니다. 현재 타임스탬프는 GUID일 수 있습니다.	문자열
primaryScriptUri	스크립트의 URI입니다. 외부 스크립트의 진입점입니다.	문자열
retentionInterval	서비스가 터미널 상태에 도달한 후 스크립트 리소스를 유지하는 간격입니다. 이 기간이 만료되면 리소스가 삭제됩니다. 기간은 ISO 8601 패턴을 기반으로 합니다(예: P1D는 1일을 의미).	string(필수)
scriptContent	스크립트 본문입니다.	문자열
storageAccountSettings	스토리지 계정 설정입니다.	StorageAccountConfiguration
supportingScriptUris	외부 스크립트에 대한 지원 파일입니다.	string[]
타임 아웃	ISO 8601 형식으로 지정된 최대 허용 스크립트 실행 시간입니다. 기본값은 P1D입니다.	문자열

ManagedServiceIdentity

이름	묘사	값
형	관리 ID의 형식입니다.	'UserAssigned'
userAssignedIdentities	리소스와 연결된 사용자 할당 관리 ID 목록입니다. 키는 관리 ID의 Azure 리소스 ID입니다.	ManagedServiceIdentityUserAssignedIdentities

ManagedServiceIdentityUserAssignedIdentities

이름	묘사	값
{customized property}		UserAssignedIdentity

UserAssignedIdentity

이 개체에는 배포 중에 설정할 속성이 없습니다. 모든 속성은 ReadOnly입니다.

빠른 시작 템플릿

다음 빠른 시작 템플릿은 이 리소스 유형을 배포합니다.

템플렛	묘사
Azure Gateway min.io Azure 배포	Blob Storage에서 지원되는 S3 호환 스토리지 API를 제공하는 완전 프라이빗 min.io Azure Gateway 배포
WordPress 사이트 만들기 Azure 배포	이 템플릿은 Container Instance에 WordPress 사이트를 만듭니다.
Azure Windows 기준 사용하여 Azure Image Builder Azure 배포	Azure Image Builder 환경을 만들고 최신 Windows 업데이트 및 Azure Windows 기준이 적용된 Windows Server 이미지를 빌드합니다.
ZIP 보관 URL VHD Blob 가져오기 Azure 배포	특수 디스크 이미지를 기반으로 Virtual Machines를 배포하려면 VHD 파일을 스토리지 계정으로 가져와야 합니다. 단일 ZIP에 압축된 여러 VHD 파일이 있고 ZIP 보관 파일을 가져올 URL을 얻은 경우 이 ARM 템플릿은 작업을 용이하게 합니다. 다운로드, 추출 및 기존 스토리지 계정 Blob 컨테이너로 가져오기.
URI에서 Blob Storage 컨테이너로 파일 복사 Azure 배포	이 모듈은 URI에서 파일을 다운로드하여 Azure storageAccount Blob 컨테이너에 복사합니다. storageAccount가 이미 있어야 하며 원본 파일이 이미 URI로 준비되어야 합니다.
레지스트리 사용하여 컨테이너 앱 및 환경을 만듭니다. Azure 배포	Azure Container Registry에서 기본 컨테이너 앱을 사용하여 컨테이너 앱 환경을 만듭니다. 또한 Log Analytics 작업 영역을 배포하여 로그를 저장합니다.
Container Apps 사용하여 Dapr pub-sub servicebus 앱을 만듭니다. Azure 배포	Container Apps를 사용하여 Dapr pub-sub servicebus 앱을 만듭니다.
간단한 Azure Spring Apps 마이크로 서비스 애플리케이션 배포 Azure 배포	이 템플릿은 Azure에서 실행할 간단한 Azure Spring Apps 마이크로 서비스 애플리케이션을 배포합니다.
정적 웹 사이트 원본 사용하여 Front Door 표준/프리미엄 Azure 배포	이 템플릿은 Front Door 표준/프리미엄 및 Azure Storage 정적 웹 사이트를 만들고, 정적 웹 사이트로 트래픽을 보내도록 Front Door를 구성했습니다.
영구 스토리지 사용하여 주문형 SFTP 서버 만들기 Azure 배포	이 템플릿은 ACI(Azure Container Instance)를 사용하는 주문형 SFTP 서버를 보여 줍니다.
FinOps 허브 Azure 배포	이 템플릿은 Data Lake Storage 및 Data Factory를 포함하여 새 FinOps 허브 인스턴스를 만듭니다.
데이터 팩터리 복사 데이터 도구에 대한 Blob 만들기 빠른 시작 Azure 배포	이 템플릿은 Blob Storage를 만들고 데이터 복사 도구 빠른 시작에 대한 파일을 업로드합니다.
Azure Data Factory를 사용하여 더 많은 작업을 할 수 있습니다. 한 번의 클릭으로 Azure Data Factory Azure 배포	이 템플릿은 Azure Blob에서 다른 Azure Blob으로의 복사 작업에 대한 데이터 팩터리 파이프라인을 만듭니다.
Dev Box 서비스 구성 Azure 배포	이 템플릿은 Dev Box 빠른 시작 가이드(https://learn.microsoft.com/azure/dev-box/quickstart-create-dev-box)에 따라 모든 Dev Box 관리 리소스를 만듭니다. 만든 모든 리소스를 보거나 DevPortal.microsoft.com 직접 이동하여 첫 번째 Dev Box를 만들 수 있습니다.
Helm 사용하여 AKS(Azure Container Service) Azure 배포	Helm을 사용하여 AKS(Azure Container Service)를 사용하여 관리형 클러스터 배포
azure Machine Learning Sweep 작업 만들기 Azure 배포	이 템플릿은 하이퍼 매개 변수 튜닝을 위한 Azure Machine Learning Sweep 작업을 만듭니다.
Azure Firewall Premium 대한 테스트 환경 Azure 배포	이 템플릿은 IDPS(침입 검사 검색), TLS 검사 및 웹 범주 필터링과 같은 프리미엄 기능을 사용하여 Azure Firewall 프리미엄 및 방화벽 정책을 만듭니다.
ACR 작업 사용하여 컨테이너 이미지 빌드 Azure 배포	이 템플릿은 DeploymentScript를 사용하여 ACR을 오케스트레이션하여 코드 리포지토리에서 컨테이너 이미지를 빌드합니다.
컨테이너 이미지를 ACR 가져오기 Azure 배포	이 템플릿은 bicep 레지스트리에서 ACR 가져오기 모듈을 활용하여 공용 컨테이너 이미지를 Azure Container Registry로 가져옵니다.
인증서 사용하여 Application Gateway 만들기 Azure 배포	이 템플릿은 Key Vault 자체 서명된 인증서를 생성한 다음 Application Gateway에서 참조하는 방법을 보여 줍니다.
배포 스크립트를 사용하여 Azure AD 개체 만들기 Azure 배포	이 샘플에서는 배포 스크립트를 사용하여 Azure Active Directory에서 개체를 만듭니다.
출력 복잡한 입력 & 배포 스크립트 만들기 Azure 배포	이 템플릿은 Az CLI 배포 스크립트에 복잡한 입력, 출력 및 로그를 전달하고 읽기 위한 모범 사례를 보여 줍니다.
출력 복잡한 입력 & 배포 스크립트 만들기 Azure 배포	이 템플릿은 Az Powershell 배포 스크립트에 복잡한 입력, 출력 및 로그를 전달하고 읽는 모범 사례를 보여 줍니다.
ssh 키를 만들고 KeyVault 저장 Azure 배포	이 템플릿은 deploymentScript 리소스를 사용하여 ssh 키를 생성하고 keyVault에 프라이빗 키를 저장합니다.
정적 웹 사이트 배포 Azure 배포	백업 스토리지 계정을 사용하여 정적 웹 사이트 배포
원격 빌드 사용하여 Linux 사용 계획에서 함수 앱 Azure 배포	이 템플릿은 Linux 소비 계획에 함수 앱을 프로비전하고 코드 배포 중에 원격 빌드를 수행합니다. 앱은 요청 시 실행되며 실행당 요금이 청구되며, 대기 리소스 약정은 없습니다.
Azure Virtual Network Manager 및 샘플 VNET 만들기 Azure 배포	이 템플릿은 Azure Virtual Network Manager 및 샘플 가상 네트워크를 명명된 리소스 그룹에 배포합니다. 여러 연결 토폴로지 및 네트워크 그룹 멤버 자격 유형을 지원합니다.

ARM 템플릿 리소스 정의

deploymentScripts 리소스 종류는 다음을 대상으로 하는 작업으로 배포할 수 있습니다.

리소스 그룹 - 리소스 그룹 배포 명령 참조

각 API 버전에서 변경된 속성 목록은 변경 로그참조하세요.

발언

배포 중에 스크립트를 실행하는 방법에 대한 자세한 내용은 Bicep 배포 스크립트 사용 또는 ARM 템플릿배포 스크립트 사용 참조하세요.

리소스 형식

Microsoft.Resources/deploymentScripts 리소스를 만들려면 템플릿에 다음 JSON을 추가합니다.

{
  "type": "Microsoft.Resources/deploymentScripts",
  "apiVersion": "2023-08-01",
  "name": "string",
  "location": "string",
  "tags": {
    "tagName1": "tagValue1",
    "tagName2": "tagValue2"
  },
  "kind": "string",
  "identity": {
    "type": "UserAssigned",
    "userAssignedIdentities": {
      "{customized property}": {}
    }
  },
  // For remaining properties, see deploymentScripts objects
}

deploymentScripts 개체

종류 속성을 설정하여 개체 유형을 지정합니다.

azureCLI경우 다음을 사용합니다.

  "kind": "AzureCLI",
  "properties": {
    "arguments": "string",
    "azCliVersion": "string",
    "cleanupPreference": "string",
    "containerSettings": {
      "containerGroupName": "string",
      "subnetIds": [
        {
          "id": "string",
          "name": "string"
        }
      ]
    },
    "environmentVariables": [
      {
        "name": "string",
        "secureValue": "string",
        "value": "string"
      }
    ],
    "forceUpdateTag": "string",
    "primaryScriptUri": "string",
    "retentionInterval": "string",
    "scriptContent": "string",
    "storageAccountSettings": {
      "storageAccountKey": "string",
      "storageAccountName": "string"
    },
    "supportingScriptUris": [ "string" ],
    "timeout": "string"
  }

azurePowerShell경우 다음을 사용합니다.

  "kind": "AzurePowerShell",
  "properties": {
    "arguments": "string",
    "azPowerShellVersion": "string",
    "cleanupPreference": "string",
    "containerSettings": {
      "containerGroupName": "string",
      "subnetIds": [
        {
          "id": "string",
          "name": "string"
        }
      ]
    },
    "environmentVariables": [
      {
        "name": "string",
        "secureValue": "string",
        "value": "string"
      }
    ],
    "forceUpdateTag": "string",
    "primaryScriptUri": "string",
    "retentionInterval": "string",
    "scriptContent": "string",
    "storageAccountSettings": {
      "storageAccountKey": "string",
      "storageAccountName": "string"
    },
    "supportingScriptUris": [ "string" ],
    "timeout": "string"
  }

속성 값

deploymentScripts

이름	묘사	값
형	리소스 종류	'Microsoft.Resources/deploymentScripts'
apiVersion	리소스 api 버전	'2023-08-01'
이름	리소스 이름	string(필수)
위치	배포 스크립트에 대한 ACI 및 스토리지 계정의 위치입니다.	string(필수)
태그	리소스 태그.	태그 이름 및 값의 사전입니다. 템플릿 태그를 참조하세요.
종류	개체 유형 설정	AzureCLI AzurePowerShell (필수)
신원	선택적 속성입니다. 이 배포 스크립트에 사용할 관리 ID입니다. 현재 사용자 할당 MSI만 지원됩니다.	ManagedServiceIdentity

AzureCliScript

이름	묘사	값
종류	스크립트의 형식입니다.	'AzureCLI'(필수)
속성	Azure CLI 스크립트 개체의 속성입니다.	AzureCliScriptProperties (필수)

AzureCliScriptProperties

이름	묘사	값
인수	스크립트에 전달할 명령줄 인수입니다. 인수는 공백으로 구분됩니다. ex: -Name blue* -Location '미국 서부 2'	문자열
azCliVersion	사용할 Azure CLI 모듈 버전입니다.	string(필수)
cleanupPreference	스크립트 실행이 터미널 상태에 있을 때의 정리 기본 설정입니다. 기본 설정은 'Always'입니다.	'Always' 'OnExpiration' 'OnSuccess'
containerSettings	컨테이너 설정.	ContainerConfiguration
environmentVariables	스크립트에 전달할 환경 변수입니다.	EnvironmentVariable[]
forceUpdateTag	스크립트 리소스가 변경되지 않은 경우에도 배포 스크립트를 강제로 실행하는 방법을 가져오거나 설정합니다. 현재 타임스탬프는 GUID일 수 있습니다.	문자열
primaryScriptUri	스크립트의 URI입니다. 외부 스크립트의 진입점입니다.	문자열
retentionInterval	서비스가 터미널 상태에 도달한 후 스크립트 리소스를 유지하는 간격입니다. 이 기간이 만료되면 리소스가 삭제됩니다. 기간은 ISO 8601 패턴을 기반으로 합니다(예: P1D는 1일을 의미).	string(필수)
scriptContent	스크립트 본문입니다.	문자열
storageAccountSettings	스토리지 계정 설정입니다.	StorageAccountConfiguration
supportingScriptUris	외부 스크립트에 대한 지원 파일입니다.	string[]
타임 아웃	ISO 8601 형식으로 지정된 최대 허용 스크립트 실행 시간입니다. 기본값은 P1D입니다.	문자열

ContainerConfiguration

이름	묘사	값
containerGroupName	컨테이너 그룹 이름을 지정하지 않으면 이름이 자동으로 생성됩니다. 'containerGroupName'을 지정하지 않으면 시스템이 Azure Policy를 비준수로 플래그를 지정할 수 있는 고유한 이름을 생성하도록 나타냅니다. 특정 명명 규칙을 예상하는 Azure Policy가 있거나 이름을 완전히 제어하려는 경우 'containerGroupName'을 사용합니다. 'containerGroupName' 속성은 1자에서 63자 사이여야 하고 소문자, 숫자 및 대시만 포함해야 하며 대시로 시작하거나 끝낼 수 없으며 연속 대시는 허용되지 않습니다. 'containerGroupName'을 지정하려면 속성에 다음 개체를 추가합니다. { "containerSettings": { "containerGroupName": "contoso-container" } }. 'containerGroupName'을 지정하지 않으려면 'containerSettings' 속성을 추가하지 마세요.	문자열 제약 조건: 최소 길이 = 1 최대 길이 = 63
subnetIds	컨테이너 그룹의 서브넷 리소스 ID입니다.	ContainerGroupSubnetId[]

ContainerGroupSubnetId

이름	묘사	값
아이디	서브넷의 리소스 ID입니다.	string(필수)
이름	서브넷의 이름입니다.	문자열

EnvironmentVariable

이름	묘사	값
이름	환경 변수의 이름입니다.	string(필수)
secureValue	보안 환경 변수의 값입니다.	문자열 제약 조건: 중요한 값입니다. 보안 매개 변수로 전달합니다.
값	환경 변수의 값입니다.	문자열

StorageAccountConfiguration

이름	묘사	값
storageAccountKey	스토리지 계정 액세스 키입니다.	문자열 제약 조건: 중요한 값입니다. 보안 매개 변수로 전달합니다.
storageAccountName	스토리지 계정 이름입니다.	문자열

AzurePowerShellScript

이름	묘사	값
종류	스크립트의 형식입니다.	'AzurePowerShell'(필수)
속성	Azure PowerShell 스크립트 개체의 속성입니다.	AzurePowerShellScriptProperties (필수)

AzurePowerShellScriptProperties

이름	묘사	값
인수	스크립트에 전달할 명령줄 인수입니다. 인수는 공백으로 구분됩니다. ex: -Name blue* -Location '미국 서부 2'	문자열
azPowerShellVersion	사용할 Azure PowerShell 모듈 버전입니다.	string(필수)
cleanupPreference	스크립트 실행이 터미널 상태에 있을 때의 정리 기본 설정입니다. 기본 설정은 'Always'입니다.	'Always' 'OnExpiration' 'OnSuccess'
containerSettings	컨테이너 설정.	ContainerConfiguration
environmentVariables	스크립트에 전달할 환경 변수입니다.	EnvironmentVariable[]
forceUpdateTag	스크립트 리소스가 변경되지 않은 경우에도 배포 스크립트를 강제로 실행하는 방법을 가져오거나 설정합니다. 현재 타임스탬프는 GUID일 수 있습니다.	문자열
primaryScriptUri	스크립트의 URI입니다. 외부 스크립트의 진입점입니다.	문자열
retentionInterval	서비스가 터미널 상태에 도달한 후 스크립트 리소스를 유지하는 간격입니다. 이 기간이 만료되면 리소스가 삭제됩니다. 기간은 ISO 8601 패턴을 기반으로 합니다(예: P1D는 1일을 의미).	string(필수)
scriptContent	스크립트 본문입니다.	문자열
storageAccountSettings	스토리지 계정 설정입니다.	StorageAccountConfiguration
supportingScriptUris	외부 스크립트에 대한 지원 파일입니다.	string[]
타임 아웃	ISO 8601 형식으로 지정된 최대 허용 스크립트 실행 시간입니다. 기본값은 P1D입니다.	문자열

ManagedServiceIdentity

이름	묘사	값
형	관리 ID의 형식입니다.	'UserAssigned'
userAssignedIdentities	리소스와 연결된 사용자 할당 관리 ID 목록입니다. 키는 관리 ID의 Azure 리소스 ID입니다.	ManagedServiceIdentityUserAssignedIdentities

ManagedServiceIdentityUserAssignedIdentities

이름	묘사	값
{customized property}		UserAssignedIdentity

UserAssignedIdentity

이 개체에는 배포 중에 설정할 속성이 없습니다. 모든 속성은 ReadOnly입니다.

빠른 시작 템플릿

다음 빠른 시작 템플릿은 이 리소스 유형을 배포합니다.

템플렛	묘사
Azure Gateway min.io Azure 배포	Blob Storage에서 지원되는 S3 호환 스토리지 API를 제공하는 완전 프라이빗 min.io Azure Gateway 배포
WordPress 사이트 만들기 Azure 배포	이 템플릿은 Container Instance에 WordPress 사이트를 만듭니다.
Azure Windows 기준 사용하여 Azure Image Builder Azure 배포	Azure Image Builder 환경을 만들고 최신 Windows 업데이트 및 Azure Windows 기준이 적용된 Windows Server 이미지를 빌드합니다.
ZIP 보관 URL VHD Blob 가져오기 Azure 배포	특수 디스크 이미지를 기반으로 Virtual Machines를 배포하려면 VHD 파일을 스토리지 계정으로 가져와야 합니다. 단일 ZIP에 압축된 여러 VHD 파일이 있고 ZIP 보관 파일을 가져올 URL을 얻은 경우 이 ARM 템플릿은 작업을 용이하게 합니다. 다운로드, 추출 및 기존 스토리지 계정 Blob 컨테이너로 가져오기.
URI에서 Blob Storage 컨테이너로 파일 복사 Azure 배포	이 모듈은 URI에서 파일을 다운로드하여 Azure storageAccount Blob 컨테이너에 복사합니다. storageAccount가 이미 있어야 하며 원본 파일이 이미 URI로 준비되어야 합니다.
레지스트리 사용하여 컨테이너 앱 및 환경을 만듭니다. Azure 배포	Azure Container Registry에서 기본 컨테이너 앱을 사용하여 컨테이너 앱 환경을 만듭니다. 또한 Log Analytics 작업 영역을 배포하여 로그를 저장합니다.
Container Apps 사용하여 Dapr pub-sub servicebus 앱을 만듭니다. Azure 배포	Container Apps를 사용하여 Dapr pub-sub servicebus 앱을 만듭니다.
간단한 Azure Spring Apps 마이크로 서비스 애플리케이션 배포 Azure 배포	이 템플릿은 Azure에서 실행할 간단한 Azure Spring Apps 마이크로 서비스 애플리케이션을 배포합니다.
정적 웹 사이트 원본 사용하여 Front Door 표준/프리미엄 Azure 배포	이 템플릿은 Front Door 표준/프리미엄 및 Azure Storage 정적 웹 사이트를 만들고, 정적 웹 사이트로 트래픽을 보내도록 Front Door를 구성했습니다.
영구 스토리지 사용하여 주문형 SFTP 서버 만들기 Azure 배포	이 템플릿은 ACI(Azure Container Instance)를 사용하는 주문형 SFTP 서버를 보여 줍니다.
FinOps 허브 Azure 배포	이 템플릿은 Data Lake Storage 및 Data Factory를 포함하여 새 FinOps 허브 인스턴스를 만듭니다.
데이터 팩터리 복사 데이터 도구에 대한 Blob 만들기 빠른 시작 Azure 배포	이 템플릿은 Blob Storage를 만들고 데이터 복사 도구 빠른 시작에 대한 파일을 업로드합니다.
Azure Data Factory를 사용하여 더 많은 작업을 할 수 있습니다. 한 번의 클릭으로 Azure Data Factory Azure 배포	이 템플릿은 Azure Blob에서 다른 Azure Blob으로의 복사 작업에 대한 데이터 팩터리 파이프라인을 만듭니다.
Dev Box 서비스 구성 Azure 배포	이 템플릿은 Dev Box 빠른 시작 가이드(https://learn.microsoft.com/azure/dev-box/quickstart-create-dev-box)에 따라 모든 Dev Box 관리 리소스를 만듭니다. 만든 모든 리소스를 보거나 DevPortal.microsoft.com 직접 이동하여 첫 번째 Dev Box를 만들 수 있습니다.
Helm 사용하여 AKS(Azure Container Service) Azure 배포	Helm을 사용하여 AKS(Azure Container Service)를 사용하여 관리형 클러스터 배포
azure Machine Learning Sweep 작업 만들기 Azure 배포	이 템플릿은 하이퍼 매개 변수 튜닝을 위한 Azure Machine Learning Sweep 작업을 만듭니다.
Azure Firewall Premium 대한 테스트 환경 Azure 배포	이 템플릿은 IDPS(침입 검사 검색), TLS 검사 및 웹 범주 필터링과 같은 프리미엄 기능을 사용하여 Azure Firewall 프리미엄 및 방화벽 정책을 만듭니다.
ACR 작업 사용하여 컨테이너 이미지 빌드 Azure 배포	이 템플릿은 DeploymentScript를 사용하여 ACR을 오케스트레이션하여 코드 리포지토리에서 컨테이너 이미지를 빌드합니다.
컨테이너 이미지를 ACR 가져오기 Azure 배포	이 템플릿은 bicep 레지스트리에서 ACR 가져오기 모듈을 활용하여 공용 컨테이너 이미지를 Azure Container Registry로 가져옵니다.
인증서 사용하여 Application Gateway 만들기 Azure 배포	이 템플릿은 Key Vault 자체 서명된 인증서를 생성한 다음 Application Gateway에서 참조하는 방법을 보여 줍니다.
배포 스크립트를 사용하여 Azure AD 개체 만들기 Azure 배포	이 샘플에서는 배포 스크립트를 사용하여 Azure Active Directory에서 개체를 만듭니다.
출력 복잡한 입력 & 배포 스크립트 만들기 Azure 배포	이 템플릿은 Az CLI 배포 스크립트에 복잡한 입력, 출력 및 로그를 전달하고 읽기 위한 모범 사례를 보여 줍니다.
출력 복잡한 입력 & 배포 스크립트 만들기 Azure 배포	이 템플릿은 Az Powershell 배포 스크립트에 복잡한 입력, 출력 및 로그를 전달하고 읽는 모범 사례를 보여 줍니다.
ssh 키를 만들고 KeyVault 저장 Azure 배포	이 템플릿은 deploymentScript 리소스를 사용하여 ssh 키를 생성하고 keyVault에 프라이빗 키를 저장합니다.
정적 웹 사이트 배포 Azure 배포	백업 스토리지 계정을 사용하여 정적 웹 사이트 배포
원격 빌드 사용하여 Linux 사용 계획에서 함수 앱 Azure 배포	이 템플릿은 Linux 소비 계획에 함수 앱을 프로비전하고 코드 배포 중에 원격 빌드를 수행합니다. 앱은 요청 시 실행되며 실행당 요금이 청구되며, 대기 리소스 약정은 없습니다.
Azure Virtual Network Manager 및 샘플 VNET 만들기 Azure 배포	이 템플릿은 Azure Virtual Network Manager 및 샘플 가상 네트워크를 명명된 리소스 그룹에 배포합니다. 여러 연결 토폴로지 및 네트워크 그룹 멤버 자격 유형을 지원합니다.

Terraform(AzAPI 공급자) 리소스 정의

deploymentScripts 리소스 종류는 다음을 대상으로 하는 작업으로 배포할 수 있습니다.

리소스 그룹

각 API 버전에서 변경된 속성 목록은 변경 로그참조하세요.

리소스 형식

Microsoft.Resources/deploymentScripts 리소스를 만들려면 템플릿에 다음 Terraform을 추가합니다.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Resources/deploymentScripts@2023-08-01"
  name = "string"
  location = "string"
  parent_id = "string"
  tags = {
    tagName1 = "tagValue1"
    tagName2 = "tagValue2"
  }
  identity {
    type = "UserAssigned"
    identity_ids = []
  }
  // For remaining properties, see deploymentScripts objects
  body = jsonencode({
    kind = "string"
  })
}

deploymentScripts 개체

종류 속성을 설정하여 개체 유형을 지정합니다.

azureCLI경우 다음을 사용합니다.

  kind = "AzureCLI"
  properties = {
    arguments = "string"
    azCliVersion = "string"
    cleanupPreference = "string"
    containerSettings = {
      containerGroupName = "string"
      subnetIds = [
        {
          id = "string"
          name = "string"
        }
      ]
    }
    environmentVariables = [
      {
        name = "string"
        secureValue = "string"
        value = "string"
      }
    ]
    forceUpdateTag = "string"
    primaryScriptUri = "string"
    retentionInterval = "string"
    scriptContent = "string"
    storageAccountSettings = {
      storageAccountKey = "string"
      storageAccountName = "string"
    }
    supportingScriptUris = [
      "string"
    ]
    timeout = "string"
  }

azurePowerShell경우 다음을 사용합니다.

  kind = "AzurePowerShell"
  properties = {
    arguments = "string"
    azPowerShellVersion = "string"
    cleanupPreference = "string"
    containerSettings = {
      containerGroupName = "string"
      subnetIds = [
        {
          id = "string"
          name = "string"
        }
      ]
    }
    environmentVariables = [
      {
        name = "string"
        secureValue = "string"
        value = "string"
      }
    ]
    forceUpdateTag = "string"
    primaryScriptUri = "string"
    retentionInterval = "string"
    scriptContent = "string"
    storageAccountSettings = {
      storageAccountKey = "string"
      storageAccountName = "string"
    }
    supportingScriptUris = [
      "string"
    ]
    timeout = "string"
  }

속성 값

deploymentScripts

이름	묘사	값
형	리소스 종류	"Microsoft.Resources/deploymentScripts@2023-08-01"
이름	리소스 이름	string(필수)
위치	배포 스크립트에 대한 ACI 및 스토리지 계정의 위치입니다.	string(필수)
parent_id	리소스 그룹에 배포하려면 해당 리소스 그룹의 ID를 사용합니다.	string(필수)
태그	리소스 태그.	태그 이름 및 값의 사전입니다.
종류	개체 유형 설정	AzureCLI AzurePowerShell (필수)
신원	선택적 속성입니다. 이 배포 스크립트에 사용할 관리 ID입니다. 현재 사용자 할당 MSI만 지원됩니다.	ManagedServiceIdentity

AzureCliScript

이름	묘사	값
종류	스크립트의 형식입니다.	"AzureCLI"(필수)
속성	Azure CLI 스크립트 개체의 속성입니다.	AzureCliScriptProperties (필수)

AzureCliScriptProperties

이름	묘사	값
인수	스크립트에 전달할 명령줄 인수입니다. 인수는 공백으로 구분됩니다. ex: -Name blue* -Location '미국 서부 2'	문자열
azCliVersion	사용할 Azure CLI 모듈 버전입니다.	string(필수)
cleanupPreference	스크립트 실행이 터미널 상태에 있을 때의 정리 기본 설정입니다. 기본 설정은 'Always'입니다.	"항상" "OnExpiration" "OnSuccess"
containerSettings	컨테이너 설정.	ContainerConfiguration
environmentVariables	스크립트에 전달할 환경 변수입니다.	EnvironmentVariable[]
forceUpdateTag	스크립트 리소스가 변경되지 않은 경우에도 배포 스크립트를 강제로 실행하는 방법을 가져오거나 설정합니다. 현재 타임스탬프는 GUID일 수 있습니다.	문자열
primaryScriptUri	스크립트의 URI입니다. 외부 스크립트의 진입점입니다.	문자열
retentionInterval	서비스가 터미널 상태에 도달한 후 스크립트 리소스를 유지하는 간격입니다. 이 기간이 만료되면 리소스가 삭제됩니다. 기간은 ISO 8601 패턴을 기반으로 합니다(예: P1D는 1일을 의미).	string(필수)
scriptContent	스크립트 본문입니다.	문자열
storageAccountSettings	스토리지 계정 설정입니다.	StorageAccountConfiguration
supportingScriptUris	외부 스크립트에 대한 지원 파일입니다.	string[]
타임 아웃	ISO 8601 형식으로 지정된 최대 허용 스크립트 실행 시간입니다. 기본값은 P1D입니다.	문자열

ContainerConfiguration

이름	묘사	값
containerGroupName	컨테이너 그룹 이름을 지정하지 않으면 이름이 자동으로 생성됩니다. 'containerGroupName'을 지정하지 않으면 시스템이 Azure Policy를 비준수로 플래그를 지정할 수 있는 고유한 이름을 생성하도록 나타냅니다. 특정 명명 규칙을 예상하는 Azure Policy가 있거나 이름을 완전히 제어하려는 경우 'containerGroupName'을 사용합니다. 'containerGroupName' 속성은 1자에서 63자 사이여야 하고 소문자, 숫자 및 대시만 포함해야 하며 대시로 시작하거나 끝낼 수 없으며 연속 대시는 허용되지 않습니다. 'containerGroupName'을 지정하려면 속성에 다음 개체를 추가합니다. { "containerSettings": { "containerGroupName": "contoso-container" } }. 'containerGroupName'을 지정하지 않으려면 'containerSettings' 속성을 추가하지 마세요.	문자열 제약 조건: 최소 길이 = 1 최대 길이 = 63
subnetIds	컨테이너 그룹의 서브넷 리소스 ID입니다.	ContainerGroupSubnetId[]

ContainerGroupSubnetId

이름	묘사	값
아이디	서브넷의 리소스 ID입니다.	string(필수)
이름	서브넷의 이름입니다.	문자열

EnvironmentVariable

이름	묘사	값
이름	환경 변수의 이름입니다.	string(필수)
secureValue	보안 환경 변수의 값입니다.	문자열 제약 조건: 중요한 값입니다. 보안 매개 변수로 전달합니다.
값	환경 변수의 값입니다.	문자열

StorageAccountConfiguration

이름	묘사	값
storageAccountKey	스토리지 계정 액세스 키입니다.	문자열 제약 조건: 중요한 값입니다. 보안 매개 변수로 전달합니다.
storageAccountName	스토리지 계정 이름입니다.	문자열

AzurePowerShellScript

이름	묘사	값
종류	스크립트의 형식입니다.	"AzurePowerShell"(필수)
속성	Azure PowerShell 스크립트 개체의 속성입니다.	AzurePowerShellScriptProperties (필수)

AzurePowerShellScriptProperties

이름	묘사	값
인수	스크립트에 전달할 명령줄 인수입니다. 인수는 공백으로 구분됩니다. ex: -Name blue* -Location '미국 서부 2'	문자열
azPowerShellVersion	사용할 Azure PowerShell 모듈 버전입니다.	string(필수)
cleanupPreference	스크립트 실행이 터미널 상태에 있을 때의 정리 기본 설정입니다. 기본 설정은 'Always'입니다.	"항상" "OnExpiration" "OnSuccess"
containerSettings	컨테이너 설정.	ContainerConfiguration
environmentVariables	스크립트에 전달할 환경 변수입니다.	EnvironmentVariable[]
forceUpdateTag	스크립트 리소스가 변경되지 않은 경우에도 배포 스크립트를 강제로 실행하는 방법을 가져오거나 설정합니다. 현재 타임스탬프는 GUID일 수 있습니다.	문자열
primaryScriptUri	스크립트의 URI입니다. 외부 스크립트의 진입점입니다.	문자열
retentionInterval	서비스가 터미널 상태에 도달한 후 스크립트 리소스를 유지하는 간격입니다. 이 기간이 만료되면 리소스가 삭제됩니다. 기간은 ISO 8601 패턴을 기반으로 합니다(예: P1D는 1일을 의미).	string(필수)
scriptContent	스크립트 본문입니다.	문자열
storageAccountSettings	스토리지 계정 설정입니다.	StorageAccountConfiguration
supportingScriptUris	외부 스크립트에 대한 지원 파일입니다.	string[]
타임 아웃	ISO 8601 형식으로 지정된 최대 허용 스크립트 실행 시간입니다. 기본값은 P1D입니다.	문자열

ManagedServiceIdentity

이름	묘사	값
형	관리 ID의 형식입니다.	"UserAssigned"
identity_ids	리소스와 연결된 사용자 할당 관리 ID 목록입니다. 키는 관리 ID의 Azure 리소스 ID입니다.	사용자 ID ID의 배열입니다.

ManagedServiceIdentityUserAssignedIdentities

이름	묘사	값
{customized property}		UserAssignedIdentity

UserAssignedIdentity

이 개체에는 배포 중에 설정할 속성이 없습니다. 모든 속성은 ReadOnly입니다.

다음을 통해 공유

Microsoft.Resources deploymentScripts

Bicep 리소스 정의

발언

리소스 형식

deploymentScripts 개체

속성 값

deploymentScripts

AzureCliScript

AzureCliScriptProperties

ContainerConfiguration

ContainerGroupSubnetId

EnvironmentVariable

StorageAccountConfiguration

AzurePowerShellScript

AzurePowerShellScriptProperties

ManagedServiceIdentity

ManagedServiceIdentityUserAssignedIdentities

UserAssignedIdentity

빠른 시작 템플릿

ARM 템플릿 리소스 정의

발언

리소스 형식

deploymentScripts 개체

속성 값

deploymentScripts

AzureCliScript

AzureCliScriptProperties

ContainerConfiguration

ContainerGroupSubnetId

EnvironmentVariable

StorageAccountConfiguration

AzurePowerShellScript

AzurePowerShellScriptProperties

ManagedServiceIdentity

ManagedServiceIdentityUserAssignedIdentities

UserAssignedIdentity

빠른 시작 템플릿

Terraform(AzAPI 공급자) 리소스 정의

리소스 형식

deploymentScripts 개체

속성 값

deploymentScripts

AzureCliScript

AzureCliScriptProperties

ContainerConfiguration

ContainerGroupSubnetId

EnvironmentVariable

StorageAccountConfiguration

AzurePowerShellScript

AzurePowerShellScriptProperties

ManagedServiceIdentity

ManagedServiceIdentityUserAssignedIdentities

UserAssignedIdentity

피드백

추가 리소스