Поделиться через


Контейнер Microsoft.ContainerInstanceGroups 2021-07-01

Определение ресурсов Bicep

Тип ресурса containerGroups можно развернуть с помощью операций, предназначенных для следующих операций:

Список измененных свойств в каждой версии API см. в журнала изменений.

Формат ресурса

Чтобы создать ресурс Microsoft.ContainerInstance/containerGroups, добавьте следующий Bicep в шаблон.

resource symbolicname 'Microsoft.ContainerInstance/containerGroups@2021-07-01' = {
  identity: {
    type: 'string'
    userAssignedIdentities: {
      {customized property}: {}
    }
  }
  location: 'string'
  name: 'string'
  properties: {
    containers: [
      {
        name: 'string'
        properties: {
          command: [
            'string'
          ]
          environmentVariables: [
            {
              name: 'string'
              secureValue: 'string'
              value: 'string'
            }
          ]
          image: 'string'
          livenessProbe: {
            exec: {
              command: [
                'string'
              ]
            }
            failureThreshold: int
            httpGet: {
              httpHeaders: [
                {
                  name: 'string'
                  value: 'string'
                }
              ]
              path: 'string'
              port: int
              scheme: 'string'
            }
            initialDelaySeconds: int
            periodSeconds: int
            successThreshold: int
            timeoutSeconds: int
          }
          ports: [
            {
              port: int
              protocol: 'string'
            }
          ]
          readinessProbe: {
            exec: {
              command: [
                'string'
              ]
            }
            failureThreshold: int
            httpGet: {
              httpHeaders: [
                {
                  name: 'string'
                  value: 'string'
                }
              ]
              path: 'string'
              port: int
              scheme: 'string'
            }
            initialDelaySeconds: int
            periodSeconds: int
            successThreshold: int
            timeoutSeconds: int
          }
          resources: {
            limits: {
              cpu: int
              gpu: {
                count: int
                sku: 'string'
              }
              memoryInGB: int
            }
            requests: {
              cpu: int
              gpu: {
                count: int
                sku: 'string'
              }
              memoryInGB: int
            }
          }
          volumeMounts: [
            {
              mountPath: 'string'
              name: 'string'
              readOnly: bool
            }
          ]
        }
      }
    ]
    diagnostics: {
      logAnalytics: {
        logType: 'string'
        metadata: {
          {customized property}: 'string'
        }
        workspaceId: 'string'
        workspaceKey: 'string'
        workspaceResourceId: 'string'
      }
    }
    dnsConfig: {
      nameServers: [
        'string'
      ]
      options: 'string'
      searchDomains: 'string'
    }
    encryptionProperties: {
      keyName: 'string'
      keyVersion: 'string'
      vaultBaseUrl: 'string'
    }
    imageRegistryCredentials: [
      {
        identity: 'string'
        identityUrl: 'string'
        password: 'string'
        server: 'string'
        username: 'string'
      }
    ]
    initContainers: [
      {
        name: 'string'
        properties: {
          command: [
            'string'
          ]
          environmentVariables: [
            {
              name: 'string'
              secureValue: 'string'
              value: 'string'
            }
          ]
          image: 'string'
          volumeMounts: [
            {
              mountPath: 'string'
              name: 'string'
              readOnly: bool
            }
          ]
        }
      }
    ]
    ipAddress: {
      dnsNameLabel: 'string'
      ip: 'string'
      ports: [
        {
          port: int
          protocol: 'string'
        }
      ]
      type: 'string'
    }
    osType: 'string'
    restartPolicy: 'string'
    sku: 'string'
    subnetIds: [
      {
        id: 'string'
        name: 'string'
      }
    ]
    volumes: [
      {
        azureFile: {
          readOnly: bool
          shareName: 'string'
          storageAccountKey: 'string'
          storageAccountName: 'string'
        }
        emptyDir: any(...)
        gitRepo: {
          directory: 'string'
          repository: 'string'
          revision: 'string'
        }
        name: 'string'
        secret: {
          {customized property}: 'string'
        }
      }
    ]
  }
  tags: {
    {customized property}: 'string'
  }
}

Значения свойств

Microsoft.ContainerInstance/containerGroups

Имя Описание Ценность
тождество Удостоверение группы контейнеров, если настроено. containerGroupIdentity
местоположение Расположение ресурса. струна
имя Имя ресурса строка (обязательно)
свойства Свойства группы контейнеров ContainerGroupProperties (обязательно)
Теги Теги ресурсов Словарь имен и значений тегов. См. теги в шаблонах

AzureFileVolume

Имя Описание Ценность
Только для чтения Флаг, указывающий, подключен ли общий файл Azure в качестве тома только для чтения. булевая переменная (bool)
shareName Имя общей папки Azure, подключенной в качестве тома. строка (обязательно)
ключХранилищаАккаунта Ключ доступа к учетной записи хранения, используемый для доступа к общей папке Azure. струна
storageAccountName Имя учетной записи хранения, содержащей общую папку Azure. строка (обязательно)

Компоненты10Wh5UdSchemasContainergroupidentityPropertiesUserassignedidentitiesAdditionalproperties

Имя Описание Ценность

Контейнер

Имя Описание Ценность
имя Имя экземпляра контейнера, предоставленное пользователем. строка (обязательно)
свойства Свойства экземпляра контейнера. ContainerProperties (обязательно)

ContainerExec (ContainerExec)

Имя Описание Ценность
команда Команды, выполняемые в контейнере. строка[]

ContainerGroupDiagnostics

Имя Описание Ценность
LogAnalytics Сведения о log analytics группы контейнеров. LogAnalytics

ContainerGroupIdentity

Имя Описание Ценность
тип Тип удостоверения, используемого для группы контейнеров. Тип SystemAssigned, UserAssigned включает как неявное созданное удостоверение, так и набор назначенных пользователем удостоверений. Тип None удаляет все удостоверения из группы контейнеров. "Нет"
SystemAssigned
SystemAssigned, UserAssigned
UserAssigned
ИдентичностиНазначенныеПользователем Список удостоверений пользователей, связанных с группой контейнеров. Ссылки на ключ словаря удостоверений пользователя будут идентификаторами ресурсов ARM в форме: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}". ContainerGroupIdentityUserAssignedIdentities

