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

Контейнер Microsoft.ContainerInstanceGroups 2017-10-01-preview

  • Статья

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

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

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

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

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

resource symbolicname 'Microsoft.ContainerInstance/containerGroups@2017-10-01-preview' = {
  location: 'string'
  name: 'string'
  properties: {
    containers: [
      {
        name: 'string'
        properties: {
          command: [
            'string'
          ]
          environmentVariables: [
            {
              name: 'string'
              value: 'string'
            }
          ]
          image: 'string'
          ports: [
            {
              port: int
              protocol: 'string'
            }
          ]
          resources: {
            limits: {
              cpu: int
              memoryInGB: int
            }
            requests: {
              cpu: int
              memoryInGB: int
            }
          }
          volumeMounts: [
            {
              mountPath: 'string'
              name: 'string'
              readOnly: bool
            }
          ]
        }
      }
    ]
    imageRegistryCredentials: [
      {
        password: 'string'
        server: 'string'
        username: 'string'
      }
    ]
    ipAddress: {
      ip: 'string'
      ports: [
        {
          port: int
          protocol: 'string'
        }
      ]
      type: 'string'
    }
    osType: 'string'
    restartPolicy: 'string'
    volumes: [
      {
        azureFile: {
          readOnly: bool
          shareName: 'string'
          storageAccountKey: 'string'
          storageAccountName: 'string'
        }
        emptyDir: any(Azure.Bicep.Types.Concrete.AnyType)
        name: 'string'
      }
    ]
  }
  tags: {
    {customized property}: 'string'
  }
}

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

AzureFileVolume

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

Контейнер

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

ContainerGroupProperties

Имя Описание Ценность
Контейнеры Контейнеры в группе контейнеров. контейнер[] (обязательно)
imageRegistryCredentials Учетные данные реестра образов, из которых создается группа контейнеров. ImageRegistryCredential[]
ipAddress Тип IP-адреса группы контейнеров. IpAddress
osType Тип операционной системы, необходимый контейнерам в группе контейнеров. Linux
"Windows" (обязательно)
restartPolicy Перезапустите политику для всех контейнеров в группе контейнеров.
- Always always restart
- OnFailure перезапуск при сбое
- Never никогда не перезапускать		 "Always"
"Никогда"
'OnFailure'
Объемы Список томов, которые могут быть подключены контейнерами в этой группе контейнеров. тома[]

ContainerPort

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

ContainerProperties

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

EnvironmentVariable

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

ImageRegistryCredential

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

IpAddress

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

Microsoft.ContainerInstance/containerGroups

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

Порт

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

ResourceLimits

Имя Описание Ценность
ЦПУ Ограничение ЦП этого экземпляра контейнера. int
memoryInGB Ограничение памяти в ГБ этого экземпляра контейнера. int

ResourceRequests

Имя Описание Ценность
ЦПУ Запрос ЦП этого экземпляра контейнера. int (обязательно)
memoryInGB Запрос памяти в ГБ этого экземпляра контейнера. int (обязательно)

ResourceRequirements

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

ResourceTags

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

Том

Имя Описание Ценность
azureFile Имя тома файла Azure. AzureFileVolume
emptyDir Пустой том каталога. любой
имя Имя тома. строка (обязательно)

VolumeMount

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

Примеры краткого руководства

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

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": "2017-10-01-preview",
  "name": "string",
  "location": "string",
  "properties": {
    "containers": [
      {
        "name": "string",
        "properties": {
          "command": [ "string" ],
          "environmentVariables": [
            {
              "name": "string",
              "value": "string"
            }
          ],
          "image": "string",
          "ports": [
            {
              "port": "int",
              "protocol": "string"
            }
          ],
          "resources": {
            "limits": {
              "cpu": "int",
              "memoryInGB": "int"
            },
            "requests": {
              "cpu": "int",
              "memoryInGB": "int"
            }
          },
          "volumeMounts": [
            {
              "mountPath": "string",
              "name": "string",
              "readOnly": "bool"
            }
          ]
        }
      }
    ],
    "imageRegistryCredentials": [
      {
        "password": "string",
        "server": "string",
        "username": "string"
      }
    ],
    "ipAddress": {
      "ip": "string",
      "ports": [
        {
          "port": "int",
          "protocol": "string"
        }
      ],
      "type": "string"
    },
    "osType": "string",
    "restartPolicy": "string",
    "volumes": [
      {
        "azureFile": {
          "readOnly": "bool",
          "shareName": "string",
          "storageAccountKey": "string",
          "storageAccountName": "string"
        },
        "emptyDir": {},
        "name": "string"
      }
    ]
  },
  "tags": {
    "{customized property}": "string"
  }
}

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

AzureFileVolume

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

