이 문서에서는 ARM 템플릿(Azure Resource Manager 템플릿)에서 리소스의 인스턴스를 두 개 이상 만드는 방법을 보여줍니다. 템플릿의 리소스 섹션에 복사 루프를 추가하여 배포할 리소스의 수를 동적으로 설정할 수 있습니다. 템플릿 구문을 반복하지 않아도 됩니다.
속성, 변수 및 출력과 함께 복사 루프를 사용할 수도 있습니다.
리소스가 배포되는지 지정해야 하는 경우 조건 요소를 참조하세요.
문법
copy 요소를 템플릿의 리소스 섹션에 추가하여 리소스의 여러 인스턴스를 배포합니다. copy 요소의 일반적인 형식은 다음과 같습니다.
"copy": {
"name": "<name-of-loop>",
"count": <number-of-iterations>,
"mode": "serial" <or> "parallel",
"batchSize": <number-to-deploy-serially>
}
name 속성은 루프를 식별하는 모든 값입니다. count 속성은 리소스 형식에 대해 원하는 반복 횟수를 지정합니다.
mode 및 batchSize 속성을 사용하여 리소스를 병렬로 배포할지 또는 순차적으로 배포할지를 지정합니다. 이러한 속성은 직렬 또는 병렬로 설명됩니다.
복사 제한
개수는 800을 초과하거나 음수일 수 없습니다. Azure CLI, PowerShell 또는 REST API의 최신 버전으로 템플릿을 배포하는 경우 0이 될 수 있습니다. 특히 다음을 사용해야 합니다.
- Azure PowerShell 2.6 이상.
- Azure CLI 2.0.74 이상.
- REST API 버전 2019-05-10 이상
- 연결된 배포 중 배포 리소스 종류에 대한 API 버전 2019-05-10 이상
이전 버전의 PowerShell, CLI 및 REST API는 개수에 대해 0을 지원하지 않습니다.
복사 루프와 함께 전체 모드 배포 를 사용하는 데 주의해야 합니다. 전체 모드를 사용하여 리소스 그룹에 다시 배포하면 복사 루프를 확인한 후 템플릿에 지정되지 않은 모든 리소스가 삭제됩니다.
리소스 반복
다음 예제에서는 매개 변수에 지정된 storageCount 스토리지 계정 수를 만듭니다.
{
"$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
"contentVersion": "1.0.0.0",
"parameters": {
"___location": {
"type": "string",
"defaultValue": "[resourceGroup().___location]"
},
"storageCount": {
"type": "int",
"defaultValue": 3
}
},
"resources": [
{
"copy": {
"name": "storagecopy",
"count": "[length(range(0, parameters('storageCount')))]"
},
"type": "Microsoft.Storage/storageAccounts",
"apiVersion": "2022-09-01",
"name": "[format('{0}storage{1}', range(0, parameters('storageCount'))[copyIndex()], uniqueString(resourceGroup().id))]",
"___location": "[parameters('___location')]",
"sku": {
"name": "Standard_LRS"
},
"kind": "Storage",
"properties": {}
}
]
}
각 리소스의 이름에는 copyIndex() 함수가 포함되어 있으며 이 함수는 루프에서 현재 반복을 반환합니다. copyIndex()는 0부터 시작합니다. 따라서 예제는 다음과 같습니다.
"name": "[format('storage{0}', copyIndex())]",
다음과 같은 이름을 만듭니다.
- storage0
- storage1
- storage2
인덱스 값을 오프셋하려면 copyIndex() 함수에 값을 전달하면 됩니다. 반복 횟수는 여전히 복사 요소에서 지정되지만 copyIndex 값은 지정된 값으로 오프셋됩니다. 따라서 예제는 다음과 같습니다.
"name": "[format('storage{0}', copyIndex(1))]",
다음과 같은 이름을 만듭니다.
- storage1
- storage2
- storage3
복사 작업은 배열의 각 요소를 반복할 수 있으므로 배열을 사용할 때 유용합니다. 배열의 length 함수를 사용하여 반복 횟수를 지정하고, copyIndex를 사용하여 배열의 현재 인덱스를 검색합니다.
다음 예제에서는 매개 변수에 제공된 각 이름에 대해 하나의 스토리지 계정을 만듭니다.
{
"$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
"contentVersion": "1.0.0.0",
"parameters": {
"storageNames": {
"type": "array",
"defaultValue": [
"contoso",
"fabrikam",
"coho"
]
},
"___location": {
"type": "string",
"defaultValue": "[resourceGroup().___location]"
}
},
"resources": [
{
"copy": {
"name": "storagecopy",
"count": "[length(parameters('storageNames'))]"
},
"type": "Microsoft.Storage/storageAccounts",
"apiVersion": "2022-09-01",
"name": "[format('{0}{1}', parameters('storageNames')[copyIndex()], uniqueString(resourceGroup().id))]",
"___location": "[parameters('___location')]",
"sku": {
"name": "Standard_LRS"
},
"kind": "Storage",
"properties": {}
}
]
}
배포된 리소스에서 값을 반환하려면 출력 섹션의 복사본을 사용할 수 있습니다.
기호 이름 사용
기호 이름은 리소스 복사 루프에 할당됩니다. 루프 인덱스는 0부터 시작합니다. 다음 예제 myStorages[1] 에서는 리소스 루프의 두 번째 리소스를 참조합니다.
{
"$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
"languageVersion": "2.0",
"contentVersion": "1.0.0.0",
"parameters": {
"___location": {
"type": "string",
"defaultValue": "[resourceGroup().___location]"
},
"storageCount": {
"type": "int",
"defaultValue": 2
}
},
"resources": {
"myStorages": {
"type": "Microsoft.Storage/storageAccounts",
"apiVersion": "2022-09-01",
"name": "[format('{0}storage{1}', copyIndex(), uniqueString(resourceGroup().id))]",
"___location": "[parameters('___location')]",
"sku": {
"name": "Standard_LRS"
},
"kind": "Storage",
"properties": {},
"copy": {
"name": "storagecopy",
"count": "[parameters('storageCount')]"
}
}
},
"outputs": {
"storageEndpoint":{
"type": "object",
"value": "[reference('myStorages[1]').primaryEndpoints]"
}
}
}
인덱스가 런타임 값인 경우 참조 형식을 직접 지정합니다. 다음은 그 예입니다.
"outputs": {
"storageEndpoint":{
"type": "object",
"value": "[reference(format('myStorages[{0}]', variables('runtimeIndex'))).primaryEndpoints]"
}
}
dependsOn 배열에서 기호 이름을 사용할 수 있습니다. 기호화된 이름이 복사 루프에 해당하는 경우 루프의 모든 리소스가 종속성으로 추가됩니다. 자세한 내용은 루프의 리소스에 의존을 참조하세요.
직렬 또는 병렬
기본적으로 Resource Manager는 병렬로 리소스를 만듭니다. 템플릿의 총 리소스 한도인 800개 외에는 병렬로 배포된 리소스 수에 제한이 적용되지 않습니다. 생성되는 순서는 정해져 있지 않습니다.
그러나 리소스가 순서대로 배포되도록 지정할 수 있습니다. 예를 들어 프로덕션 환경을 업데이트할 때 한 번에 특정 숫자만 업데이트되도록 업데이트를 엇갈릴 수 있습니다.
리소스의 여러 인스턴스를 직렬로 배포하려면 mode를 직렬로 설정하고 batchSize를 한 번에 배포할 인스턴스 수로 설정합니다. 직렬 모드를 사용하면 Resource Manager는 이전 일괄 처리가 완료될 때까지 하나의 일괄 처리를 시작하지 않도록 루프의 이전 인스턴스에 대한 종속성을 만듭니다.
batchSize 값은 copy 요소의 값을 count 초과할 수 없습니다.
{
"$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
"contentVersion": "1.0.0.0",
"parameters": {
"___location": {
"type": "string",
"defaultValue": "[resourceGroup().___location]"
}
},
"resources": [
{
"copy": {
"name": "storagecopy",
"count": 4,
"mode": "serial",
"batchSize": 2
},
"type": "Microsoft.Storage/storageAccounts",
"apiVersion": "2022-09-01",
"name": "[format('{0}storage{1}', range(0, 4)[copyIndex()], uniqueString(resourceGroup().id))]",
"___location": "[parameters('___location')]",
"sku": {
"name": "Standard_LRS"
},
"kind": "Storage",
"properties": {}
}
]
}
mode 속성은 기본값인 병렬도 수용합니다.
자식 리소스에 대한 반복
자식 리소스에 대해 복사 루프를 사용할 수 없습니다. 일반적으로 다른 리소스 내에 중첩된 것으로 정의된 여러 인스턴스를 만들려면 대신 해당 리소스를 최상위 리소스로 만들어야 합니다. 형식 및 이름 속성을 통해 부모 리소스와의 관계를 정의합니다.
예를 들어 일반적으로 데이터 팩터리 내에서 데이터 세트를 자식 리소스로 정의한다고 가정합니다.
{
"resources": [
{
"type": "Microsoft.DataFactory/factories",
"name": "exampleDataFactory",
...
"resources": [
{
"type": "datasets",
"name": "exampleDataSet",
"dependsOn": [
"exampleDataFactory"
],
...
}
]
...
}
]
}
둘 이상의 데이터 세트를 만들려면 데이터 팩터리 외부로 이동합니다. 데이터 세트는 데이터 팩터리와 같은 수준에 있어야 하지만 여전히 데이터 팩터리의 자식 리소스입니다. 형식 및 이름 속성은 데이터 세트와 데이터 팩터리 간의 관계를 유지합니다. 형식을 템플릿의 위치에서 더 이상 유추할 수 없으므로 다음 형식 {resource-provider-namespace}/{parent-resource-type}/{child-resource-type}으로 정규화된 형식을 제공해야 합니다.
데이터 팩터리의 인스턴스와 부모/자식 관계를 설정하려면 부모 리소스 이름을 포함하는 데이터 세트의 이름을 제공합니다. {parent-resource-name}/{child-resource-name} 형식을 사용합니다.
다음 예제에서는 구현을 보여줍니다.
"resources": [
{
"type": "Microsoft.DataFactory/factories",
"name": "exampleDataFactory",
...
},
{
"type": "Microsoft.DataFactory/factories/datasets",
"name": "[format('exampleDataFactory/exampleDataSet{0}', copyIndex())]",
"dependsOn": [
"exampleDataFactory"
],
"copy": {
"name": "datasetcopy",
"count": "3"
},
...
}]
예제 템플릿
다음 예제에서는 여러 리소스 또는 속성 인스턴스를 만들기 위한 일반적인 시나리오를 보여 줍니다.
| 템플릿 | 설명 |
|---|---|
| 스토리지 복사 | 이름의 인덱스 번호를 사용하여 여러 스토리지 계정을 배포합니다. |
| 스토리지 직렬 복사 | 여러 스토리지 계정을 한 번에 하나씩 배포합니다. 이름에는 인덱스 번호가 포함됩니다. |
| 배열을 사용하여 스토리지 복사 | 여러 스토리지 계정을 배포합니다. 이름에는 배열의 값이 포함됩니다. |
| 리소스 그룹 복사 | 여러 리소스 그룹을 배포합니다. |
다음 단계
- 복사 루프에서 만든 리소스에 대한 종속성을 설정하려면 ARM 템플릿에서 리소스를 배포하는 순서를 정의하는 방법을 참조하세요.
- 자습서를 진행하려면 ARM 템플릿을 사용하여 여러 리소스 인스턴스를 만드는 방법을 참조하세요.
- 리소스 복사를 다루는 Microsoft Learn 모듈의 경우 고급 ARM 템플릿 기능을 사용하여 복잡한 클라우드 배포를 관리하는 방법을 참조하세요.
- 복사 루프의 다른 용도는 다음을 참조하세요.
- 중첩된 템플릿에서 복사를 사용하는 방법에 대한 자세한 내용은 복사를 사용하는 방법을 참조하세요.