ContainerGroupIdentityUserAssignedIdentities

Имя Описание Ценность

ContainerGroupProperties (Свойства контейнерной группы)

Имя Описание Ценность
Контейнеры Контейнеры в группе контейнеров. контейнер[] (обязательно)
диагностика Диагностические сведения для группы контейнеров. ContainerGroupDiagnostics
dnsConfig Сведения о конфигурации DNS для группы контейнеров. Конфигурация DNS
encryptionProperties Свойства шифрования для группы контейнеров. Свойства шифрования
Учетные данные imageRegistryCredentials Учетные данные реестра образов, из которых создается группа контейнеров. Учетные данные ImageRegistry[]
initContainers Контейнеры инициализации для группы контейнеров. InitContainerDefinition[]
IP-адрес Тип IP-адреса группы контейнеров. IpAddress
Тип ОС Тип операционной системы, необходимый контейнерам в группе контейнеров. Linux
"Windows" (обязательно)
политика перезапуска Перезапустите политику для всех контейнеров в группе контейнеров.
- Always always restart
- OnFailure перезапуск при сбое
- Never никогда не перезапускать
"Always"
"Никогда"
«Неудача»
SKU Номер SKU для группы контейнеров. "Выделенный"
"Стандартный"
SubnetIds Идентификаторы ресурсов подсети для группы контейнеров. ContainerGroupSubnetId[]
Объемы Список томов, которые могут быть подключены контейнерами в этой группе контейнеров. тома[]

ContainerGroupSubnetId (ContainerGroupSubnetId)

Имя Описание Ценность
идентификатор Идентификатор ресурса виртуальной сети и подсети. строка (обязательно)
имя Понятное имя подсети. струна

ContainerHttpGet

Имя Описание Ценность
HTTP-заголовки Заголовки HTTP. HttpHeader[]
путь Путь к пробе. струна
порт Номер порта для проверки. int (обязательно)
схема Схема. "http"
Https

КонтейнерПорт

Имя Описание Ценность
порт Номер порта, предоставляемый в группе контейнеров. int (обязательно)
протокол Протокол, связанный с портом. "TCP"
"UDP"

КонтейнерПроб

Имя Описание Ценность
выполнить Команда выполнения для проверки ContainerExec (ContainerExec)
Порог неудачи Порог сбоя. инт
httpGet Параметры Http Get для проверки ContainerHttpGet
initialDelaySeconds Начальная задержка секунд. инт
период в секундах Период секунд. инт
Порог успеха Порог успешности. инт
timeoutSeconds Время ожидания секунд. инт

СвойстваКонтейнера

Имя Описание Ценность
команда Команды, выполняемые в экземпляре контейнера в форме exec. строка[]
переменные окружения Переменные среды, заданные в экземпляре контейнера. Переменная среды[]
образ Имя образа, используемого для создания экземпляра контейнера. строка (обязательно)
livenessProbe Проба активности. КонтейнерПроб
Порты Предоставленные порты в экземпляре контейнера. КонтейнерПорт[]
готовностьProbe Проба готовности. КонтейнерПроб
ресурсы Требования к ресурсам экземпляра контейнера. ResourceRequirements (обязательно)
volumeMounts Том подключается к экземпляру контейнера. VolumeMount[]

Конфигурация DNS

Имя Описание Ценность
Серверы имен DNS-серверы для группы контейнеров. string[] (обязательно)
Параметры Параметры DNS для группы контейнеров. струна
searchDomains Домены поиска DNS для поиска имени узла в группе контейнеров. струна

Свойства шифрования

Имя Описание Ценность
keyName Имя ключа шифрования. строка (обязательно)
keyVersion Версия ключа шифрования. строка (обязательно)
vaultBaseUrl Базовый URL-адрес keyvault. строка (обязательно)

Переменная среды

Имя Описание Ценность
имя Имя переменной среды. строка (обязательно)
Функция secureValue Значение переменной безопасной среды. струна
ценность Значение переменной среды. струна

GitRepoVolume (GitRepoVolume)

Имя Описание Ценность
каталог Имя целевого каталога. Не должно содержать или начинаться с '.'. Если задано значение ".", каталог томов будет репозиторием Git. В противном случае, если задано, том будет содержать репозиторий Git в подкаталоге с заданным именем. струна
хранилище URL-адрес репозитория строка (обязательно)
пересмотр Зафиксировать хэш для указанной редакции. струна

Ресурс Gpu

Имя Описание Ценность
считать Количество ресурсов GPU. int (обязательно)
SKU Номер SKU ресурса GPU. "K80"
"P100"
"V100" (обязательно)

HttpHeader

Имя Описание Ценность
имя Имя заголовка. струна
ценность Значение заголовка. струна

Учетные данные ImageRegistryCredential

Имя Описание Ценность
тождество Удостоверение частного реестра. струна
identityUrl URL-адрес удостоверения для частного реестра. струна
пароль Пароль для частного реестра. струна
сервер Сервер реестра образов Docker без протокола, например http и https. строка (обязательно)
имя пользователя Имя пользователя для частного реестра. строка (обязательно)

InitContainerDefinition (Определение контейнера)

Имя Описание Ценность
имя Имя контейнера инициализации. строка (обязательно)
свойства Свойства контейнера инициализации. InitContainerPropertiesDefinition (обязательно)

Определение InitContainerProperties

Имя Описание Ценность
команда Команда, выполняемая в контейнере init в форме exec. строка[]
переменные окружения Переменные среды, заданные в контейнере init. Переменная среды[]
образ Изображение контейнера инициализации. струна
volumeMounts Том подключается к контейнеру init. VolumeMount[]

IP-адрес

Имя Описание Ценность
dnsNameLabel Метка DNS-имени для IP-адреса. струна
протокол IP IP-адрес, предоставляемый общедоступному Интернету. струна
Порты Список портов, предоставляемых в группе контейнеров. порт[] (обязательно)
тип Указывает, предоставляется ли IP-адрес общедоступному Интернету или частной виртуальной сети. "Private"
"Public" (обязательно)

LogAnalytics