Контейнер

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

ContainerGroupProperties

Имя Описание Ценность
Контейнеры Контейнеры в группе контейнеров. контейнер[] (обязательно)
imageRegistryCredentials Учетные данные реестра образов, из которых создается группа контейнеров. ImageRegistryCredential[]
ipAddress Тип IP-адреса группы контейнеров. IpAddress
osType Тип операционной системы, необходимый контейнерам в группе контейнеров. Linux
"Windows" (обязательно)
restartPolicy Перезапустите политику для всех контейнеров в группе контейнеров.
- Always always restart
- OnFailure перезапуск при сбое
- Never никогда не перезапускать		 "Always"
"Никогда"
'OnFailure'
Объемы Список томов, которые могут быть подключены контейнерами в этой группе контейнеров. тома[]

ContainerPort

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

ContainerProperties

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

EnvironmentVariable

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

ImageRegistryCredential

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

IpAddress

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

Microsoft.ContainerInstance/containerGroups

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

Порт

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

ResourceLimits

Имя Описание Ценность
ЦПУ Ограничение ЦП этого экземпляра контейнера. int
memoryInGB Ограничение памяти в ГБ этого экземпляра контейнера. int

ResourceRequests

Имя Описание Ценность
ЦПУ Запрос ЦП этого экземпляра контейнера. int (обязательно)
memoryInGB Запрос памяти в ГБ этого экземпляра контейнера. int (обязательно)

ResourceRequirements

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

ResourceTags

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

Том

Имя Описание Ценность
azureFile Имя тома файла Azure. AzureFileVolume
emptyDir Пустой том каталога. любой
имя Имя тома. строка (обязательно)

VolumeMount

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

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

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

Шаблон Описание
экземпляры контейнеров 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@2017-10-01-preview"
  name = "string"
  location = "string"
  tags = {
    {customized property} = "string"
  }
  body = jsonencode({
    properties = {
      containers = [
        {
          name = "string"
          properties = {
            command = [
              "string"
            ]
            environmentVariables = [
              {
                name = "string"
                value = "string"
              }
            ]
            image = "string"
            ports = [
              {
                port = int
                protocol = "string"
              }
            ]
            resources = {
              limits = {
                cpu = int
                memoryInGB = int
              }
              requests = {
                cpu = int
                memoryInGB = int
              }
            }
            volumeMounts = [
              {
                mountPath = "string"
                name = "string"
                readOnly = bool
              }
            ]
          }
        }
      ]
      imageRegistryCredentials = [
        {
          password = "string"
          server = "string"
          username = "string"
        }
      ]
      ipAddress = {
        ip = "string"
        ports = [
          {
            port = int
            protocol = "string"
          }
        ]
        type = "string"
      }
      osType = "string"
      restartPolicy = "string"
      volumes = [
        {
          azureFile = {
            readOnly = bool
            shareName = "string"
            storageAccountKey = "string"
            storageAccountName = "string"
          }
          emptyDir = ?
          name = "string"
        }
      ]
    }
  })
}

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

AzureFileVolume

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

Контейнер

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

ContainerGroupProperties

Имя Описание Ценность
Контейнеры Контейнеры в группе контейнеров. контейнер[] (обязательно)
imageRegistryCredentials Учетные данные реестра образов, из которых создается группа контейнеров. ImageRegistryCredential[]
ipAddress Тип IP-адреса группы контейнеров. IpAddress
osType Тип операционной системы, необходимый контейнерам в группе контейнеров. Linux
"Windows" (обязательно)
restartPolicy Перезапустите политику для всех контейнеров в группе контейнеров.
- Always always restart
- OnFailure перезапуск при сбое
- Never никогда не перезапускать		 "Always"
"Никогда"
'OnFailure'
Объемы Список томов, которые могут быть подключены контейнерами в этой группе контейнеров. тома[]

ContainerPort

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

ContainerProperties

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

EnvironmentVariable

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

ImageRegistryCredential

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

IpAddress

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

Microsoft.ContainerInstance/containerGroups

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

Порт

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

ResourceLimits

Имя Описание Ценность
ЦПУ Ограничение ЦП этого экземпляра контейнера. int
memoryInGB Ограничение памяти в ГБ этого экземпляра контейнера. int

ResourceRequests

Имя Описание Ценность
ЦПУ Запрос ЦП этого экземпляра контейнера. int (обязательно)
memoryInGB Запрос памяти в ГБ этого экземпляра контейнера. int (обязательно)

ResourceRequirements

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

ResourceTags

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

Том

Имя Описание Ценность
azureFile Имя тома файла Azure. AzureFileVolume
emptyDir Пустой том каталога. любой
имя Имя тома. строка (обязательно)

VolumeMount

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