Microsoft.ContainerInstance containerGroups 2017-08-01-preview
Artykuł 05/11/2023
1 współautor
Opinia
W tym artykule
Definicja zasobu Bicep
Typ zasobu containerGroups można wdrożyć przy użyciu operacji docelowych:
Aby uzyskać listę zmienionych właściwości w każdej wersji interfejsu API, zobacz dziennik zmian .
Aby utworzyć zasób Microsoft.ContainerInstance/containerGroups, dodaj następujący kod Bicep do szablonu.
resource symbolicname 'Microsoft.ContainerInstance/containerGroups@2017-08-01-preview' = {
name: 'string'
location: 'string'
tags: {
tagName1: 'tagValue1'
tagName2: 'tagValue2'
}
properties: {
containers: [
{
name: 'string'
properties: {
command: [
'string'
]
environmentVariables: [
{
name: 'string'
value: 'string'
}
]
image: 'string'
ports: [
{
port: int
}
]
resources: {
limits: {
cpu: int
memoryInGB: json('decimal-as-string')
}
requests: {
cpu: int
memoryInGB: json('decimal-as-string')
}
}
volumeMounts: [
{
mountPath: 'string'
name: 'string'
readOnly: bool
}
]
}
}
]
imageRegistryCredentials: [
{
password: 'string'
server: 'string'
username: 'string'
}
]
ipAddress: {
ip: 'string'
ports: [
{
port: int
protocol: 'string'
}
]
type: 'Public'
}
osType: 'string'
restartPolicy: 'always'
volumes: [
{
azureFile: {
readOnly: bool
shareName: 'string'
storageAccountKey: 'string'
storageAccountName: 'string'
}
name: 'string'
}
]
}
}
Wartości właściwości
containerGroups
Nazwa
Opis
Wartość
name
Nazwa zasobu
ciąg (wymagany) Limit znaków: 1–63 Prawidłowe znaki: Wyłącznie małe litery, cyfry i łączniki. Nie można rozpocząć ani zakończyć łącznikiem. Następujące po sobie łączniki nie są dozwolone.
location
Lokalizacja zasobu.
ciąg (wymagany)
tags
Tagi zasobów.
Słownik nazw tagów i wartości. Zobacz Tagi w szablonach
properties
ContainerGroupProperties (wymagane)
ContainerGroupProperties
Nazwa
Opis
Wartość
containers
Kontenery w grupie kontenerów.
Kontener [] (wymagany)
imageRegistryCredentials
Poświadczenia rejestru obrazów, na podstawie których jest tworzona grupa kontenerów.
ImageRegistryCredential []
Ipaddress
Typ adresu IP grupy kontenerów.
Ipaddress
osType
Typ systemu operacyjnego wymagany przez kontenery w grupie kontenerów.
"Linux" "Windows" (wymagany)
restartPolicy
Uruchom ponownie zasady dla wszystkich kontenerów w grupie kontenerów. Obecnie jedyną dostępną opcją jest always
.
"zawsze"
volumes
Lista woluminów, które mogą być instalowane przez kontenery w tej grupie kontenerów.
Wolumin []
Kontener
Nazwa
Opis
Wartość
name
Podana przez użytkownika nazwa wystąpienia kontenera.
ciąg (wymagany)
properties
Właściwości wystąpienia kontenera.
ContainerProperties (wymagane)
Właściwości kontenera
Nazwa
Opis
Wartość
command
Polecenia do wykonania w ramach wystąpienia kontenera w formularzu exec.
ciąg[]
environmentVariables
Zmienne środowiskowe do ustawienia w wystąpieniu kontenera.
EnvironmentVariable []
image (obraz)
Nazwa obrazu użytego do utworzenia wystąpienia kontenera.
ciąg (wymagany)
ports
Uwidocznione porty w wystąpieniu kontenera.
ContainerPort []
zasoby
Wymagania dotyczące zasobów wystąpienia kontenera.
Wymagania dotyczące zasobów (wymagane)
volumeMounts
Wolumin instaluje dostępne dla wystąpienia kontenera.
VolumeMount []
EnvironmentVariable
Nazwa
Opis
Wartość
name
Nazwa zmiennej środowiskowej.
ciąg (wymagany)
wartość
Wartość zmiennej środowiskowej.
ciąg (wymagany)
ContainerPort
Nazwa
Opis
Wartość
port
Numer portu uwidoczniony w grupie kontenerów.
int (wymagane)
Wymagania dotyczące zasobów
Nazwa
Opis
Wartość
Limity
Limity zasobów tego wystąpienia kontenera.
ResourceLimits
Żądania
Żądania zasobów tego wystąpienia kontenera.
ResourceRequests (wymagane)
ResourceLimits
Nazwa
Opis
Wartość
Procesora
Limit procesora CPU tego wystąpienia kontenera.
int
memoryInGB
Limit pamięci w GB tego wystąpienia kontenera. Aby określić wartość dziesiętną, użyj funkcji json().
int lub json dziesiętny
ResourceRequests
Nazwa
Opis
Wartość
Procesora
Żądanie procesora CPU tego wystąpienia kontenera.
int (wymagane)
memoryInGB
Żądanie pamięci w GB tego wystąpienia kontenera. Aby określić wartość dziesiętną, użyj funkcji json().
liczba dziesiętna lub json (wymagana)
VolumeMount
Nazwa
Opis
Wartość
mountPath
Ścieżka w kontenerze, w którym należy zamontować wolumin. Nie może zawierać dwukropka (:).
ciąg (wymagany)
name
Nazwa instalacji woluminu.
ciąg (wymagany)
Readonly
Flaga wskazująca, czy instalacja woluminu jest tylko do odczytu.
bool
ImageRegistryCredential
Nazwa
Opis
Wartość
hasło
Hasło dla rejestru prywatnego.
ciąg
serwer
Serwer rejestru obrazów platformy Docker bez protokołu takiego jak "http" i "https".
ciąg (wymagany)
nazwa użytkownika
Nazwa użytkownika rejestru prywatnego.
ciąg (wymagany)
Ipaddress
Nazwa
Opis
Wartość
IP
Adres IP uwidoczniony w publicznym Internecie.
ciąg
ports
Lista portów uwidocznionych w grupie kontenerów.
Port [] (wymagany)
typ
Określa, czy adres IP jest uwidoczniony w publicznym Internecie.
"Publiczny" (wymagany)
Port
Nazwa
Opis
Wartość
port
Numer portu.
int (wymagane)
Protokół
Protokół skojarzony z portem.
"TCP" "UDP"
Wolumin
Nazwa
Opis
Wartość
azureFile
Nazwa woluminu usługi Azure File.
AzureFileVolume (wymagane)
name
Nazwa woluminu.
ciąg (wymagany)
AzureFileVolume
Nazwa
Opis
Wartość
Readonly
Flaga wskazująca, czy udostępniony plik platformy Azure zainstalowany jako wolumin jest tylko do odczytu.
bool
Nazwaudziału
Nazwa udziału plików platformy Azure, który ma zostać zainstalowany jako wolumin.
ciąg (wymagany)
storageAccountKey
Klucz dostępu konta magazynu używany do uzyskiwania dostępu do udziału plików platformy Azure.
ciąg
storageAccountName
Nazwa konta magazynu zawierającego udział plików platformy Azure.
ciąg (wymagany)
Szablony szybkiego startu
Następujące szablony szybkiego startu wdrażają ten typ zasobu.
Definicja zasobu szablonu usługi ARM
Typ zasobu containerGroups można wdrożyć z operacjami docelowymi:
Aby uzyskać listę zmienionych właściwości w każdej wersji interfejsu API, zobacz dziennik zmian .
Aby utworzyć zasób Microsoft.ContainerInstance/containerGroups, dodaj następujący kod JSON do szablonu.
{
"type": "Microsoft.ContainerInstance/containerGroups",
"apiVersion": "2017-08-01-preview",
"name": "string",
"location": "string",
"tags": {
"tagName1": "tagValue1",
"tagName2": "tagValue2"
},
"properties": {
"containers": [
{
"name": "string",
"properties": {
"command": [ "string" ],
"environmentVariables": [
{
"name": "string",
"value": "string"
}
],
"image": "string",
"ports": [
{
"port": "int"
}
],
"resources": {
"limits": {
"cpu": "int",
"memoryInGB": "[json('decimal-as-string')]"
},
"requests": {
"cpu": "int",
"memoryInGB": "[json('decimal-as-string')]"
}
},
"volumeMounts": [
{
"mountPath": "string",
"name": "string",
"readOnly": "bool"
}
]
}
}
],
"imageRegistryCredentials": [
{
"password": "string",
"server": "string",
"username": "string"
}
],
"ipAddress": {
"ip": "string",
"ports": [
{
"port": "int",
"protocol": "string"
}
],
"type": "Public"
},
"osType": "string",
"restartPolicy": "always",
"volumes": [
{
"azureFile": {
"readOnly": "bool",
"shareName": "string",
"storageAccountKey": "string",
"storageAccountName": "string"
},
"name": "string"
}
]
}
}
Wartości właściwości
containerGroups
Nazwa
Opis
Wartość
typ
Typ zasobu
"Microsoft.ContainerInstance/containerGroups"
apiVersion
Wersja interfejsu API zasobów
"2017-08-01-preview"
name
Nazwa zasobu
ciąg (wymagany) Limit znaków: 1–63 Prawidłowe znaki: Wyłącznie małe litery, cyfry i łączniki. Nie można rozpocząć ani zakończyć łącznikiem. Następujące po sobie łączniki nie są dozwolone.
location
Lokalizacja zasobu.
ciąg (wymagany)
tags
Tagi zasobów.
Słownik nazw tagów i wartości. Zobacz Tagi w szablonach
properties
ContainerGroupProperties (wymagane)
ContainerGroupProperties
Nazwa
Opis
Wartość
containers
Kontenery w grupie kontenerów.
Kontener [] (wymagany)
imageRegistryCredentials
Poświadczenia rejestru obrazów, na podstawie których jest tworzona grupa kontenerów.
ImageRegistryCredential []
Ipaddress
Typ adresu IP grupy kontenerów.
Ipaddress
osType
Typ systemu operacyjnego wymagany przez kontenery w grupie kontenerów.
"Linux" "Windows" (wymagany)
restartPolicy
Uruchom ponownie zasady dla wszystkich kontenerów w grupie kontenerów. Obecnie jedyną dostępną opcją jest always
.
"zawsze"
volumes
Lista woluminów, które mogą być instalowane przez kontenery w tej grupie kontenerów.
Wolumin []
Kontener
Nazwa
Opis
Wartość
name
Podana przez użytkownika nazwa wystąpienia kontenera.
ciąg (wymagany)
properties
Właściwości wystąpienia kontenera.
ContainerProperties (wymagane)
Właściwości kontenera
Nazwa
Opis
Wartość
command
Polecenia do wykonania w ramach wystąpienia kontenera w formularzu exec.
ciąg[]
environmentVariables
Zmienne środowiskowe do ustawienia w wystąpieniu kontenera.
EnvironmentVariable []
image (obraz)
Nazwa obrazu użytego do utworzenia wystąpienia kontenera.
ciąg (wymagany)
ports
Uwidocznione porty w wystąpieniu kontenera.
ContainerPort []
zasoby
Wymagania dotyczące zasobów wystąpienia kontenera.
Wymagania dotyczące zasobów (wymagane)
volumeMounts
Wolumin instaluje dostępne dla wystąpienia kontenera.
VolumeMount []
EnvironmentVariable
Nazwa
Opis
Wartość
name
Nazwa zmiennej środowiskowej.
ciąg (wymagany)
wartość
Wartość zmiennej środowiskowej.
ciąg (wymagany)
ContainerPort
Nazwa
Opis
Wartość
port
Numer portu uwidoczniony w grupie kontenerów.
int (wymagane)
Wymagania dotyczące zasobów
Nazwa
Opis
Wartość
Limity
Limity zasobów tego wystąpienia kontenera.
ResourceLimits
Żądania
Żądania zasobów tego wystąpienia kontenera.
ResourceRequests (wymagane)
ResourceLimits
Nazwa
Opis
Wartość
Procesora
Limit procesora CPU tego wystąpienia kontenera.
int
memoryInGB
Limit pamięci w GB tego wystąpienia kontenera. Aby określić wartość dziesiętną, użyj funkcji json().
int lub json dziesiętny
ResourceRequests
Nazwa
Opis
Wartość
Procesora
Żądanie procesora CPU tego wystąpienia kontenera.
int (wymagane)
memoryInGB
Żądanie pamięci w GB tego wystąpienia kontenera. Aby określić wartość dziesiętną, użyj funkcji json().
liczba dziesiętna lub json (wymagana)
VolumeMount
Nazwa
Opis
Wartość
mountPath
Ścieżka w kontenerze, w którym należy zamontować wolumin. Nie może zawierać dwukropka (:).
ciąg (wymagany)
name
Nazwa instalacji woluminu.
ciąg (wymagany)
Readonly
Flaga wskazująca, czy instalacja woluminu jest tylko do odczytu.
bool
ImageRegistryCredential
Nazwa
Opis
Wartość
hasło
Hasło dla rejestru prywatnego.
ciąg
serwer
Serwer rejestru obrazów platformy Docker bez protokołu takiego jak "http" i "https".
ciąg (wymagany)
nazwa użytkownika
Nazwa użytkownika rejestru prywatnego.
ciąg (wymagany)
Ipaddress
Nazwa
Opis
Wartość
IP
Adres IP uwidoczniony w publicznym Internecie.
ciąg
ports
Lista portów uwidocznionych w grupie kontenerów.
Port [] (wymagany)
typ
Określa, czy adres IP jest uwidoczniony w publicznym Internecie.
"Publiczny" (wymagany)
Port
Nazwa
Opis
Wartość
port
Numer portu.
int (wymagane)
Protokół
Protokół skojarzony z portem.
"TCP" "UDP"
Wolumin
Nazwa
Opis
Wartość
azureFile
Nazwa woluminu usługi Azure File.
AzureFileVolume (wymagane)
name
Nazwa woluminu.
ciąg (wymagany)
AzureFileVolume
Nazwa
Opis
Wartość
Readonly
Flaga wskazująca, czy udostępniony plik platformy Azure jest zainstalowany jako wolumin tylko do odczytu.
bool
Nazwaudziału
Nazwa udziału plików platformy Azure, który ma zostać zainstalowany jako wolumin.
ciąg (wymagany)
storageAccountKey
Klucz dostępu konta magazynu używany do uzyskiwania dostępu do udziału plików platformy Azure.
ciąg
storageAccountName
Nazwa konta magazynu zawierającego udział plików platformy Azure.
ciąg (wymagany)
Szablony szybkiego startu
Następujące szablony szybkiego startu wdrażają ten typ zasobu.
Typ zasobu containerGroups można wdrożyć z operacjami docelowymi:
Aby uzyskać listę zmienionych właściwości w każdej wersji interfejsu API, zobacz dziennik zmian .
Aby utworzyć zasób Microsoft.ContainerInstance/containerGroups, dodaj następujący element Terraform do szablonu.
resource "azapi_resource" "symbolicname" {
type = "Microsoft.ContainerInstance/containerGroups@2017-08-01-preview"
name = "string"
location = "string"
parent_id = "string"
tags = {
tagName1 = "tagValue1"
tagName2 = "tagValue2"
}
body = jsonencode({
properties = {
containers = [
{
name = "string"
properties = {
command = [
"string"
]
environmentVariables = [
{
name = "string"
value = "string"
}
]
image = "string"
ports = [
{
port = int
}
]
resources = {
limits = {
cpu = int
memoryInGB = "decimal-as-string"
}
requests = {
cpu = int
memoryInGB = "decimal-as-string"
}
}
volumeMounts = [
{
mountPath = "string"
name = "string"
readOnly = bool
}
]
}
}
]
imageRegistryCredentials = [
{
password = "string"
server = "string"
username = "string"
}
]
ipAddress = {
ip = "string"
ports = [
{
port = int
protocol = "string"
}
]
type = "Public"
}
osType = "string"
restartPolicy = "always"
volumes = [
{
azureFile = {
readOnly = bool
shareName = "string"
storageAccountKey = "string"
storageAccountName = "string"
}
name = "string"
}
]
}
})
}
Wartości właściwości
containerGroups
Nazwa
Opis
Wartość
typ
Typ zasobu
"Microsoft.ContainerInstance/containerGroups@2017-08-01-preview"
name
Nazwa zasobu
ciąg (wymagany) Limit znaków: 1–63 Prawidłowe znaki: Wyłącznie małe litery, cyfry i łączniki. Nie można rozpocząć ani zakończyć łącznikiem. Następujące po sobie łączniki nie są dozwolone.
location
Lokalizacja zasobu.
ciąg (wymagany)
parent_id
Aby przeprowadzić wdrożenie w grupie zasobów, użyj identyfikatora tej grupy zasobów.
ciąg (wymagany)
tags
Tagi zasobów.
Słownik nazw tagów i wartości.
properties
ContainerGroupProperties (wymagane)
ContainerGroupProperties
Nazwa
Opis
Wartość
containers
Kontenery w grupie kontenerów.
Kontener [] (wymagany)
imageRegistryCredentials
Poświadczenia rejestru obrazów, na podstawie których jest tworzona grupa kontenerów.
ImageRegistryCredential []
Ipaddress
Typ adresu IP grupy kontenerów.
Ipaddress
osType
Typ systemu operacyjnego wymagany przez kontenery w grupie kontenerów.
"Linux" "Windows" (wymagane)
restartPolicy
Uruchom ponownie zasady dla wszystkich kontenerów w grupie kontenerów. Obecnie jedyną dostępną opcją jest always
.
"zawsze"
volumes
Lista woluminów, które mogą być instalowane przez kontenery w tej grupie kontenerów.
Wolumin []
Kontener
Nazwa
Opis
Wartość
name
Podana przez użytkownika nazwa wystąpienia kontenera.
ciąg (wymagany)
properties
Właściwości wystąpienia kontenera.
ContainerProperties (wymagane)
Właściwości kontenera
Nazwa
Opis
Wartość
command
Polecenia do wykonania w ramach wystąpienia kontenera w postaci exec.
ciąg[]
environmentVariables
Zmienne środowiskowe do ustawienia w wystąpieniu kontenera.
EnvironmentVariable []
image (obraz)
Nazwa obrazu użytego do utworzenia wystąpienia kontenera.
ciąg (wymagany)
ports
Uwidocznione porty w wystąpieniu kontenera.
ContainerPort []
zasoby
Wymagania dotyczące zasobów wystąpienia kontenera.
ResourceRequirements (wymagane)
volumeMounts
Wolumin jest dostępny dla wystąpienia kontenera.
VolumeMount []
EnvironmentVariable
Nazwa
Opis
Wartość
name
Nazwa zmiennej środowiskowej.
ciąg (wymagany)
wartość
Wartość zmiennej środowiskowej.
ciąg (wymagany)
ContainerPort
Nazwa
Opis
Wartość
port
Numer portu uwidoczniony w grupie kontenerów.
int (wymagane)
Wymagania dotyczące zasobów
Nazwa
Opis
Wartość
Limity
Limity zasobów tego wystąpienia kontenera.
ZasobyLimity
Żądania
Żądania zasobów tego wystąpienia kontenera.
ResourceRequests (wymagane)
ZasobyLimity
Nazwa
Opis
Wartość
Procesora
Limit procesora CPU dla tego wystąpienia kontenera.
int
memoryInGB
Limit pamięci w GB tego wystąpienia kontenera. Określ wartość dziesiętną jako ciąg.
int lub json dziesiętne
ResourceRequests
Nazwa
Opis
Wartość
Procesora
Żądanie procesora CPU tego wystąpienia kontenera.
int (wymagane)
memoryInGB
Żądanie pamięci w GB tego wystąpienia kontenera. Określ wartość dziesiętną jako ciąg.
liczba dziesiętna lub json (wymagana)
VolumeMount
Nazwa
Opis
Wartość
mountPath
Ścieżka w kontenerze, w którym należy zamontować wolumin. Nie może zawierać dwukropka (:).
ciąg (wymagany)
name
Nazwa instalacji woluminu.
ciąg (wymagany)
Readonly
Flaga wskazująca, czy instalacja woluminu jest tylko do odczytu.
bool
ImageRegistryCredential
Nazwa
Opis
Wartość
hasło
Hasło dla rejestru prywatnego.
ciąg
serwer
Serwer rejestru obrazów platformy Docker bez protokołu takiego jak "http" i "https".
ciąg (wymagany)
nazwa użytkownika
Nazwa użytkownika rejestru prywatnego.
ciąg (wymagany)
Ipaddress
Nazwa
Opis
Wartość
IP
Adres IP uwidoczniony w publicznym Internecie.
ciąg
ports
Lista portów uwidocznionych w grupie kontenerów.
Port [] (wymagany)
typ
Określa, czy adres IP jest uwidoczniony w publicznym Internecie.
"Publiczny" (wymagany)
Port
Nazwa
Opis
Wartość
port
Numer portu.
int (wymagane)
Protokół
Protokół skojarzony z portem.
"TCP" "UDP"
Wolumin
Nazwa
Opis
Wartość
azureFile
Nazwa woluminu usługi Azure File.
AzureFileVolume (wymagane)
name
Nazwa woluminu.
ciąg (wymagany)
AzureFileVolume
Nazwa
Opis
Wartość
Readonly
Flaga wskazująca, czy udostępniony plik platformy Azure jest zainstalowany jako wolumin tylko do odczytu.
bool
Nazwaudziału
Nazwa udziału plików platformy Azure, który ma zostać zainstalowany jako wolumin.
ciąg (wymagany)
storageAccountKey
Klucz dostępu do konta magazynu używany do uzyskiwania dostępu do udziału plików platformy Azure.
ciąg
storageAccountName
Nazwa konta magazynu zawierającego udział plików platformy Azure.
ciąg (wymagany)