Имя Описание Ценность
logType Используемый тип журнала. ContainerInsights
ContainerInstanceLogs
метаданные Метаданные для log analytics. LogAnalyticsМетаданные
WorkspaceId Идентификатор рабочей области для log analytics строка (обязательно)
workspaceKey Ключ рабочей области для log analytics строка (обязательно)
Идентификатор ресурса рабочего пространства Идентификатор ресурса рабочей области для log analytics струна

LogAnalyticsМетаданные

Имя Описание Ценность

Порт

Имя Описание Ценность
порт Номер порта. int (обязательно)
протокол Протокол, связанный с портом. "TCP"
"UDP"

Лимиты ресурсов

Имя Описание Ценность
ЦПУ Ограничение ЦП этого экземпляра контейнера. инт
Графический процессор Ограничение GPU этого экземпляра контейнера. Ресурс Gpu
памятьInGB Ограничение памяти в ГБ этого экземпляра контейнера. инт

Запросы на ресурсы

Имя Описание Ценность
ЦПУ Запрос ЦП этого экземпляра контейнера. int (обязательно)
Графический процессор Запрос GPU этого экземпляра контейнера. Ресурс Gpu
памятьInGB Запрос памяти в ГБ этого экземпляра контейнера. int (обязательно)

Требования к ресурсам

Имя Описание Ценность
Ограничения Ограничения ресурсов этого экземпляра контейнера. Лимиты ресурсов
Запросы Запросы ресурсов этого экземпляра контейнера. ResourceRequests (обязательно)

Теги ресурса

Имя Описание Ценность

Секретный объем

Имя Описание Ценность

Том

Имя Описание Ценность
azureFile Том файла Azure. AzureFileVolume
пустая директория Пустой том каталога. любой
gitRepo Том репозитория Git. GitRepoVolume (GitRepoVolume)
имя Имя тома. строка (обязательно)
секрет Том секрета. Секретный объем

Крепление VolumeMount

Имя Описание Ценность
mountPath Путь в контейнере, в котором должен быть подключен том. Не должен содержать двоеточие (:). строка (обязательно)
имя Имя подключения тома. строка (обязательно)
Только для чтения Флаг, указывающий, доступен ли подключение тома только для чтения. булевая переменная (bool)

Примеры использования

Проверенные модули Azure

Следующие проверенные модули Azure можно использовать для развертывания этого типа ресурсов.

Модуль Описание
экземпляра контейнера Модуль ресурсов AVM для экземпляра контейнера

Примеры быстрого запуска Azure

Следующие шаблоны быстрого запуска Azure содержат примеры Bicep для развертывания этого типа ресурса.

Bicep-файл Описание
экземпляры контейнеров Azure — BC с SQL Server и IIS Разверните один контейнер Windows с полностью автономной автономной средой Microsoft Dynamics 365 Business Central в экземплярах контейнеров Azure.
экземпляры контейнеров Azure — контейнер с секретами Разверните контейнер Linux с секретным томом с помощью экземпляров контейнеров Azure.
экземпляры контейнеров Azure — контейнер Linux с общедоступным IP- Разверните один контейнер Linux, доступный через общедоступный IP-адрес с помощью экземпляров контейнеров Azure.
экземпляры контейнеров Azure — виртуальная сеть Разверните экземпляр контейнера в виртуальной сети Azure.
создание сайта WordPress Этот шаблон создает сайт WordPress в экземпляре контейнера
Создание сервера SFTP по запросу с постоянным хранилищем Этот шаблон демонстрирует сервер SFTP по запросу с помощью экземпляра контейнера Azure (ACI).
создание шлюза приложений с помощью сертификатов В этом шаблоне показано, как создавать самозаверяющие сертификаты Key Vault, а затем ссылаться на нее из шлюза приложений.
Front Door Standard/Premium с экземплярами контейнеров Azure Этот шаблон создает Front Door Standard/Premium с группой контейнеров.
Front Door с экземплярами контейнеров и шлюза приложений Этот шаблон создает Front Door Standard/Premium с группой контейнеров и шлюзом приложений.
группа доступности SQL Server в AKS При этом создается новый кластер AKS, а затем развертываются группы доступности SQL Server с помощью пакета CNAB, развернутого с помощью Duffle и ACI.

Определение ресурса шаблона ARM

Тип ресурса containerGroups можно развернуть с помощью операций, предназначенных для следующих операций:

Список измененных свойств в каждой версии API см. в журнала изменений.

Формат ресурса

Чтобы создать ресурс Microsoft.ContainerInstance/containerGroups, добавьте следующий код JSON в шаблон.

