Определение ресурсов 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" (обязательно) |
Имя |
Описание |
Ценность |
имя |
Имя заголовка. |
струна |
ценность |
Значение заголовка. |
струна |
Учетные данные 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 |
струна |
Порт
Имя |
Описание |
Ценность |
порт |
Номер порта. |
int (обязательно) |
протокол |
Протокол, связанный с портом. |
"TCP" "UDP" |
Лимиты ресурсов
Имя |
Описание |
Ценность |
ЦПУ |
Ограничение ЦП этого экземпляра контейнера. |
инт |
Графический процессор |
Ограничение GPU этого экземпляра контейнера. |
Ресурс Gpu |
памятьInGB |
Ограничение памяти в ГБ этого экземпляра контейнера. |
инт |
Запросы на ресурсы
Имя |
Описание |
Ценность |
ЦПУ |
Запрос ЦП этого экземпляра контейнера. |
int (обязательно) |
Графический процессор |
Запрос GPU этого экземпляра контейнера. |
Ресурс Gpu |
памятьInGB |
Запрос памяти в ГБ этого экземпляра контейнера. |
int (обязательно) |
Требования к ресурсам
Имя |
Описание |
Ценность |
Ограничения |
Ограничения ресурсов этого экземпляра контейнера. |
Лимиты ресурсов |
Запросы |
Запросы ресурсов этого экземпляра контейнера. |
ResourceRequests (обязательно) |
Секретный объем
Том
Крепление VolumeMount
Имя |
Описание |
Ценность |
mountPath |
Путь в контейнере, в котором должен быть подключен том. Не должен содержать двоеточие (:). |
строка (обязательно) |
имя |
Имя подключения тома. |
строка (обязательно) |
Только для чтения |
Флаг, указывающий, доступен ли подключение тома только для чтения. |
булевая переменная (bool) |
Примеры использования
Проверенные модули Azure
Следующие проверенные модули Azure можно использовать для развертывания этого типа ресурсов.
Примеры быстрого запуска Azure
Следующие шаблоны быстрого запуска Azure содержат примеры Bicep для развертывания этого типа ресурса.
Определение ресурса шаблона 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" (обязательно) |
Имя |
Описание |
Ценность |
имя |
Имя заголовка. |
струна |
ценность |
Значение заголовка. |
струна |
Учетные данные 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 |
струна |
Порт
Имя |
Описание |
Ценность |
порт |
Номер порта. |
int (обязательно) |
протокол |
Протокол, связанный с портом. |
"TCP" "UDP" |
Лимиты ресурсов
Имя |
Описание |
Ценность |
ЦПУ |
Ограничение ЦП этого экземпляра контейнера. |
инт |
Графический процессор |
Ограничение GPU этого экземпляра контейнера. |
Ресурс Gpu |
памятьInGB |
Ограничение памяти в ГБ этого экземпляра контейнера. |
инт |
Запросы на ресурсы
Имя |
Описание |
Ценность |
ЦПУ |
Запрос ЦП этого экземпляра контейнера. |
int (обязательно) |
Графический процессор |
Запрос GPU этого экземпляра контейнера. |
Ресурс Gpu |
памятьInGB |
Запрос памяти в ГБ этого экземпляра контейнера. |
int (обязательно) |
Требования к ресурсам
Имя |
Описание |
Ценность |
Ограничения |
Ограничения ресурсов этого экземпляра контейнера. |
Лимиты ресурсов |
Запросы |
Запросы ресурсов этого экземпляра контейнера. |
ResourceRequests (обязательно) |
Секретный объем
Том
Крепление VolumeMount
Имя |
Описание |
Ценность |
mountPath |
Путь в контейнере, в котором должен быть подключен том. Не должен содержать двоеточие (:). |
строка (обязательно) |
имя |
Имя подключения тома. |
строка (обязательно) |
Только для чтения |
Флаг, указывающий, доступен ли подключение тома только для чтения. |
булевая переменная (bool) |
Примеры использования
Шаблоны быстрого запуска Azure
Следующие шаблоны быстрого запуска Azure развернуть этот тип ресурса.
Тип ресурса 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" (обязательно) |
Имя |
Описание |
Ценность |
имя |
Имя заголовка. |
струна |
ценность |
Значение заголовка. |
струна |
Учетные данные 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 |
струна |
Порт
Имя |
Описание |
Ценность |
порт |
Номер порта. |
int (обязательно) |
протокол |
Протокол, связанный с портом. |
"TCP" "UDP" |
Лимиты ресурсов
Имя |
Описание |
Ценность |
ЦПУ |
Ограничение ЦП этого экземпляра контейнера. |
инт |
Графический процессор |
Ограничение GPU этого экземпляра контейнера. |
Ресурс Gpu |
памятьInGB |
Ограничение памяти в ГБ этого экземпляра контейнера. |
инт |
Запросы на ресурсы
Имя |
Описание |
Ценность |
ЦПУ |
Запрос ЦП этого экземпляра контейнера. |
int (обязательно) |
Графический процессор |
Запрос GPU этого экземпляра контейнера. |
Ресурс Gpu |
памятьInGB |
Запрос памяти в ГБ этого экземпляра контейнера. |
int (обязательно) |
Требования к ресурсам
Имя |
Описание |
Ценность |
Ограничения |
Ограничения ресурсов этого экземпляра контейнера. |
Лимиты ресурсов |
Запросы |
Запросы ресурсов этого экземпляра контейнера. |
ResourceRequests (обязательно) |
Секретный объем
Том
Крепление VolumeMount
Имя |
Описание |
Ценность |
mountPath |
Путь в контейнере, в котором должен быть подключен том. Не должен содержать двоеточие (:). |
строка (обязательно) |
имя |
Имя подключения тома. |
строка (обязательно) |
Только для чтения |
Флаг, указывающий, доступен ли подключение тома только для чтения. |
булевая переменная (bool) |
Примеры использования
Проверенные модули Azure
Следующие проверенные модули Azure можно использовать для развертывания этого типа ресурсов.