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 dziennika zmian.
Aby utworzyć zasób Microsoft.ContainerInstance/containerGroups, dodaj następujący kod Bicep do szablonu.
resource symbolicname 'Microsoft.ContainerInstance/containerGroups@2019-12-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: {
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: {
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'
}
}
dnsConfig: {
nameServers: [
'string'
]
options: 'string'
searchDomains: 'string'
}
encryptionProperties: {
keyName: 'string'
keyVersion: 'string'
vaultBaseUrl: 'string'
}
imageRegistryCredentials: [
{
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'
}
networkProfile: {
id: 'string'
}
osType: 'string'
restartPolicy: 'string'
sku: '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'
}
}
Wartości właściwości
AzureFileVolume
Nazwa |
Opis |
Wartość |
readOnly |
Flaga wskazująca, czy udostępniony plik platformy Azure zainstalowany jako wolumin jest tylko do odczytu. |
Bool |
shareName |
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. |
struna |
storageAccountName |
Nazwa konta magazynu zawierającego udział plików platformy Azure. |
ciąg (wymagany) |
Components10Wh5UdSchemasContainergroupidentityPropertiesUserassignedidentitiesAdditionalproperties
Kontener
Nazwa |
Opis |
Wartość |
nazwa |
Podana przez użytkownika nazwa wystąpienia kontenera. |
ciąg (wymagany) |
Właściwości |
Właściwości wystąpienia kontenera. |
ContainerProperties (wymagane) |
ContainerExec
Nazwa |
Opis |
Wartość |
polecenie |
Polecenia do wykonania w kontenerze. |
string[] |
ContainerGroupDiagnostics
Nazwa |
Opis |
Wartość |
logAnalytics |
Informacje analizy dzienników grupy kontenerów. |
LogAnalytics |
ContainerGroupIdentity
Nazwa |
Opis |
Wartość |
typ |
Typ tożsamości używany dla grupy kontenerów. Typ "SystemAssigned, UserAssigned" zawiera zarówno niejawnie utworzoną tożsamość, jak i zestaw tożsamości przypisanych przez użytkownika. Typ "Brak" spowoduje usunięcie tożsamości z grupy kontenerów. |
"Brak" "SystemAssigned" "SystemAssigned, UserAssigned" "UserAssigned" |
userAssignedIdentities |
Lista tożsamości użytkowników skojarzonych z grupą kontenerów. Odwołania do klucza słownika tożsamości użytkownika będą identyfikatorami zasobów arm w postaci: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}". |
ContainerGroupIdentityUserAssignedIdentities |
ContainerGroupIdentityUserAssignedIdentities
ContainerGroupNetworkProfile
Nazwa |
Opis |
Wartość |
id |
Identyfikator profilu sieciowego. |
ciąg (wymagany) |
ContainerGroupProperties
Nazwa |
Opis |
Wartość |
Pojemniki |
Kontenery w grupie kontenerów. |
Container[] (wymagane) |
Diagnostyka |
Informacje diagnostyczne dla grupy kontenerów. |
ContainerGroupDiagnostics |
dnsConfig |
Informacje o konfiguracji DNS dla grupy kontenerów. |
DnsConfiguration |
encryptionProperties |
Właściwości szyfrowania dla grupy kontenerów. |
EncryptionProperties |
imageRegistryCredentials |
Poświadczenia rejestru obrazów, na podstawie których jest tworzona grupa kontenerów. |
ImageRegistryCredential[] |
initContainers |
Kontenery inicjowania dla grupy kontenerów. |
InitContainerDefinition[] |
ipAddress |
Typ adresu IP grupy kontenerów. |
IpAddress |
networkProfile |
Informacje o profilu sieci dla grupy kontenerów. |
ContainerGroupNetworkProfile |
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.
-
Always Zawsze uruchamiaj ponownie
-
OnFailure ponowne uruchomienie po awarii
-
Never Nigdy nie uruchamiaj ponownie |
"Zawsze" "Nigdy" "OnFailure" |
Numer jednostki magazynowej |
Jednostka SKU dla grupy kontenerów. |
"Dedykowane" "Standardowa" |
Woluminów |
Lista woluminów, które mogą być instalowane przez kontenery w tej grupie kontenerów. |
woluminu[] |
ContainerHttpGet
Nazwa |
Opis |
Wartość |
ścieżka |
Ścieżka do sondy. |
struna |
port |
Numer portu do sondy. |
int (wymagane) |
plan |
Schemat. |
"http" "https" |
ContainerPort
Nazwa |
Opis |
Wartość |
port |
Numer portu uwidoczniony w grupie kontenerów. |
int (wymagane) |
protokół |
Protokół skojarzony z portem. |
"TCP" "UDP" |
ContainerProbe
Nazwa |
Opis |
Wartość |
Exec |
Polecenie wykonywania do sondowania |
ContainerExec |
failureThreshold |
Próg niepowodzenia. |
Int |
httpGet |
Ustawienia Http Get do sondy |
ContainerHttpGet |
initialDelaySeconds |
Początkowe opóźnienie sekund. |
Int |
periodSeconds |
Czas w sekundach. |
Int |
successThreshold |
Próg powodzenia. |
Int |
timeoutSeconds |
Limit czasu sekund. |
Int |
ContainerProperties
Nazwa |
Opis |
Wartość |
polecenie |
Polecenia do wykonania w ramach wystąpienia kontenera w formularzu exec. |
string[] |
environmentVariables |
Zmienne środowiskowe do ustawienia w wystąpieniu kontenera. |
EnvironmentVariable[] |
obraz |
Nazwa obrazu użytego do utworzenia wystąpienia kontenera. |
ciąg (wymagany) |
livenessProbe |
Sonda liveness. |
ContainerProbe |
Porty |
Uwidocznione porty w wystąpieniu kontenera. |
ContainerPort[] |
gotowośćProbe |
Sonda gotowości. |
ContainerProbe |
zasoby |
Wymagania dotyczące zasobów wystąpienia kontenera. |
ResourceRequirements (wymagane) |
volumeMounts |
Woluminy są montowane w wystąpieniu kontenera. |
volumeMount[] |
Konfiguracja dns
Nazwa |
Opis |
Wartość |
nameServers |
Serwery DNS dla grupy kontenerów. |
string[] (wymagane) |
Opcje |
Opcje DNS dla grupy kontenerów. |
struna |
searchDomains |
Domeny wyszukiwania DNS dla wyszukiwania nazwy hosta w grupie kontenerów. |
struna |
Właściwości szyfrowania
Nazwa |
Opis |
Wartość |
keyName |
Nazwa klucza szyfrowania. |
ciąg (wymagany) |
keyVersion |
Wersja klucza szyfrowania. |
ciąg (wymagany) |
vaultBaseUrl |
Podstawowy adres URL usługi Keyvault. |
ciąg (wymagany) |
Zmienna środowiskowa
Nazwa |
Opis |
Wartość |
nazwa |
Nazwa zmiennej środowiskowej. |
ciąg (wymagany) |
secureValue |
Wartość bezpiecznej zmiennej środowiskowej. |
struna |
wartość |
Wartość zmiennej środowiskowej. |
struna |
GitRepoVolume
Nazwa |
Opis |
Wartość |
katalog |
Nazwa katalogu docelowego. Nie może zawierać ani rozpoczynać się od ".". Jeśli element "." zostanie dostarczony, katalog woluminu będzie repozytorium git. W przeciwnym razie, jeśli zostanie określony, wolumin będzie zawierać repozytorium git w podkatalogu o podanej nazwie. |
struna |
repozytorium |
Adres URL repozytorium |
ciąg (wymagany) |
rewizja |
Zatwierdź skrót dla określonej poprawki. |
struna |
GpuResource
Nazwa |
Opis |
Wartość |
hrabia |
Liczba zasobów procesora GPU. |
int (wymagane) |
Numer jednostki magazynowej |
Jednostka SKU zasobu procesora GPU. |
"K80" "P100" "V100" (wymagane) |
ImageRegistryCredential
Nazwa |
Opis |
Wartość |
hasło |
Hasło dla rejestru prywatnego. |
struna |
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) |
InitContainerDefinition
InitContainerPropertiesDefinition
Nazwa |
Opis |
Wartość |
polecenie |
Polecenie do wykonania w kontenerze init w formularzu exec. |
string[] |
environmentVariables |
Zmienne środowiskowe do ustawienia w kontenerze init. |
EnvironmentVariable[] |
obraz |
Obraz kontenera init. |
struna |
volumeMounts |
Wolumin instaluje się w kontenerze init. |
volumeMount[] |
Adresy IP
Nazwa |
Opis |
Wartość |
dnsNameLabel |
Etykieta nazwy DNS dla adresu IP. |
struna |
Ip |
Adres IP uwidoczniony w publicznym Internecie. |
struna |
Porty |
Lista portów uwidocznionych w grupie kontenerów. |
port[] (wymagane) |
typ |
Określa, czy adres IP jest uwidoczniony w publicznej sieci internetowej lub prywatnej sieci wirtualnej. |
"Prywatny" "Publiczny" (wymagany) |
LogAnalytics
Nazwa |
Opis |
Wartość |
logType |
Typ dziennika do użycia. |
"ContainerInsights" "ContainerInstanceLogs" |
metadane |
Metadane analizy dzienników. |
logAnalyticsMetadata |
workspaceId |
Identyfikator obszaru roboczego dla usługi Log Analytics |
ciąg (wymagany) |
workspaceKey |
Klucz obszaru roboczego na potrzeby analizy dzienników |
ciąg (wymagany) |
Microsoft.ContainerInstance/containerGroups
Nazwa |
Opis |
Wartość |
tożsamość |
Tożsamość grupy kontenerów, jeśli została skonfigurowana. |
ContainerGroupIdentity |
lokalizacja |
Lokalizacja zasobu. |
struna |
nazwa |
Nazwa zasobu |
ciąg (wymagany) |
Właściwości |
Właściwości grupy kontenerów |
ContainerGroupProperties (wymagane) |
Tagi |
Tagi zasobów |
Słownik nazw tagów i wartości. Zobacz tagi w szablonach |
Port
Nazwa |
Opis |
Wartość |
port |
Numer portu. |
int (wymagane) |
protokół |
Protokół skojarzony z portem. |
"TCP" "UDP" |
ZasobyLimits
Nazwa |
Opis |
Wartość |
procesor |
Limit procesora CPU dla tego wystąpienia kontenera. |
Int |
Gpu |
Limit procesora GPU tego wystąpienia kontenera. |
gpuResource |
memoryInGB |
Limit pamięci w GB tego wystąpienia kontenera. |
Int |
ResourceRequests
Nazwa |
Opis |
Wartość |
procesor |
Żądanie procesora CPU tego wystąpienia kontenera. |
int (wymagane) |
Gpu |
Żądanie procesora GPU tego wystąpienia kontenera. |
gpuResource |
memoryInGB |
Żądanie pamięci w GB tego wystąpienia kontenera. |
int (wymagane) |
Wymagania dotyczące zasobów
Nazwa |
Opis |
Wartość |
Limity |
Limity zasobów tego wystąpienia kontenera. |
ResourceLimits |
Żądania |
Zasób żąda tego wystąpienia kontenera. |
ResourceRequests (wymagane) |
SecretVolume
Głośność
Nazwa |
Opis |
Wartość |
azureFile |
Wolumin usługi Azure File. |
AzureFileVolume |
emptyDir |
Pusty wolumin katalogu. |
jakikolwiek |
gitRepo |
Wolumin repozytorium git. |
GitRepoVolume |
nazwa |
Nazwa woluminu. |
ciąg (wymagany) |
tajny |
Wolumin tajny. |
SecretVolume |
WoluminMount
Nazwa |
Opis |
Wartość |
mountPath |
Ścieżka w kontenerze, w którym należy zamontować wolumin. Nie może zawierać dwukropka (:). |
ciąg (wymagany) |
nazwa |
Nazwa instalacji woluminu. |
ciąg (wymagany) |
readOnly |
Flaga wskazująca, czy instalacja woluminu jest tylko do odczytu. |
Bool |
Przykłady użycia
Moduły zweryfikowane na platformie Azure
Następujące moduły zweryfikowane platformy Azure mogą służyć do wdrażania tego typu zasobu.
Przykłady szybkiego startu platformy Azure
Poniższe szablony szybkiego startu platformy Azure zawierają przykłady Bicep na potrzeby wdrażania tego typu zasobu.
Definicja zasobu szablonu usługi ARM
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 dziennika zmian.
Aby utworzyć zasób Microsoft.ContainerInstance/containerGroups, dodaj następujący kod JSON do szablonu.
{
"type": "Microsoft.ContainerInstance/containerGroups",
"apiVersion": "2019-12-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": {
"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": {
"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"
}
},
"dnsConfig": {
"nameServers": [ "string" ],
"options": "string",
"searchDomains": "string"
},
"encryptionProperties": {
"keyName": "string",
"keyVersion": "string",
"vaultBaseUrl": "string"
},
"imageRegistryCredentials": [
{
"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"
},
"networkProfile": {
"id": "string"
},
"osType": "string",
"restartPolicy": "string",
"sku": "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"
}
}
Wartości właściwości
AzureFileVolume
Nazwa |
Opis |
Wartość |
readOnly |
Flaga wskazująca, czy udostępniony plik platformy Azure zainstalowany jako wolumin jest tylko do odczytu. |
Bool |
shareName |
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. |
struna |
storageAccountName |
Nazwa konta magazynu zawierającego udział plików platformy Azure. |
ciąg (wymagany) |
Components10Wh5UdSchemasContainergroupidentityPropertiesUserassignedidentitiesAdditionalproperties
Kontener
Nazwa |
Opis |
Wartość |
nazwa |
Podana przez użytkownika nazwa wystąpienia kontenera. |
ciąg (wymagany) |
Właściwości |
Właściwości wystąpienia kontenera. |
ContainerProperties (wymagane) |
ContainerExec
Nazwa |
Opis |
Wartość |
polecenie |
Polecenia do wykonania w kontenerze. |
string[] |
ContainerGroupDiagnostics
Nazwa |
Opis |
Wartość |
logAnalytics |
Informacje analizy dzienników grupy kontenerów. |
LogAnalytics |
ContainerGroupIdentity
Nazwa |
Opis |
Wartość |
typ |
Typ tożsamości używany dla grupy kontenerów. Typ "SystemAssigned, UserAssigned" zawiera zarówno niejawnie utworzoną tożsamość, jak i zestaw tożsamości przypisanych przez użytkownika. Typ "Brak" spowoduje usunięcie tożsamości z grupy kontenerów. |
"Brak" "SystemAssigned" "SystemAssigned, UserAssigned" "UserAssigned" |
userAssignedIdentities |
Lista tożsamości użytkowników skojarzonych z grupą kontenerów. Odwołania do klucza słownika tożsamości użytkownika będą identyfikatorami zasobów arm w postaci: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}". |
ContainerGroupIdentityUserAssignedIdentities |
ContainerGroupIdentityUserAssignedIdentities
ContainerGroupNetworkProfile
Nazwa |
Opis |
Wartość |
id |
Identyfikator profilu sieciowego. |
ciąg (wymagany) |
ContainerGroupProperties
Nazwa |
Opis |
Wartość |
Pojemniki |
Kontenery w grupie kontenerów. |
Container[] (wymagane) |
Diagnostyka |
Informacje diagnostyczne dla grupy kontenerów. |
ContainerGroupDiagnostics |
dnsConfig |
Informacje o konfiguracji DNS dla grupy kontenerów. |
DnsConfiguration |
encryptionProperties |
Właściwości szyfrowania dla grupy kontenerów. |
EncryptionProperties |
imageRegistryCredentials |
Poświadczenia rejestru obrazów, na podstawie których jest tworzona grupa kontenerów. |
ImageRegistryCredential[] |
initContainers |
Kontenery inicjowania dla grupy kontenerów. |
InitContainerDefinition[] |
ipAddress |
Typ adresu IP grupy kontenerów. |
IpAddress |
networkProfile |
Informacje o profilu sieci dla grupy kontenerów. |
ContainerGroupNetworkProfile |
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.
-
Always Zawsze uruchamiaj ponownie
-
OnFailure ponowne uruchomienie po awarii
-
Never Nigdy nie uruchamiaj ponownie |
"Zawsze" "Nigdy" "OnFailure" |
Numer jednostki magazynowej |
Jednostka SKU dla grupy kontenerów. |
"Dedykowane" "Standardowa" |
Woluminów |
Lista woluminów, które mogą być instalowane przez kontenery w tej grupie kontenerów. |
woluminu[] |
ContainerHttpGet
Nazwa |
Opis |
Wartość |
ścieżka |
Ścieżka do sondy. |
struna |
port |
Numer portu do sondy. |
int (wymagane) |
plan |
Schemat. |
"http" "https" |
ContainerPort
Nazwa |
Opis |
Wartość |
port |
Numer portu uwidoczniony w grupie kontenerów. |
int (wymagane) |
protokół |
Protokół skojarzony z portem. |
"TCP" "UDP" |
ContainerProbe
Nazwa |
Opis |
Wartość |
Exec |
Polecenie wykonywania do sondowania |
ContainerExec |
failureThreshold |
Próg niepowodzenia. |
Int |
httpGet |
Ustawienia Http Get do sondy |
ContainerHttpGet |
initialDelaySeconds |
Początkowe opóźnienie sekund. |
Int |
periodSeconds |
Czas w sekundach. |
Int |
successThreshold |
Próg powodzenia. |
Int |
timeoutSeconds |
Limit czasu sekund. |
Int |
ContainerProperties
Nazwa |
Opis |
Wartość |
polecenie |
Polecenia do wykonania w ramach wystąpienia kontenera w formularzu exec. |
string[] |
environmentVariables |
Zmienne środowiskowe do ustawienia w wystąpieniu kontenera. |
EnvironmentVariable[] |
obraz |
Nazwa obrazu użytego do utworzenia wystąpienia kontenera. |
ciąg (wymagany) |
livenessProbe |
Sonda liveness. |
ContainerProbe |
Porty |
Uwidocznione porty w wystąpieniu kontenera. |
ContainerPort[] |
gotowośćProbe |
Sonda gotowości. |
ContainerProbe |
zasoby |
Wymagania dotyczące zasobów wystąpienia kontenera. |
ResourceRequirements (wymagane) |
volumeMounts |
Woluminy są montowane w wystąpieniu kontenera. |
volumeMount[] |
Konfiguracja dns
Nazwa |
Opis |
Wartość |
nameServers |
Serwery DNS dla grupy kontenerów. |
string[] (wymagane) |
Opcje |
Opcje DNS dla grupy kontenerów. |
struna |
searchDomains |
Domeny wyszukiwania DNS dla wyszukiwania nazwy hosta w grupie kontenerów. |
struna |
Właściwości szyfrowania
Nazwa |
Opis |
Wartość |
keyName |
Nazwa klucza szyfrowania. |
ciąg (wymagany) |
keyVersion |
Wersja klucza szyfrowania. |
ciąg (wymagany) |
vaultBaseUrl |
Podstawowy adres URL usługi Keyvault. |
ciąg (wymagany) |
Zmienna środowiskowa
Nazwa |
Opis |
Wartość |
nazwa |
Nazwa zmiennej środowiskowej. |
ciąg (wymagany) |
secureValue |
Wartość bezpiecznej zmiennej środowiskowej. |
struna |
wartość |
Wartość zmiennej środowiskowej. |
struna |
GitRepoVolume
Nazwa |
Opis |
Wartość |
katalog |
Nazwa katalogu docelowego. Nie może zawierać ani rozpoczynać się od ".". Jeśli element "." zostanie dostarczony, katalog woluminu będzie repozytorium git. W przeciwnym razie, jeśli zostanie określony, wolumin będzie zawierać repozytorium git w podkatalogu o podanej nazwie. |
struna |
repozytorium |
Adres URL repozytorium |
ciąg (wymagany) |
rewizja |
Zatwierdź skrót dla określonej poprawki. |
struna |
GpuResource
Nazwa |
Opis |
Wartość |
hrabia |
Liczba zasobów procesora GPU. |
int (wymagane) |
Numer jednostki magazynowej |
Jednostka SKU zasobu procesora GPU. |
"K80" "P100" "V100" (wymagane) |
ImageRegistryCredential
Nazwa |
Opis |
Wartość |
hasło |
Hasło dla rejestru prywatnego. |
struna |
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) |
InitContainerDefinition
InitContainerPropertiesDefinition
Nazwa |
Opis |
Wartość |
polecenie |
Polecenie do wykonania w kontenerze init w formularzu exec. |
string[] |
environmentVariables |
Zmienne środowiskowe do ustawienia w kontenerze init. |
EnvironmentVariable[] |
obraz |
Obraz kontenera init. |
struna |
volumeMounts |
Wolumin instaluje się w kontenerze init. |
volumeMount[] |
Adresy IP
Nazwa |
Opis |
Wartość |
dnsNameLabel |
Etykieta nazwy DNS dla adresu IP. |
struna |
Ip |
Adres IP uwidoczniony w publicznym Internecie. |
struna |
Porty |
Lista portów uwidocznionych w grupie kontenerów. |
port[] (wymagane) |
typ |
Określa, czy adres IP jest uwidoczniony w publicznej sieci internetowej lub prywatnej sieci wirtualnej. |
"Prywatny" "Publiczny" (wymagany) |
LogAnalytics
Nazwa |
Opis |
Wartość |
logType |
Typ dziennika do użycia. |
"ContainerInsights" "ContainerInstanceLogs" |
metadane |
Metadane analizy dzienników. |
logAnalyticsMetadata |
workspaceId |
Identyfikator obszaru roboczego dla usługi Log Analytics |
ciąg (wymagany) |
workspaceKey |
Klucz obszaru roboczego na potrzeby analizy dzienników |
ciąg (wymagany) |
Microsoft.ContainerInstance/containerGroups
Nazwa |
Opis |
Wartość |
apiVersion |
Wersja interfejsu API |
'2019-12-01' |
tożsamość |
Tożsamość grupy kontenerów, jeśli została skonfigurowana. |
ContainerGroupIdentity |
lokalizacja |
Lokalizacja zasobu. |
struna |
nazwa |
Nazwa zasobu |
ciąg (wymagany) |
Właściwości |
Właściwości grupy kontenerów |
ContainerGroupProperties (wymagane) |
Tagi |
Tagi zasobów |
Słownik nazw tagów i wartości. Zobacz tagi w szablonach |
typ |
Typ zasobu |
"Microsoft.ContainerInstance/containerGroups" |
Port
Nazwa |
Opis |
Wartość |
port |
Numer portu. |
int (wymagane) |
protokół |
Protokół skojarzony z portem. |
"TCP" "UDP" |
ZasobyLimits
Nazwa |
Opis |
Wartość |
procesor |
Limit procesora CPU dla tego wystąpienia kontenera. |
Int |
Gpu |
Limit procesora GPU tego wystąpienia kontenera. |
gpuResource |
memoryInGB |
Limit pamięci w GB tego wystąpienia kontenera. |
Int |
ResourceRequests
Nazwa |
Opis |
Wartość |
procesor |
Żądanie procesora CPU tego wystąpienia kontenera. |
int (wymagane) |
Gpu |
Żądanie procesora GPU tego wystąpienia kontenera. |
gpuResource |
memoryInGB |
Żądanie pamięci w GB tego wystąpienia kontenera. |
int (wymagane) |
Wymagania dotyczące zasobów
Nazwa |
Opis |
Wartość |
Limity |
Limity zasobów tego wystąpienia kontenera. |
ResourceLimits |
Żądania |
Zasób żąda tego wystąpienia kontenera. |
ResourceRequests (wymagane) |
SecretVolume
Głośność
Nazwa |
Opis |
Wartość |
azureFile |
Wolumin usługi Azure File. |
AzureFileVolume |
emptyDir |
Pusty wolumin katalogu. |
jakikolwiek |
gitRepo |
Wolumin repozytorium git. |
GitRepoVolume |
nazwa |
Nazwa woluminu. |
ciąg (wymagany) |
tajny |
Wolumin tajny. |
SecretVolume |
WoluminMount
Nazwa |
Opis |
Wartość |
mountPath |
Ścieżka w kontenerze, w którym należy zamontować wolumin. Nie może zawierać dwukropka (:). |
ciąg (wymagany) |
nazwa |
Nazwa instalacji woluminu. |
ciąg (wymagany) |
readOnly |
Flaga wskazująca, czy instalacja woluminu jest tylko do odczytu. |
Bool |
Przykłady użycia
Szablony szybkiego startu platformy Azure
Następujące szablony szybkiego startu platformy Azure wdrożyć ten typ zasobu.
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 dziennika zmian.
Aby utworzyć zasób Microsoft.ContainerInstance/containerGroups, dodaj następujący program Terraform do szablonu.
resource "azapi_resource" "symbolicname" {
type = "Microsoft.ContainerInstance/containerGroups@2019-12-01"
name = "string"
identity = {
type = "string"
userAssignedIdentities = {
{customized property} = {
}
}
}
location = "string"
tags = {
{customized property} = "string"
}
body = jsonencode({
properties = {
containers = [
{
name = "string"
properties = {
command = [
"string"
]
environmentVariables = [
{
name = "string"
secureValue = "string"
value = "string"
}
]
image = "string"
livenessProbe = {
exec = {
command = [
"string"
]
}
failureThreshold = int
httpGet = {
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 = {
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"
}
}
dnsConfig = {
nameServers = [
"string"
]
options = "string"
searchDomains = "string"
}
encryptionProperties = {
keyName = "string"
keyVersion = "string"
vaultBaseUrl = "string"
}
imageRegistryCredentials = [
{
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"
}
networkProfile = {
id = "string"
}
osType = "string"
restartPolicy = "string"
sku = "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"
}
}
]
}
})
}
Wartości właściwości
AzureFileVolume
Nazwa |
Opis |
Wartość |
readOnly |
Flaga wskazująca, czy udostępniony plik platformy Azure zainstalowany jako wolumin jest tylko do odczytu. |
Bool |
shareName |
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. |
struna |
storageAccountName |
Nazwa konta magazynu zawierającego udział plików platformy Azure. |
ciąg (wymagany) |
Components10Wh5UdSchemasContainergroupidentityPropertiesUserassignedidentitiesAdditionalproperties
Kontener
Nazwa |
Opis |
Wartość |
nazwa |
Podana przez użytkownika nazwa wystąpienia kontenera. |
ciąg (wymagany) |
Właściwości |
Właściwości wystąpienia kontenera. |
ContainerProperties (wymagane) |
ContainerExec
Nazwa |
Opis |
Wartość |
polecenie |
Polecenia do wykonania w kontenerze. |
string[] |
ContainerGroupDiagnostics
Nazwa |
Opis |
Wartość |
logAnalytics |
Informacje analizy dzienników grupy kontenerów. |
LogAnalytics |
ContainerGroupIdentity
Nazwa |
Opis |
Wartość |
typ |
Typ tożsamości używany dla grupy kontenerów. Typ "SystemAssigned, UserAssigned" zawiera zarówno niejawnie utworzoną tożsamość, jak i zestaw tożsamości przypisanych przez użytkownika. Typ "Brak" spowoduje usunięcie tożsamości z grupy kontenerów. |
"Brak" "SystemAssigned" "SystemAssigned, UserAssigned" "UserAssigned" |
userAssignedIdentities |
Lista tożsamości użytkowników skojarzonych z grupą kontenerów. Odwołania do klucza słownika tożsamości użytkownika będą identyfikatorami zasobów arm w postaci: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}". |
ContainerGroupIdentityUserAssignedIdentities |
ContainerGroupIdentityUserAssignedIdentities
ContainerGroupNetworkProfile
Nazwa |
Opis |
Wartość |
id |
Identyfikator profilu sieciowego. |
ciąg (wymagany) |
ContainerGroupProperties
Nazwa |
Opis |
Wartość |
Pojemniki |
Kontenery w grupie kontenerów. |
Container[] (wymagane) |
Diagnostyka |
Informacje diagnostyczne dla grupy kontenerów. |
ContainerGroupDiagnostics |
dnsConfig |
Informacje o konfiguracji DNS dla grupy kontenerów. |
DnsConfiguration |
encryptionProperties |
Właściwości szyfrowania dla grupy kontenerów. |
EncryptionProperties |
imageRegistryCredentials |
Poświadczenia rejestru obrazów, na podstawie których jest tworzona grupa kontenerów. |
ImageRegistryCredential[] |
initContainers |
Kontenery inicjowania dla grupy kontenerów. |
InitContainerDefinition[] |
ipAddress |
Typ adresu IP grupy kontenerów. |
IpAddress |
networkProfile |
Informacje o profilu sieci dla grupy kontenerów. |
ContainerGroupNetworkProfile |
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.
-
Always Zawsze uruchamiaj ponownie
-
OnFailure ponowne uruchomienie po awarii
-
Never Nigdy nie uruchamiaj ponownie |
"Zawsze" "Nigdy" "OnFailure" |
Numer jednostki magazynowej |
Jednostka SKU dla grupy kontenerów. |
"Dedykowane" "Standardowa" |
Woluminów |
Lista woluminów, które mogą być instalowane przez kontenery w tej grupie kontenerów. |
woluminu[] |
ContainerHttpGet
Nazwa |
Opis |
Wartość |
ścieżka |
Ścieżka do sondy. |
struna |
port |
Numer portu do sondy. |
int (wymagane) |
plan |
Schemat. |
"http" "https" |
ContainerPort
Nazwa |
Opis |
Wartość |
port |
Numer portu uwidoczniony w grupie kontenerów. |
int (wymagane) |
protokół |
Protokół skojarzony z portem. |
"TCP" "UDP" |
ContainerProbe
Nazwa |
Opis |
Wartość |
Exec |
Polecenie wykonywania do sondowania |
ContainerExec |
failureThreshold |
Próg niepowodzenia. |
Int |
httpGet |
Ustawienia Http Get do sondy |
ContainerHttpGet |
initialDelaySeconds |
Początkowe opóźnienie sekund. |
Int |
periodSeconds |
Czas w sekundach. |
Int |
successThreshold |
Próg powodzenia. |
Int |
timeoutSeconds |
Limit czasu sekund. |
Int |
ContainerProperties
Nazwa |
Opis |
Wartość |
polecenie |
Polecenia do wykonania w ramach wystąpienia kontenera w formularzu exec. |
string[] |
environmentVariables |
Zmienne środowiskowe do ustawienia w wystąpieniu kontenera. |
EnvironmentVariable[] |
obraz |
Nazwa obrazu użytego do utworzenia wystąpienia kontenera. |
ciąg (wymagany) |
livenessProbe |
Sonda liveness. |
ContainerProbe |
Porty |
Uwidocznione porty w wystąpieniu kontenera. |
ContainerPort[] |
gotowośćProbe |
Sonda gotowości. |
ContainerProbe |
zasoby |
Wymagania dotyczące zasobów wystąpienia kontenera. |
ResourceRequirements (wymagane) |
volumeMounts |
Woluminy są montowane w wystąpieniu kontenera. |
volumeMount[] |
Konfiguracja dns
Nazwa |
Opis |
Wartość |
nameServers |
Serwery DNS dla grupy kontenerów. |
string[] (wymagane) |
Opcje |
Opcje DNS dla grupy kontenerów. |
struna |
searchDomains |
Domeny wyszukiwania DNS dla wyszukiwania nazwy hosta w grupie kontenerów. |
struna |
Właściwości szyfrowania
Nazwa |
Opis |
Wartość |
keyName |
Nazwa klucza szyfrowania. |
ciąg (wymagany) |
keyVersion |
Wersja klucza szyfrowania. |
ciąg (wymagany) |
vaultBaseUrl |
Podstawowy adres URL usługi Keyvault. |
ciąg (wymagany) |
Zmienna środowiskowa
Nazwa |
Opis |
Wartość |
nazwa |
Nazwa zmiennej środowiskowej. |
ciąg (wymagany) |
secureValue |
Wartość bezpiecznej zmiennej środowiskowej. |
struna |
wartość |
Wartość zmiennej środowiskowej. |
struna |
GitRepoVolume
Nazwa |
Opis |
Wartość |
katalog |
Nazwa katalogu docelowego. Nie może zawierać ani rozpoczynać się od ".". Jeśli element "." zostanie dostarczony, katalog woluminu będzie repozytorium git. W przeciwnym razie, jeśli zostanie określony, wolumin będzie zawierać repozytorium git w podkatalogu o podanej nazwie. |
struna |
repozytorium |
Adres URL repozytorium |
ciąg (wymagany) |
rewizja |
Zatwierdź skrót dla określonej poprawki. |
struna |
GpuResource
Nazwa |
Opis |
Wartość |
hrabia |
Liczba zasobów procesora GPU. |
int (wymagane) |
Numer jednostki magazynowej |
Jednostka SKU zasobu procesora GPU. |
"K80" "P100" "V100" (wymagane) |
ImageRegistryCredential
Nazwa |
Opis |
Wartość |
hasło |
Hasło dla rejestru prywatnego. |
struna |
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) |
InitContainerDefinition
InitContainerPropertiesDefinition
Nazwa |
Opis |
Wartość |
polecenie |
Polecenie do wykonania w kontenerze init w formularzu exec. |
string[] |
environmentVariables |
Zmienne środowiskowe do ustawienia w kontenerze init. |
EnvironmentVariable[] |
obraz |
Obraz kontenera init. |
struna |
volumeMounts |
Wolumin instaluje się w kontenerze init. |
volumeMount[] |
Adresy IP
Nazwa |
Opis |
Wartość |
dnsNameLabel |
Etykieta nazwy DNS dla adresu IP. |
struna |
Ip |
Adres IP uwidoczniony w publicznym Internecie. |
struna |
Porty |
Lista portów uwidocznionych w grupie kontenerów. |
port[] (wymagane) |
typ |
Określa, czy adres IP jest uwidoczniony w publicznej sieci internetowej lub prywatnej sieci wirtualnej. |
"Prywatny" "Publiczny" (wymagany) |
LogAnalytics
Nazwa |
Opis |
Wartość |
logType |
Typ dziennika do użycia. |
"ContainerInsights" "ContainerInstanceLogs" |
metadane |
Metadane analizy dzienników. |
logAnalyticsMetadata |
workspaceId |
Identyfikator obszaru roboczego dla usługi Log Analytics |
ciąg (wymagany) |
workspaceKey |
Klucz obszaru roboczego na potrzeby analizy dzienników |
ciąg (wymagany) |
Microsoft.ContainerInstance/containerGroups
Nazwa |
Opis |
Wartość |
tożsamość |
Tożsamość grupy kontenerów, jeśli została skonfigurowana. |
ContainerGroupIdentity |
lokalizacja |
Lokalizacja zasobu. |
struna |
nazwa |
Nazwa zasobu |
ciąg (wymagany) |
Właściwości |
Właściwości grupy kontenerów |
ContainerGroupProperties (wymagane) |
Tagi |
Tagi zasobów |
Słownik nazw tagów i wartości. |
typ |
Typ zasobu |
"Microsoft.ContainerInstance/containerGroups@2019-12-01" |
Port
Nazwa |
Opis |
Wartość |
port |
Numer portu. |
int (wymagane) |
protokół |
Protokół skojarzony z portem. |
"TCP" "UDP" |
ZasobyLimits
Nazwa |
Opis |
Wartość |
procesor |
Limit procesora CPU dla tego wystąpienia kontenera. |
Int |
Gpu |
Limit procesora GPU tego wystąpienia kontenera. |
gpuResource |
memoryInGB |
Limit pamięci w GB tego wystąpienia kontenera. |
Int |
ResourceRequests
Nazwa |
Opis |
Wartość |
procesor |
Żądanie procesora CPU tego wystąpienia kontenera. |
int (wymagane) |
Gpu |
Żądanie procesora GPU tego wystąpienia kontenera. |
gpuResource |
memoryInGB |
Żądanie pamięci w GB tego wystąpienia kontenera. |
int (wymagane) |
Wymagania dotyczące zasobów
Nazwa |
Opis |
Wartość |
Limity |
Limity zasobów tego wystąpienia kontenera. |
ResourceLimits |
Żądania |
Zasób żąda tego wystąpienia kontenera. |
ResourceRequests (wymagane) |
SecretVolume
Głośność
Nazwa |
Opis |
Wartość |
azureFile |
Wolumin usługi Azure File. |
AzureFileVolume |
emptyDir |
Pusty wolumin katalogu. |
jakikolwiek |
gitRepo |
Wolumin repozytorium git. |
GitRepoVolume |
nazwa |
Nazwa woluminu. |
ciąg (wymagany) |
tajny |
Wolumin tajny. |
SecretVolume |
WoluminMount
Nazwa |
Opis |
Wartość |
mountPath |
Ścieżka w kontenerze, w którym należy zamontować wolumin. Nie może zawierać dwukropka (:). |
ciąg (wymagany) |
nazwa |
Nazwa instalacji woluminu. |
ciąg (wymagany) |
readOnly |
Flaga wskazująca, czy instalacja woluminu jest tylko do odczytu. |
Bool |
Przykłady użycia
Moduły zweryfikowane na platformie Azure
Następujące moduły zweryfikowane platformy Azure mogą służyć do wdrażania tego typu zasobu.