{
  "type": "Microsoft.ContainerInstance/containerGroups",
  "apiVersion": "2021-07-01",
  "name": "string",
  "identity": {
    "type": "string",
    "userAssignedIdentities": {
      "{customized property}": {
      }
    }
  },
  "location": "string",
  "properties": {
    "containers": [
      {
        "name": "string",
        "properties": {
          "command": [ "string" ],
          "environmentVariables": [
            {
              "name": "string",
              "secureValue": "string",
              "value": "string"
            }
          ],
          "image": "string",
          "livenessProbe": {
            "exec": {
              "command": [ "string" ]
            },
            "failureThreshold": "int",
            "httpGet": {
              "httpHeaders": [
                {
                  "name": "string",
                  "value": "string"
                }
              ],
              "path": "string",
              "port": "int",
              "scheme": "string"
            },
            "initialDelaySeconds": "int",
            "periodSeconds": "int",
            "successThreshold": "int",
            "timeoutSeconds": "int"
          },
          "ports": [
            {
              "port": "int",
              "protocol": "string"
            }
          ],
          "readinessProbe": {
            "exec": {
              "command": [ "string" ]
            },
            "failureThreshold": "int",
            "httpGet": {
              "httpHeaders": [
                {
                  "name": "string",
                  "value": "string"
                }
              ],
              "path": "string",
              "port": "int",
              "scheme": "string"
            },
            "initialDelaySeconds": "int",
            "periodSeconds": "int",
            "successThreshold": "int",
            "timeoutSeconds": "int"
          },
          "resources": {
            "limits": {
              "cpu": "int",
              "gpu": {
                "count": "int",
                "sku": "string"
              },
              "memoryInGB": "int"
            },
            "requests": {
              "cpu": "int",
              "gpu": {
                "count": "int",
                "sku": "string"
              },
              "memoryInGB": "int"
            }
          },
          "volumeMounts": [
            {
              "mountPath": "string",
              "name": "string",
              "readOnly": "bool"
            }
          ]
        }
      }
    ],
    "diagnostics": {
      "logAnalytics": {
        "logType": "string",
        "metadata": {
          "{customized property}": "string"
        },
        "workspaceId": "string",
        "workspaceKey": "string",
        "workspaceResourceId": "string"
      }
    },
    "dnsConfig": {
      "nameServers": [ "string" ],
      "options": "string",
      "searchDomains": "string"
    },
    "encryptionProperties": {
      "keyName": "string",
      "keyVersion": "string",
      "vaultBaseUrl": "string"
    },
    "imageRegistryCredentials": [
      {
        "identity": "string",
        "identityUrl": "string",
        "password": "string",
        "server": "string",
        "username": "string"
      }
    ],
    "initContainers": [
      {
        "name": "string",
        "properties": {
          "command": [ "string" ],
          "environmentVariables": [
            {
              "name": "string",
              "secureValue": "string",
              "value": "string"
            }
          ],
          "image": "string",
          "volumeMounts": [
            {
              "mountPath": "string",
              "name": "string",
              "readOnly": "bool"
            }
          ]
        }
      }
    ],
    "ipAddress": {
      "dnsNameLabel": "string",
      "ip": "string",
      "ports": [
        {
          "port": "int",
          "protocol": "string"
        }
      ],
      "type": "string"
    },
    "osType": "string",
    "restartPolicy": "string",
    "sku": "string",
    "subnetIds": [
      {
        "id": "string",
        "name": "string"
      }
    ],
    "volumes": [
      {
        "azureFile": {
          "readOnly": "bool",
          "shareName": "string",
          "storageAccountKey": "string",
          "storageAccountName": "string"
        },
        "emptyDir": {},
        "gitRepo": {
          "directory": "string",
          "repository": "string",
          "revision": "string"
        },
        "name": "string",
        "secret": {
          "{customized property}": "string"
        }
      }
    ]
  },
  "tags": {
    "{customized property}": "string"
  }
}

Значения свойств

Microsoft.ContainerInstance/containerGroups

Имя Описание Ценность
apiVersion Версия API '2021-07-01'
тождество Удостоверение группы контейнеров, если настроено. containerGroupIdentity
местоположение Расположение ресурса. струна
имя Имя ресурса строка (обязательно)
свойства Свойства группы контейнеров ContainerGroupProperties (обязательно)
Теги Теги ресурсов Словарь имен и значений тегов. См. теги в шаблонах
тип Тип ресурса "Microsoft.ContainerInstance/containerGroups"

AzureFileVolume

Имя Описание Ценность
Только для чтения Флаг, указывающий, подключен ли общий файл Azure в качестве тома только для чтения. булевая переменная (bool)
shareName Имя общей папки Azure, подключенной в качестве тома. строка (обязательно)
ключХранилищаАккаунта Ключ доступа к учетной записи хранения, используемый для доступа к общей папке Azure. струна
storageAccountName Имя учетной записи хранения, содержащей общую папку Azure. строка (обязательно)

Компоненты10Wh5UdSchemasContainergroupidentityPropertiesUserassignedidentitiesAdditionalproperties

Имя Описание Ценность

Контейнер

Имя Описание Ценность
имя Имя экземпляра контейнера, предоставленное пользователем. строка (обязательно)
свойства Свойства экземпляра контейнера. ContainerProperties (обязательно)

ContainerExec (ContainerExec)

Имя Описание Ценность
команда Команды, выполняемые в контейнере. строка[]

ContainerGroupDiagnostics

Имя Описание Ценность
LogAnalytics Сведения о log analytics группы контейнеров. LogAnalytics

ContainerGroupIdentity

Имя Описание Ценность
тип Тип удостоверения, используемого для группы контейнеров. Тип SystemAssigned, UserAssigned включает как неявное созданное удостоверение, так и набор назначенных пользователем удостоверений. Тип None удаляет все удостоверения из группы контейнеров. "Нет"
SystemAssigned
SystemAssigned, UserAssigned
UserAssigned
ИдентичностиНазначенныеПользователем Список удостоверений пользователей, связанных с группой контейнеров. Ссылки на ключ словаря удостоверений пользователя будут идентификаторами ресурсов ARM в форме: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}". ContainerGroupIdentityUserAssignedIdentities

ContainerGroupIdentityUserAssignedIdentities

Имя Описание Ценность

ContainerGroupProperties (Свойства контейнерной группы)

Имя Описание Ценность
Контейнеры Контейнеры в группе контейнеров. контейнер[] (обязательно)
диагностика Диагностические сведения для группы контейнеров. ContainerGroupDiagnostics
dnsConfig Сведения о конфигурации DNS для группы контейнеров. Конфигурация DNS
encryptionProperties Свойства шифрования для группы контейнеров. Свойства шифрования
Учетные данные imageRegistryCredentials Учетные данные реестра образов, из которых создается группа контейнеров. Учетные данные ImageRegistry[]
initContainers Контейнеры инициализации для группы контейнеров. InitContainerDefinition[]
IP-адрес Тип IP-адреса группы контейнеров. IpAddress
Тип ОС Тип операционной системы, необходимый контейнерам в группе контейнеров. Linux
"Windows" (обязательно)
политика перезапуска Перезапустите политику для всех контейнеров в группе контейнеров.
- Always always restart
- OnFailure перезапуск при сбое
- Never никогда не перезапускать
"Always"
"Никогда"
«Неудача»
SKU Номер SKU для группы контейнеров. "Выделенный"
"Стандартный"
SubnetIds Идентификаторы ресурсов подсети для группы контейнеров. ContainerGroupSubnetId[]
Объемы Список томов, которые могут быть подключены контейнерами в этой группе контейнеров. тома[]

ContainerGroupSubnetId (ContainerGroupSubnetId)

Имя Описание Ценность
идентификатор Идентификатор ресурса виртуальной сети и подсети. строка (обязательно)
имя Понятное имя подсети. струна

ContainerHttpGet

Имя Описание Ценность
HTTP-заголовки Заголовки HTTP. HttpHeader[]
путь Путь к пробе. струна
порт Номер порта для проверки. int (обязательно)
схема Схема. "http"
Https

КонтейнерПорт

Имя Описание Ценность
порт Номер порта, предоставляемый в группе контейнеров. int (обязательно)
протокол Протокол, связанный с портом. "TCP"
"UDP"

КонтейнерПроб

Имя Описание Ценность
выполнить Команда выполнения для проверки ContainerExec (ContainerExec)
Порог неудачи Порог сбоя. инт
httpGet Параметры Http Get для проверки ContainerHttpGet
initialDelaySeconds Начальная задержка секунд. инт
период в секундах Период секунд. инт
Порог успеха Порог успешности. инт
timeoutSeconds Время ожидания секунд. инт

СвойстваКонтейнера

Имя Описание Ценность
команда Команды, выполняемые в экземпляре контейнера в форме exec. строка[]
переменные окружения Переменные среды, заданные в экземпляре контейнера. Переменная среды[]
образ Имя образа, используемого для создания экземпляра контейнера. строка (обязательно)
livenessProbe Проба активности. КонтейнерПроб
Порты Предоставленные порты в экземпляре контейнера. КонтейнерПорт[]
готовностьProbe Проба готовности. КонтейнерПроб
ресурсы Требования к ресурсам экземпляра контейнера. ResourceRequirements (обязательно)
volumeMounts Том подключается к экземпляру контейнера. VolumeMount[]

Конфигурация DNS

Имя Описание Ценность
Серверы имен DNS-серверы для группы контейнеров. string[] (обязательно)
Параметры Параметры DNS для группы контейнеров. струна
searchDomains Домены поиска DNS для поиска имени узла в группе контейнеров. струна

Свойства шифрования

Имя Описание Ценность
keyName Имя ключа шифрования. строка (обязательно)
keyVersion Версия ключа шифрования. строка (обязательно)
vaultBaseUrl Базовый URL-адрес keyvault. строка (обязательно)

Переменная среды

Имя Описание Ценность
имя Имя переменной среды. строка (обязательно)
Функция secureValue Значение переменной безопасной среды. струна
ценность Значение переменной среды. струна

GitRepoVolume (GitRepoVolume)

Имя Описание Ценность
каталог Имя целевого каталога. Не должно содержать или начинаться с '.'. Если задано значение ".", каталог томов будет репозиторием Git. В противном случае, если задано, том будет содержать репозиторий Git в подкаталоге с заданным именем. струна
хранилище URL-адрес репозитория строка (обязательно)
пересмотр Зафиксировать хэш для указанной редакции. струна

Ресурс Gpu

Имя Описание Ценность
считать Количество ресурсов GPU. int (обязательно)
SKU Номер SKU ресурса GPU. "K80"
"P100"
"V100" (обязательно)

HttpHeader

Имя Описание Ценность
имя Имя заголовка. струна
ценность Значение заголовка. струна

Учетные данные ImageRegistryCredential

Имя Описание Ценность
тождество Удостоверение частного реестра. струна
identityUrl URL-адрес удостоверения для частного реестра. струна
пароль Пароль для частного реестра. струна
сервер Сервер реестра образов Docker без протокола, например http и https. строка (обязательно)
имя пользователя Имя пользователя для частного реестра. строка (обязательно)

InitContainerDefinition (Определение контейнера)

Имя Описание Ценность
имя Имя контейнера инициализации. строка (обязательно)
свойства Свойства контейнера инициализации. InitContainerPropertiesDefinition (обязательно)

Определение InitContainerProperties

Имя Описание Ценность
команда Команда, выполняемая в контейнере init в форме exec. строка[]
переменные окружения Переменные среды, заданные в контейнере init. Переменная среды[]
образ Изображение контейнера инициализации. струна
volumeMounts Том подключается к контейнеру init. VolumeMount[]

IP-адрес

Имя Описание Ценность
dnsNameLabel Метка DNS-имени для IP-адреса. струна
протокол IP IP-адрес, предоставляемый общедоступному Интернету. струна
Порты Список портов, предоставляемых в группе контейнеров. порт[] (обязательно)
тип Указывает, предоставляется ли IP-адрес общедоступному Интернету или частной виртуальной сети. "Private"
"Public" (обязательно)

LogAnalytics

Имя Описание Ценность
logType Используемый тип журнала. ContainerInsights
ContainerInstanceLogs
метаданные Метаданные для log analytics. LogAnalyticsМетаданные
WorkspaceId Идентификатор рабочей области для log analytics строка (обязательно)
workspaceKey Ключ рабочей области для log analytics строка (обязательно)
Идентификатор ресурса рабочего пространства Идентификатор ресурса рабочей области для log analytics струна

LogAnalyticsМетаданные

Имя Описание Ценность

Порт

Имя Описание Ценность
порт Номер порта. int (обязательно)
протокол Протокол, связанный с портом. "TCP"
"UDP"

Лимиты ресурсов

Имя Описание Ценность
ЦПУ Ограничение ЦП этого экземпляра контейнера. инт
Графический процессор Ограничение GPU этого экземпляра контейнера. Ресурс Gpu
памятьInGB Ограничение памяти в ГБ этого экземпляра контейнера. инт

Запросы на ресурсы

Имя Описание Ценность
ЦПУ Запрос ЦП этого экземпляра контейнера. int (обязательно)
Графический процессор Запрос GPU этого экземпляра контейнера. Ресурс Gpu
памятьInGB Запрос памяти в ГБ этого экземпляра контейнера. int (обязательно)

Требования к ресурсам

Имя Описание Ценность
Ограничения Ограничения ресурсов этого экземпляра контейнера. Лимиты ресурсов
Запросы Запросы ресурсов этого экземпляра контейнера. ResourceRequests (обязательно)

Теги ресурса

Имя Описание Ценность

Секретный объем

Имя Описание Ценность

Том

Имя Описание Ценность
azureFile Том файла Azure. AzureFileVolume
пустая директория Пустой том каталога. любой
gitRepo Том репозитория Git. GitRepoVolume (GitRepoVolume)
имя Имя тома. строка (обязательно)
секрет Том секрета. Секретный объем

Крепление VolumeMount

Имя Описание Ценность
mountPath Путь в контейнере, в котором должен быть подключен том. Не должен содержать двоеточие (:). строка (обязательно)
имя Имя подключения тома. строка (обязательно)
Только для чтения Флаг, указывающий, доступен ли подключение тома только для чтения. булевая переменная (bool)

Примеры использования

Шаблоны быстрого запуска Azure

Следующие шаблоны быстрого запуска Azure развернуть этот тип ресурса.

Шаблон Описание
экземпляры контейнеров Azure — BC с SQL Server и IIS

развертывание в Azure
Разверните один контейнер Windows с полностью автономной автономной средой Microsoft Dynamics 365 Business Central в экземплярах контейнеров Azure.
экземпляры контейнеров Azure — контейнер с пробой работоспособности

развертывание в Azure
Разверните контейнер Linux с пробой работоспособности с помощью экземпляров контейнеров Azure.
экземпляры контейнеров Azure — контейнер с секретами

развертывание в Azure
Разверните контейнер Linux с секретным томом с помощью экземпляров контейнеров Azure.
Экземпляры контейнеров Azure — контейнер с безопасным envVar

развертывание в Azure
Разверните контейнер Linux с безопасной переменной среды с помощью экземпляров контейнеров Azure.
экземпляры контейнеров Azure — контейнер Linux с пустым

развертывание в Azure
Разверните два контейнера Linux, которые совместно используют том emptyDir с помощью экземпляров контейнеров Azure.
экземпляры контейнеров Azure — контейнер Linux с gitRepo

развертывание в Azure
Разверните контейнер Linux, использующий том gitRepo с помощью экземпляров контейнеров Azure.
экземпляры контейнеров Azure — контейнер Linux с общедоступным IP-

развертывание в Azure
Разверните один контейнер Linux, доступный через общедоступный IP-адрес с помощью экземпляров контейнеров Azure.
экземпляры контейнеров Azure — виртуальная сеть

развертывание в Azure
Разверните экземпляр контейнера в виртуальной сети Azure.
создание общей папки учетной записи хранения с помощью контейнеров

развертывание в Azure
Этот шаблон создает учетную запись хранения и общую папку с помощью azure-cli в экземпляре контейнера
создание сайта WordPress

развертывание в Azure
Этот шаблон создает сайт WordPress в экземпляре контейнера
создание сайта WordPress в виртуальной сети

развертывание в Azure
Этот шаблон создает сайт WordPress в экземпляре контейнера в виртуальной сети. И выводит полное доменное имя общедоступного сайта, которое может получить доступ к сайту WordPress.
Создание сервера SFTP по запросу с постоянным хранилищем

развертывание в Azure
Этот шаблон демонстрирует сервер SFTP по запросу с помощью экземпляра контейнера Azure (ACI).
создание шлюза приложений с помощью сертификатов

развертывание в Azure
В этом шаблоне показано, как создавать самозаверяющие сертификаты Key Vault, а затем ссылаться на нее из шлюза приложений.
Front Door Standard/Premium с экземплярами контейнеров Azure

развертывание в Azure
Этот шаблон создает Front Door Standard/Premium с группой контейнеров.
Front Door с экземплярами контейнеров и шлюза приложений

развертывание в Azure
Этот шаблон создает Front Door Standard/Premium с группой контейнеров и шлюзом приложений.
SFTP-сервер по запросу с использованием существующей учетной записи хранения

развертывание в Azure
Этот шаблон демонстрирует сервер SFTP по запросу с помощью экземпляра контейнера Azure (ACI).
группа доступности SQL Server в AKS

развертывание в Azure
При этом создается новый кластер AKS, а затем развертываются группы доступности SQL Server с помощью пакета CNAB, развернутого с помощью Duffle и ACI.
Контейнер UDP в ACI

развертывание в Azure
Эти шаблоны создают ресурс ACI и предоставляют контейнер через UDP

Определение ресурса Terraform (поставщик AzAPI)

Тип ресурса containerGroups можно развернуть с помощью операций, предназначенных для следующих операций:

  • групп ресурсов

Список измененных свойств в каждой версии API см. в журнала изменений.

Формат ресурса

Чтобы создать ресурс Microsoft.ContainerInstance/containerGroups, добавьте следующий объект Terraform в шаблон.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.ContainerInstance/containerGroups@2021-07-01"
  name = "string"
  parent_id = "string"
  identity {
    type = "string"
    identity_ids = [
      "string"
    ]
  }
  location = "string"
  tags = {
    {customized property} = "string"
  }
  body = {
    properties = {
      containers = [
        {
          name = "string"
          properties = {
            command = [
              "string"
            ]
            environmentVariables = [
              {
                name = "string"
                secureValue = "string"
                value = "string"
              }
            ]
            image = "string"
            livenessProbe = {
              exec = {
                command = [
                  "string"
                ]
              }
              failureThreshold = int
              httpGet = {
                httpHeaders = [
                  {
                    name = "string"
                    value = "string"
                  }
                ]
                path = "string"
                port = int
                scheme = "string"
              }
              initialDelaySeconds = int
              periodSeconds = int
              successThreshold = int
              timeoutSeconds = int
            }
            ports = [
              {
                port = int
                protocol = "string"
              }
            ]
            readinessProbe = {
              exec = {
                command = [
                  "string"
                ]
              }
              failureThreshold = int
              httpGet = {
                httpHeaders = [
                  {
                    name = "string"
                    value = "string"
                  }
                ]
                path = "string"
                port = int
                scheme = "string"
              }
              initialDelaySeconds = int
              periodSeconds = int
              successThreshold = int
              timeoutSeconds = int
            }
            resources = {
              limits = {
                cpu = int
                gpu = {
                  count = int
                  sku = "string"
                }
                memoryInGB = int
              }
              requests = {
                cpu = int
                gpu = {
                  count = int
                  sku = "string"
                }
                memoryInGB = int
              }
            }
            volumeMounts = [
              {
                mountPath = "string"
                name = "string"
                readOnly = bool
              }
            ]
          }
        }
      ]
      diagnostics = {
        logAnalytics = {
          logType = "string"
          metadata = {
            {customized property} = "string"
          }
          workspaceId = "string"
          workspaceKey = "string"
          workspaceResourceId = "string"
        }
      }
      dnsConfig = {
        nameServers = [
          "string"
        ]
        options = "string"
        searchDomains = "string"
      }
      encryptionProperties = {
        keyName = "string"
        keyVersion = "string"
        vaultBaseUrl = "string"
      }
      imageRegistryCredentials = [
        {
          identity = "string"
          identityUrl = "string"
          password = "string"
          server = "string"
          username = "string"
        }
      ]
      initContainers = [
        {
          name = "string"
          properties = {
            command = [
              "string"
            ]
            environmentVariables = [
              {
                name = "string"
                secureValue = "string"
                value = "string"
              }
            ]
            image = "string"
            volumeMounts = [
              {
                mountPath = "string"
                name = "string"
                readOnly = bool
              }
            ]
          }
        }
      ]
      ipAddress = {
        dnsNameLabel = "string"
        ip = "string"
        ports = [
          {
            port = int
            protocol = "string"
          }
        ]
        type = "string"
      }
      osType = "string"
      restartPolicy = "string"
      sku = "string"
      subnetIds = [
        {
          id = "string"
          name = "string"
        }
      ]
      volumes = [
        {
          azureFile = {
            readOnly = bool
            shareName = "string"
            storageAccountKey = "string"
            storageAccountName = "string"
          }
          emptyDir = ?
          gitRepo = {
            directory = "string"
            repository = "string"
            revision = "string"
          }
          name = "string"
          secret = {
            {customized property} = "string"
          }
        }
      ]
    }
  }
}

Значения свойств

Microsoft.ContainerInstance/containerGroups

Имя Описание Ценность
тождество Удостоверение группы контейнеров, если настроено. containerGroupIdentity
местоположение Расположение ресурса. струна
имя Имя ресурса строка (обязательно)
свойства Свойства группы контейнеров ContainerGroupProperties (обязательно)
Теги Теги ресурсов Словарь имен и значений тегов.
тип Тип ресурса "Microsoft.ContainerInstance/containerGroups@2021-07-01"

AzureFileVolume

Имя Описание Ценность
Только для чтения Флаг, указывающий, подключен ли общий файл Azure в качестве тома только для чтения. булевая переменная (bool)
shareName Имя общей папки Azure, подключенной в качестве тома. строка (обязательно)
ключХранилищаАккаунта Ключ доступа к учетной записи хранения, используемый для доступа к общей папке Azure. струна
storageAccountName Имя учетной записи хранения, содержащей общую папку Azure. строка (обязательно)

Компоненты10Wh5UdSchemasContainergroupidentityPropertiesUserassignedidentitiesAdditionalproperties

Имя Описание Ценность

Контейнер

Имя Описание Ценность
имя Имя экземпляра контейнера, предоставленное пользователем. строка (обязательно)
свойства Свойства экземпляра контейнера. ContainerProperties (обязательно)

ContainerExec (ContainerExec)

Имя Описание Ценность
команда Команды, выполняемые в контейнере. строка[]

ContainerGroupDiagnostics

Имя Описание Ценность
LogAnalytics Сведения о log analytics группы контейнеров. LogAnalytics

ContainerGroupIdentity

Имя Описание Ценность
тип Тип удостоверения, используемого для группы контейнеров. Тип SystemAssigned, UserAssigned включает как неявное созданное удостоверение, так и набор назначенных пользователем удостоверений. Тип None удаляет все удостоверения из группы контейнеров. "Нет"
SystemAssigned
SystemAssigned, UserAssigned
UserAssigned
ИдентичностиНазначенныеПользователем Список удостоверений пользователей, связанных с группой контейнеров. Ссылки на ключ словаря удостоверений пользователя будут идентификаторами ресурсов ARM в форме: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}". ContainerGroupIdentityUserAssignedIdentities

ContainerGroupIdentityUserAssignedIdentities

Имя Описание Ценность

ContainerGroupProperties (Свойства контейнерной группы)

Имя Описание Ценность
Контейнеры Контейнеры в группе контейнеров. контейнер[] (обязательно)
диагностика Диагностические сведения для группы контейнеров. ContainerGroupDiagnostics
dnsConfig Сведения о конфигурации DNS для группы контейнеров. Конфигурация DNS
encryptionProperties Свойства шифрования для группы контейнеров. Свойства шифрования
Учетные данные imageRegistryCredentials Учетные данные реестра образов, из которых создается группа контейнеров. Учетные данные ImageRegistry[]
initContainers Контейнеры инициализации для группы контейнеров. InitContainerDefinition[]
IP-адрес Тип IP-адреса группы контейнеров. IpAddress
Тип ОС Тип операционной системы, необходимый контейнерам в группе контейнеров. Linux
"Windows" (обязательно)
политика перезапуска Перезапустите политику для всех контейнеров в группе контейнеров.
- Always always restart
- OnFailure перезапуск при сбое
- Never никогда не перезапускать
"Always"
"Никогда"
«Неудача»
SKU Номер SKU для группы контейнеров. "Выделенный"
"Стандартный"
SubnetIds Идентификаторы ресурсов подсети для группы контейнеров. ContainerGroupSubnetId[]
Объемы Список томов, которые могут быть подключены контейнерами в этой группе контейнеров. тома[]

ContainerGroupSubnetId (ContainerGroupSubnetId)

Имя Описание Ценность
идентификатор Идентификатор ресурса виртуальной сети и подсети. строка (обязательно)
имя Понятное имя подсети. струна

ContainerHttpGet

Имя Описание Ценность
HTTP-заголовки Заголовки HTTP. HttpHeader[]
путь Путь к пробе. струна
порт Номер порта для проверки. int (обязательно)
схема Схема. "http"
Https

КонтейнерПорт

Имя Описание Ценность
порт Номер порта, предоставляемый в группе контейнеров. int (обязательно)
протокол Протокол, связанный с портом. "TCP"
"UDP"

КонтейнерПроб

Имя Описание Ценность
выполнить Команда выполнения для проверки ContainerExec (ContainerExec)
Порог неудачи Порог сбоя. инт
httpGet Параметры Http Get для проверки ContainerHttpGet
initialDelaySeconds Начальная задержка секунд. инт
период в секундах Период секунд. инт
Порог успеха Порог успешности. инт
timeoutSeconds Время ожидания секунд. инт

СвойстваКонтейнера

Имя Описание Ценность
команда Команды, выполняемые в экземпляре контейнера в форме exec. строка[]
переменные окружения Переменные среды, заданные в экземпляре контейнера. Переменная среды[]
образ Имя образа, используемого для создания экземпляра контейнера. строка (обязательно)
livenessProbe Проба активности. КонтейнерПроб
Порты Предоставленные порты в экземпляре контейнера. КонтейнерПорт[]
готовностьProbe Проба готовности. КонтейнерПроб
ресурсы Требования к ресурсам экземпляра контейнера. ResourceRequirements (обязательно)
volumeMounts Том подключается к экземпляру контейнера. VolumeMount[]

Конфигурация DNS

Имя Описание Ценность
Серверы имен DNS-серверы для группы контейнеров. string[] (обязательно)
Параметры Параметры DNS для группы контейнеров. струна
searchDomains Домены поиска DNS для поиска имени узла в группе контейнеров. струна

Свойства шифрования

Имя Описание Ценность
keyName Имя ключа шифрования. строка (обязательно)
keyVersion Версия ключа шифрования. строка (обязательно)
vaultBaseUrl Базовый URL-адрес keyvault. строка (обязательно)

Переменная среды

Имя Описание Ценность
имя Имя переменной среды. строка (обязательно)
Функция secureValue Значение переменной безопасной среды. струна
ценность Значение переменной среды. струна

GitRepoVolume (GitRepoVolume)

Имя Описание Ценность
каталог Имя целевого каталога. Не должно содержать или начинаться с '.'. Если задано значение ".", каталог томов будет репозиторием Git. В противном случае, если задано, том будет содержать репозиторий Git в подкаталоге с заданным именем. струна
хранилище URL-адрес репозитория строка (обязательно)
пересмотр Зафиксировать хэш для указанной редакции. струна

Ресурс Gpu

Имя Описание Ценность
считать Количество ресурсов GPU. int (обязательно)
SKU Номер SKU ресурса GPU. "K80"
"P100"
"V100" (обязательно)

HttpHeader

Имя Описание Ценность
имя Имя заголовка. струна
ценность Значение заголовка. струна

Учетные данные ImageRegistryCredential

Имя Описание Ценность
тождество Удостоверение частного реестра. струна
identityUrl URL-адрес удостоверения для частного реестра. струна
пароль Пароль для частного реестра. струна
сервер Сервер реестра образов Docker без протокола, например http и https. строка (обязательно)
имя пользователя Имя пользователя для частного реестра. строка (обязательно)

InitContainerDefinition (Определение контейнера)

Имя Описание Ценность
имя Имя контейнера инициализации. строка (обязательно)
свойства Свойства контейнера инициализации. InitContainerPropertiesDefinition (обязательно)

Определение InitContainerProperties

Имя Описание Ценность
команда Команда, выполняемая в контейнере init в форме exec. строка[]
переменные окружения Переменные среды, заданные в контейнере init. Переменная среды[]
образ Изображение контейнера инициализации. струна
volumeMounts Том подключается к контейнеру init. VolumeMount[]

IP-адрес

Имя Описание Ценность
dnsNameLabel Метка DNS-имени для IP-адреса. струна
протокол IP IP-адрес, предоставляемый общедоступному Интернету. струна
Порты Список портов, предоставляемых в группе контейнеров. порт[] (обязательно)
тип Указывает, предоставляется ли IP-адрес общедоступному Интернету или частной виртуальной сети. "Private"
"Public" (обязательно)

LogAnalytics

Имя Описание Ценность
logType Используемый тип журнала. ContainerInsights
ContainerInstanceLogs
метаданные Метаданные для log analytics. LogAnalyticsМетаданные
WorkspaceId Идентификатор рабочей области для log analytics строка (обязательно)
workspaceKey Ключ рабочей области для log analytics строка (обязательно)
Идентификатор ресурса рабочего пространства Идентификатор ресурса рабочей области для log analytics струна

LogAnalyticsМетаданные

Имя Описание Ценность

Порт

Имя Описание Ценность
порт Номер порта. int (обязательно)
протокол Протокол, связанный с портом. "TCP"
"UDP"

Лимиты ресурсов

Имя Описание Ценность
ЦПУ Ограничение ЦП этого экземпляра контейнера. инт
Графический процессор Ограничение GPU этого экземпляра контейнера. Ресурс Gpu
памятьInGB Ограничение памяти в ГБ этого экземпляра контейнера. инт

Запросы на ресурсы

Имя Описание Ценность
ЦПУ Запрос ЦП этого экземпляра контейнера. int (обязательно)
Графический процессор Запрос GPU этого экземпляра контейнера. Ресурс Gpu
памятьInGB Запрос памяти в ГБ этого экземпляра контейнера. int (обязательно)

Требования к ресурсам

Имя Описание Ценность
Ограничения Ограничения ресурсов этого экземпляра контейнера. Лимиты ресурсов
Запросы Запросы ресурсов этого экземпляра контейнера. ResourceRequests (обязательно)

Теги ресурса

Имя Описание Ценность

Секретный объем

Имя Описание Ценность

Том

Имя Описание Ценность
azureFile Том файла Azure. AzureFileVolume
пустая директория Пустой том каталога. любой
gitRepo Том репозитория Git. GitRepoVolume (GitRepoVolume)
имя Имя тома. строка (обязательно)
секрет Том секрета. Секретный объем

Крепление VolumeMount

Имя Описание Ценность
mountPath Путь в контейнере, в котором должен быть подключен том. Не должен содержать двоеточие (:). строка (обязательно)
имя Имя подключения тома. строка (обязательно)
Только для чтения Флаг, указывающий, доступен ли подключение тома только для чтения. булевая переменная (bool)

Примеры использования

Проверенные модули Azure

Следующие проверенные модули Azure можно использовать для развертывания этого типа ресурсов.

Модуль Описание
экземпляра контейнера Модуль ресурсов AVM для экземпляра контейнера