Microsoft.ContainerInstance/containerGroups 2018-10-01 - Bicep, ARM template & Terraform AzAPI reference

Definicja zasobu Bicep

Typ zasobu containerGroups można wdrożyć przy użyciu operacji docelowych:

Grupy zasobów — zobacz polecenia wdrażania grupy zasobów

Aby uzyskać listę zmienionych właściwości w każdej wersji interfejsu API, zobacz dziennik zmian.

Format zasobu

Aby utworzyć zasób Microsoft.ContainerInstance/containerGroups, dodaj następujący kod Bicep do szablonu.

resource symbolicname 'Microsoft.ContainerInstance/containerGroups@2018-10-01' = {
  name: 'string'
  location: 'string'
  tags: {
    tagName1: 'tagValue1'
    tagName2: 'tagValue2'
  }
  identity: {
    type: 'string'
    userAssignedIdentities: {}
  }
  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: json('decimal-as-string')
            }
            requests: {
              cpu: int
              gpu: {
                count: int
                sku: 'string'
              }
              memoryInGB: json('decimal-as-string')
            }
          }
          volumeMounts: [
            {
              mountPath: 'string'
              name: 'string'
              readOnly: bool
            }
          ]
        }
      }
    ]
    diagnostics: {
      logAnalytics: {
        logType: 'string'
        metadata: {}
        workspaceId: 'string'
        workspaceKey: 'string'
      }
    }
    dnsConfig: {
      nameServers: [
        'string'
      ]
      options: 'string'
      searchDomains: 'string'
    }
    imageRegistryCredentials: [
      {
        password: 'string'
        server: 'string'
        username: 'string'
      }
    ]
    ipAddress: {
      dnsNameLabel: 'string'
      ip: 'string'
      ports: [
        {
          port: int
          protocol: 'string'
        }
      ]
      type: 'string'
    }
    networkProfile: {
      id: 'string'
    }
    osType: 'string'
    restartPolicy: 'string'
    volumes: [
      {
        azureFile: {
          readOnly: bool
          shareName: 'string'
          storageAccountKey: 'string'
          storageAccountName: 'string'
        }
        emptyDir: any()
        gitRepo: {
          directory: 'string'
          repository: 'string'
          revision: 'string'
        }
        name: 'string'
        secret: {}
      }
    ]
  }
}

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
tags	Tagi zasobów.	Słownik nazw tagów i wartości. Zobacz Tagi w szablonach
identity	Tożsamość grupy kontenerów, jeśli została skonfigurowana.	KontenerGroupIdentity
properties		ContainerGroupProperties (wymagane)

KontenerGroupIdentity

Nazwa	Opis	Wartość
typ	Typ tożsamości używanej 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 usługi ARM w postaci: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}".	object

ContainerGroupProperties

Nazwa	Opis	Wartość
containers	Kontenery w grupie kontenerów.	Kontener[] (wymagany)
Diagnostyka	Informacje diagnostyczne dla grupy kontenerów.	ContainerGroupDiagnostics
dnsConfig	Informacje o konfiguracji DNS dla grupy kontenerów.	Konfiguracja dns
imageRegistryCredentials	Poświadczenia rejestru obrazów, na podstawie których jest tworzona grupa kontenerów.	ImageRegistryCredential[]
Ipaddress	Typ adresu IP grupy kontenerów.	Ipaddress
networkProfile	Informacje o profilu sieciowym dla grupy kontenerów.	ContainerGroupNetworkProfile
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. - `Always` Zawsze uruchamiaj ponownie - `OnFailure` Ponowne uruchamianie po awarii - `Never` Nigdy nie uruchamiaj ponownie	"Zawsze" "Nigdy" "OnFailure"
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)
livenessProbe	Sonda liveness.	ContainerProbe
ports	Uwidocznione porty w wystąpieniu kontenera.	ContainerPort[]
gotowośćProbe	Sonda gotowości.	ContainerProbe
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)
secureValue	Wartość bezpiecznej zmiennej środowiskowej.	ciąg
wartość	Wartość zmiennej środowiskowej.	ciąg

ContainerProbe

Nazwa	Opis	Wartość
Exec	Polecenie wykonywania sondy	ContainerExec
failureThreshold	Próg awarii.	int
httpGet	Ustawienia Pobierania http do sondy	ContainerHttpGet
initialDelaySeconds	Początkowe opóźnienie sekund.	int
periodSeconds	W sekundach okresu.	int
successThreshold	Próg powodzenia.	int
timeoutSeconds	Limit czasu sekund.	int

ContainerExec

Nazwa	Opis	Wartość
command	Polecenia do wykonania w kontenerze.	ciąg[]

ContainerHttpGet

Nazwa	Opis	Wartość
path	Ścieżka do sondy.	ciąg
port	Numer portu do sondy.	int (wymagane)
schemat	Schemat.	"http" "https"

ContainerPort

Nazwa	Opis	Wartość
port	Numer portu uwidoczniony w grupie kontenerów.	int (wymagane)
Protokół	Protokół skojarzony z portem.	"TCP" "UDP"

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
Gpu	Limit procesora GPU tego wystąpienia kontenera.	GpuResource
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

GpuResource

Nazwa	Opis	Wartość
count	Liczba zasobów procesora GPU.	int (wymagane)
sku	Jednostka SKU zasobu procesora GPU.	"K80" "P100" "V100" (wymagane)

ResourceRequests

Nazwa	Opis	Wartość
Procesora	Żą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. 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

ContainerGroupDiagnostics

Nazwa	Opis	Wartość
logAnalytics	Informacje o usłudze Log Analytics grupy kontenerów.	LogAnalytics

LogAnalytics

Nazwa	Opis	Wartość
logType	Typ dziennika do użycia.	"ContainerInsights" "ContainerInstanceLogs"
metadane	Metadane analizy dzienników.	object
workspaceId	Identyfikator obszaru roboczego do analizy dzienników	ciąg (wymagany)
workspaceKey	Klucz obszaru roboczego do analizy dzienników	ciąg (wymagany)

Konfiguracja dns

Nazwa	Opis	Wartość
Nameservers	Serwery DNS dla grupy kontenerów.	string[] (wymagane)
opcje	Opcje DNS dla grupy kontenerów.	ciąg
searchDomains	Domeny wyszukiwania DNS dla wyszukiwania nazw hostów w grupie kontenerów.	ciąg

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ść
dnsNameLabel	Etykieta nazwy DNS dla adresu IP.	ciąg
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 publicznej sieci wirtualnej lub prywatnej sieci wirtualnej.	"Prywatne" "Publiczny" (wymagany)

Port

Nazwa	Opis	Wartość
port	Numer portu.	int (wymagane)
Protokół	Protokół skojarzony z portem.	"TCP" "UDP"

ContainerGroupNetworkProfile

Nazwa	Opis	Wartość
identyfikator	Identyfikator profilu sieciowego.	ciąg (wymagany)

Wolumin

Nazwa	Opis	Wartość
azureFile	Wolumin usługi Azure File.	AzureFileVolume
emptyDir	Pusty wolumin katalogu.	W przypadku Bicep można użyć funkcji any().
gitRepo	Wolumin repozytorium git.	GitRepoVolume
name	Nazwa woluminu.	ciąg (wymagany)
wpis tajny	Wolumin tajny.	object

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)

GitRepoVolume

Nazwa	Opis	Wartość
katalog	Nazwa katalogu docelowego. Nie może zawierać ani rozpoczynać się od ciągu ".". 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.	ciąg
repozytorium	Adres URL repozytorium	ciąg (wymagany)
revision	Zatwierdź skrót dla określonej poprawki.	ciąg

Szablony szybkiego startu

Następujące szablony szybkiego startu wdrażają ten typ zasobu.

Template	Opis
SQL Server grupy dostępności w usłudze AKS	Spowoduje to utworzenie nowego klastra usługi AKS, a następnie wdrożenie w nim SQL Server grup dostępności przy użyciu pakietu CNAB wdrożonego przy użyciu platformY Duffle i ACI
Tworzenie witryny WordPress	Ten szablon tworzy witrynę WordPress w wystąpieniu kontenera
Tworzenie witryny WordPress w sieci wirtualnej	Ten szablon tworzy witrynę WordPress w wystąpieniu kontenera w sieci wirtualnej. Wyprowadź również nazwę FQDN witryny publicznej, która może uzyskać dostęp do witryny WordPress.
Azure Container Instances — bc with SQL Server and IIS	Wdróż pojedynczy kontener systemu Windows z w pełni funkcjonalnym autonomicznym środowiskiem microsoft Dynamics 365 Business Central na Azure Container Instances.
Usługa Front Door z Container Instances i Application Gateway	Ten szablon tworzy usługę Front Door Standard/Premium z grupą kontenerów i Application Gateway.
Front Door Standard/Premium z Azure Container Instances	Ten szablon tworzy usługę Front Door Standard/Premium z grupą kontenerów.
Azure Container Instances — kontener z sondą kondycji	Wdróż kontener systemu Linux z sondą kondycji przy użyciu Azure Container Instances.
Azure Container Instances — kontener systemu Linux z publicznym adresem IP	Wdrażanie pojedynczego kontenera systemu Linux dostępnego za pośrednictwem publicznego adresu IP przy użyciu Azure Container Instances.
Azure Container Instances — kontener z bezpiecznym envVar	Wdróż kontener systemu Linux, który ma bezpieczną zmienną środowiskową przy użyciu Azure Container Instances.
Azure Container Instances — kontener systemu Linux z wartością emptyDir	Wdróż dwa kontenery systemu Linux współużytkujące wolumin emptyDir przy użyciu Azure Container Instances.
Azure Container Instances — kontener systemu Linux z usługą gitRepo	Wdróż kontener systemu Linux używający woluminu gitRepo przy użyciu Azure Container Instances.
Azure Container Instances — kontener z wpisami tajnymi	Wdróż kontener systemu Linux z woluminem tajnym przy użyciu Azure Container Instances.
Tworzenie serwera SFTP na żądanie z magazynem trwałym	Ten szablon przedstawia serwer SFTP na żądanie przy użyciu usługi Azure Container Instance (ACI).
Serwer SFTP na żądanie przy użyciu istniejącego konta magazynu	Ten szablon przedstawia serwer SFTP na żądanie przy użyciu usługi Azure Container Instance (ACI).
Tworzenie udziału plików konta magazynu za pośrednictwem kontenerów	Ten szablon tworzy konto magazynu i udział plików za pośrednictwem interfejsu wiersza polecenia platformy Azure w wystąpieniu kontenera
Kontener UDP w usłudze ACI	Te szablony tworzą zasób usługi ACI i uwidaczniają kontener za pośrednictwem protokołu UDP
Azure Container Instances — sieć wirtualna	Wdrażanie wystąpienia kontenera w sieci wirtualnej platformy Azure.
Tworzenie Application Gateway przy użyciu certyfikatów	Ten szablon pokazuje, jak wygenerować certyfikaty z podpisem własnym Key Vault, a następnie odwoływać się z Application Gateway.

Definicja zasobu szablonu usługi ARM

Typ zasobu containerGroups można wdrożyć z operacjami docelowymi:

Grupy zasobów — zobacz polecenia wdrażania grupy zasobów

Aby uzyskać listę zmienionych właściwości w każdej wersji interfejsu API, zobacz dziennik zmian.

Format zasobu

Aby utworzyć zasób Microsoft.ContainerInstance/containerGroups, dodaj następujący kod JSON do szablonu.

{
  "type": "Microsoft.ContainerInstance/containerGroups",
  "apiVersion": "2018-10-01",
  "name": "string",
  "location": "string",
  "tags": {
    "tagName1": "tagValue1",
    "tagName2": "tagValue2"
  },
  "identity": {
    "type": "string",
    "userAssignedIdentities": {}
  },
  "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": "[json('decimal-as-string')]"
            },
            "requests": {
              "cpu": "int",
              "gpu": {
                "count": "int",
                "sku": "string"
              },
              "memoryInGB": "[json('decimal-as-string')]"
            }
          },
          "volumeMounts": [
            {
              "mountPath": "string",
              "name": "string",
              "readOnly": "bool"
            }
          ]
        }
      }
    ],
    "diagnostics": {
      "logAnalytics": {
        "logType": "string",
        "metadata": {},
        "workspaceId": "string",
        "workspaceKey": "string"
      }
    },
    "dnsConfig": {
      "nameServers": [ "string" ],
      "options": "string",
      "searchDomains": "string"
    },
    "imageRegistryCredentials": [
      {
        "password": "string",
        "server": "string",
        "username": "string"
      }
    ],
    "ipAddress": {
      "dnsNameLabel": "string",
      "ip": "string",
      "ports": [
        {
          "port": "int",
          "protocol": "string"
        }
      ],
      "type": "string"
    },
    "networkProfile": {
      "id": "string"
    },
    "osType": "string",
    "restartPolicy": "string",
    "volumes": [
      {
        "azureFile": {
          "readOnly": "bool",
          "shareName": "string",
          "storageAccountKey": "string",
          "storageAccountName": "string"
        },
        "emptyDir": {},
        "gitRepo": {
          "directory": "string",
          "repository": "string",
          "revision": "string"
        },
        "name": "string",
        "secret": {}
      }
    ]
  }
}

Wartości właściwości

containerGroups

Nazwa	Opis	Wartość
typ	Typ zasobu	"Microsoft.ContainerInstance/containerGroups"
apiVersion	Wersja interfejsu API zasobów	'2018-10-01'
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
tags	Tagi zasobów.	Słownik nazw tagów i wartości. Zobacz Tagi w szablonach
identity	Tożsamość grupy kontenerów, jeśli została skonfigurowana.	KontenerGroupIdentity
properties		ContainerGroupProperties (wymagane)

KontenerGroupIdentity

Nazwa	Opis	Wartość
typ	Typ tożsamości używanej 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 usługi ARM w postaci: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}".	object

ContainerGroupProperties

Nazwa	Opis	Wartość
containers	Kontenery w grupie kontenerów.	Kontener[] (wymagany)
Diagnostyka	Informacje diagnostyczne dla grupy kontenerów.	ContainerGroupDiagnostics
dnsConfig	Informacje o konfiguracji DNS dla grupy kontenerów.	Konfiguracja dns
imageRegistryCredentials	Poświadczenia rejestru obrazów, na podstawie których jest tworzona grupa kontenerów.	ImageRegistryCredential[]
Ipaddress	Typ adresu IP grupy kontenerów.	Ipaddress
networkProfile	Informacje o profilu sieciowym dla grupy kontenerów.	ContainerGroupNetworkProfile
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. - `Always` Zawsze uruchamiaj ponownie - `OnFailure` Ponowne uruchamianie po awarii - `Never` Nigdy nie uruchamiaj ponownie	"Zawsze" "Nigdy" "OnFailure"
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)
livenessProbe	Sonda liveness.	ContainerProbe
ports	Uwidocznione porty w wystąpieniu kontenera.	ContainerPort[]
gotowośćProbe	Sonda gotowości.	ContainerProbe
zasoby	Wymagania dotyczące zasobów wystąpienia kontenera.	Wymagania dotyczące zasobów (wymagane)
volumeMounts	Wolumin jest dostępny dla wystąpienia kontenera.	VolumeMount[]

EnvironmentVariable

Nazwa	Opis	Wartość
name	Nazwa zmiennej środowiskowej.	ciąg (wymagany)
secureValue	Wartość bezpiecznej zmiennej środowiskowej.	ciąg
wartość	Wartość zmiennej środowiskowej.	ciąg

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

ContainerExec

Nazwa	Opis	Wartość
command	Polecenia do wykonania w kontenerze.	ciąg[]

ContainerHttpGet

Nazwa	Opis	Wartość
path	Ścieżka do sondy.	ciąg
port	Numer portu do sondy.	int (wymagane)
schemat	Schemat.	"http" "https"

ContainerPort

Nazwa	Opis	Wartość
port	Numer portu uwidoczniony w grupie kontenerów.	int (wymagane)
Protokół	Protokół skojarzony z portem.	"TCP" "UDP"

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
Gpu	Limit procesora GPU tego wystąpienia kontenera.	GpuResource
memoryInGB	Limit pamięci w GB tego wystąpienia kontenera. Aby określić wartość dziesiętną, użyj funkcji json().	int lub json dziesiętne

GpuResource

Nazwa	Opis	Wartość
count	Liczba zasobów procesora GPU.	int (wymagane)
sku	Jednostka SKU zasobu procesora GPU.	"K80" "P100" "V100" (wymagane)

ResourceRequests

Nazwa	Opis	Wartość
Procesora	Żą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. 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

ContainerGroupDiagnostics

Nazwa	Opis	Wartość
logAnalytics	Informacje o usłudze Log Analytics grupy kontenerów.	LogAnalytics

LogAnalytics

Nazwa	Opis	Wartość
logType	Typ dziennika do użycia.	"ContainerInsights" "ContainerInstanceLogs"
metadane	Metadane analizy dzienników.	object
workspaceId	Identyfikator obszaru roboczego do analizy dzienników	ciąg (wymagany)
workspaceKey	Klucz obszaru roboczego do analizy dzienników	ciąg (wymagany)

Konfiguracja dns

Nazwa	Opis	Wartość
Nameservers	Serwery DNS dla grupy kontenerów.	string[] (wymagane)
opcje	Opcje DNS dla grupy kontenerów.	ciąg
searchDomains	Domeny wyszukiwania DNS dla wyszukiwania nazw hostów w grupie kontenerów.	ciąg

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ść
dnsNameLabel	Etykieta nazwy DNS dla adresu IP.	ciąg
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 publicznej sieci wirtualnej lub prywatnej sieci wirtualnej.	"Prywatne" "Publiczny" (wymagany)

Port

Nazwa	Opis	Wartość
port	Numer portu.	int (wymagane)
Protokół	Protokół skojarzony z portem.	"TCP" "UDP"

ContainerGroupNetworkProfile

Nazwa	Opis	Wartość
identyfikator	Identyfikator profilu sieciowego.	ciąg (wymagany)

Wolumin

Nazwa	Opis	Wartość
azureFile	Wolumin usługi Azure File.	AzureFileVolume
emptyDir	Pusty wolumin katalogu.
gitRepo	Wolumin repozytorium git.	GitRepoVolume
name	Nazwa woluminu.	ciąg (wymagany)
wpis tajny	Wolumin tajny.	object

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)

GitRepoVolume

Nazwa	Opis	Wartość
katalog	Nazwa katalogu docelowego. Nie może zawierać ani rozpoczynać się od '..'. Jeśli parametr "." 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.	ciąg
repozytorium	Adres URL repozytorium	ciąg (wymagany)
revision	Zatwierdź skrót dla określonej poprawki.	ciąg

Szablony szybkiego startu

Następujące szablony szybkiego startu wdrażają ten typ zasobu.

Template	Opis
SQL Server grupy dostępności w usłudze AKS	Spowoduje to utworzenie nowego klastra usługi AKS, a następnie wdrożenie w nim SQL Server grup dostępności przy użyciu pakietu CNAB wdrożonego przy użyciu rozwiązań Duffle i ACI
Tworzenie witryny WordPress	Ten szablon tworzy witrynę WordPress w wystąpieniu kontenera
Tworzenie witryny WordPress w sieci wirtualnej	Ten szablon tworzy witrynę WordPress w wystąpieniu kontenera w sieci wirtualnej. Wyprowadź również nazwę FQDN witryny publicznej, która może uzyskać dostęp do witryny WordPress.
Azure Container Instances — bc with SQL Server and IIS	Wdróż pojedynczy kontener systemu Windows z w pełni funkcjonalnym własnym środowiskiem microsoft Dynamics 365 Business Central w Azure Container Instances.
Usługa Front Door z Container Instances i Application Gateway	Ten szablon tworzy usługę Front Door Standard/Premium z grupą kontenerów i Application Gateway.
Front Door Standard/Premium z Azure Container Instances	Ten szablon tworzy usługę Front Door Standard/Premium z grupą kontenerów.
Azure Container Instances — kontener z sondą kondycji	Wdróż kontener systemu Linux z sondą kondycji przy użyciu Azure Container Instances.
Azure Container Instances — kontener systemu Linux z publicznym adresem IP	Wdróż pojedynczy kontener systemu Linux dostępny za pośrednictwem publicznego adresu IP przy użyciu Azure Container Instances.
Azure Container Instances — kontener z bezpiecznym envVar	Wdróż kontener systemu Linux, który ma bezpieczną zmienną środowiskową przy użyciu Azure Container Instances.
Azure Container Instances — kontener systemu Linux z wartością emptyDir	Wdróż dwa kontenery systemu Linux współużytkujące wolumin emptyDir przy użyciu Azure Container Instances.
Azure Container Instances — kontener systemu Linux z usługą gitRepo	Wdróż kontener systemu Linux używający woluminu gitRepo przy użyciu Azure Container Instances.
Azure Container Instances — kontener z wpisami tajnymi	Wdróż kontener systemu Linux z woluminem tajnym przy użyciu Azure Container Instances.
Tworzenie serwera SFTP na żądanie z magazynem trwałym	Ten szablon przedstawia serwer SFTP na żądanie przy użyciu usługi Azure Container Instance (ACI).
Serwer SFTP na żądanie przy użyciu istniejącego konta magazynu	Ten szablon przedstawia serwer SFTP na żądanie przy użyciu usługi Azure Container Instance (ACI).
Tworzenie udziału plików konta magazynu za pośrednictwem kontenerów	Ten szablon tworzy konto magazynu i udział plików za pośrednictwem interfejsu wiersza polecenia platformy Azure w wystąpieniu kontenera
Kontener UDP w usłudze ACI	Te szablony tworzą zasób usługi ACI i uwidaczniają kontener za pośrednictwem protokołu UDP
Azure Container Instances — sieć wirtualna	Wdrażanie wystąpienia kontenera w sieci wirtualnej platformy Azure.
Tworzenie Application Gateway przy użyciu certyfikatów	Ten szablon pokazuje, jak wygenerować certyfikaty z podpisem własnym Key Vault, a następnie odwoływać się z Application Gateway.

Definicja zasobu narzędzia Terraform (dostawcy AzAPI)

Typ zasobu containerGroups można wdrożyć z operacjami docelowymi:

Grupy zasobów

Aby uzyskać listę zmienionych właściwości w każdej wersji interfejsu API, zobacz dziennik zmian.

Format zasobu

Aby utworzyć zasób Microsoft.ContainerInstance/containerGroups, dodaj następujący element Terraform do szablonu.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.ContainerInstance/containerGroups@2018-10-01"
  name = "string"
  location = "string"
  parent_id = "string"
  tags = {
    tagName1 = "tagValue1"
    tagName2 = "tagValue2"
  }
  identity {
    type = "string"
    identity_ids = []
  }
  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 = "decimal-as-string"
              }
              requests = {
                cpu = int
                gpu = {
                  count = int
                  sku = "string"
                }
                memoryInGB = "decimal-as-string"
              }
            }
            volumeMounts = [
              {
                mountPath = "string"
                name = "string"
                readOnly = bool
              }
            ]
          }
        }
      ]
      diagnostics = {
        logAnalytics = {
          logType = "string"
          metadata = {}
          workspaceId = "string"
          workspaceKey = "string"
        }
      }
      dnsConfig = {
        nameServers = [
          "string"
        ]
        options = "string"
        searchDomains = "string"
      }
      imageRegistryCredentials = [
        {
          password = "string"
          server = "string"
          username = "string"
        }
      ]
      ipAddress = {
        dnsNameLabel = "string"
        ip = "string"
        ports = [
          {
            port = int
            protocol = "string"
          }
        ]
        type = "string"
      }
      networkProfile = {
        id = "string"
      }
      osType = "string"
      restartPolicy = "string"
      volumes = [
        {
          azureFile = {
            readOnly = bool
            shareName = "string"
            storageAccountKey = "string"
            storageAccountName = "string"
          }
          gitRepo = {
            directory = "string"
            repository = "string"
            revision = "string"
          }
          name = "string"
          secret = {}
        }
      ]
    }
  })
}

Wartości właściwości

containerGroups

Nazwa	Opis	Wartość
typ	Typ zasobu	"Microsoft.ContainerInstance/containerGroups@2018-10-01"
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
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.
identity	Tożsamość grupy kontenerów, jeśli została skonfigurowana.	KontenerGroupIdentity
properties		ContainerGroupProperties (wymagane)

KontenerGroupIdentity

Nazwa	Opis	Wartość
typ	Typ tożsamości używanej 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 "None" usunie wszystkie tożsamości z grupy kontenerów.	"SystemAssigned" "SystemAssigned, UserAssigned" "UserAssigned"
identity_ids	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 usługi ARM w postaci: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}".	Tablica identyfikatorów tożsamości użytkowników.

ContainerGroupProperties

Nazwa	Opis	Wartość
containers	Kontenery w grupie kontenerów.	Kontener[] (wymagany)
Diagnostyka	Informacje diagnostyczne dla grupy kontenerów.	ContainerGroupDiagnostics
dnsConfig	Informacje o konfiguracji DNS dla grupy kontenerów.	Konfiguracja dns
imageRegistryCredentials	Poświadczenia rejestru obrazów, na podstawie których jest tworzona grupa kontenerów.	ImageRegistryCredential[]
Ipaddress	Typ adresu IP grupy kontenerów.	Ipaddress
networkProfile	Informacje o profilu sieciowym 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 uruchamianie po awarii - `Never` Nigdy nie uruchamiaj ponownie	"Zawsze" "Nigdy" "OnFailure"
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)
livenessProbe	Sonda liveness.	ContainerProbe
ports	Uwidocznione porty w wystąpieniu kontenera.	ContainerPort[]
gotowośćProbe	Sonda gotowości.	ContainerProbe
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)
secureValue	Wartość bezpiecznej zmiennej środowiskowej.	ciąg
wartość	Wartość zmiennej środowiskowej.	ciąg

ContainerProbe

Nazwa	Opis	Wartość
Exec	Polecenie wykonywania sondy	ContainerExec
failureThreshold	Próg awarii.	int
httpGet	Ustawienia Pobierania http do sondy	ContainerHttpGet
initialDelaySeconds	Początkowe opóźnienie sekund.	int
periodSeconds	W sekundach okresu.	int
successThreshold	Próg powodzenia.	int
timeoutSeconds	Limit czasu sekund.	int

ContainerExec

Nazwa	Opis	Wartość
command	Polecenia do wykonania w kontenerze.	ciąg[]

ContainerHttpGet

Nazwa	Opis	Wartość
path	Ścieżka do sondy.	ciąg
port	Numer portu do sondy.	int (wymagane)
schemat	Schemat.	"http" "https"

ContainerPort

Nazwa	Opis	Wartość
port	Numer portu uwidoczniony w grupie kontenerów.	int (wymagane)
Protokół	Protokół skojarzony z portem.	"TCP" "UDP"

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
Gpu	Limit procesora GPU tego wystąpienia kontenera.	GpuResource
memoryInGB	Limit pamięci w GB tego wystąpienia kontenera. Określ wartość dziesiętną jako ciąg.	int lub json dziesiętne

GpuResource

Nazwa	Opis	Wartość
count	Liczba zasobów procesora GPU.	int (wymagane)
sku	Jednostka SKU zasobu procesora GPU.	"K80" "P100" "V100" (wymagane)

ResourceRequests

Nazwa	Opis	Wartość
Procesora	Żą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. Określ wartość dziesiętną jako ciąg.	liczba dziesiętna int 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

ContainerGroupDiagnostics

Nazwa	Opis	Wartość
logAnalytics	Informacje analizy dzienników grupy kontenerów.	LogAnalytics

LogAnalytics

Nazwa	Opis	Wartość
logType	Typ dziennika, który ma być używany.	"ContainerInsights" "ContainerInstanceLogs"
metadane	Metadane analizy dzienników.	object
workspaceId	Identyfikator obszaru roboczego dla usługi Log Analytics	ciąg (wymagany)
workspaceKey	Klucz obszaru roboczego na potrzeby analizy dzienników	ciąg (wymagany)

Konfiguracja dns

Nazwa	Opis	Wartość
Nameservers	Serwery DNS dla grupy kontenerów.	string[] (wymagane)
opcje	Opcje DNS dla grupy kontenerów.	ciąg
searchDomains	Domeny wyszukiwania DNS dla wyszukiwania nazwy hosta w grupie kontenerów.	ciąg

ImageRegistryCredential

Nazwa	Opis	Wartość
hasło	Hasło do 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ść
dnsNameLabel	Etykieta nazwy DNS dla adresu IP.	ciąg
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 publicznej sieci internetowej lub prywatnej sieci wirtualnej.	"Prywatny" "Publiczne" (wymagane)

Port

Nazwa	Opis	Wartość
port	Numer portu.	int (wymagane)
Protokół	Protokół skojarzony z portem.	"TCP" "UDP"

ContainerGroupNetworkProfile

Nazwa	Opis	Wartość
identyfikator	Identyfikator profilu sieciowego.	ciąg (wymagany)

Wolumin

Nazwa	Opis	Wartość
azureFile	Wolumin usługi Azure File.	AzureFileVolume
emptyDir	Pusty wolumin katalogu.
gitRepo	Wolumin repozytorium git.	GitRepoVolume
name	Nazwa woluminu.	ciąg (wymagany)
wpis tajny	Wolumin tajny.	object

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 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)

GitRepoVolume

Nazwa	Opis	Wartość
katalog	Nazwa katalogu docelowego. Nie może zawierać ani rozpoczynać się od '..'. Jeśli parametr "." 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.	ciąg
repozytorium	Adres URL repozytorium	ciąg (wymagany)
revision	Zatwierdź skrót dla określonej poprawki.	ciąg

Udostępnij za pośrednictwem

Microsoft.ContainerInstance containerGroups 2018-10-01

Definicja zasobu Bicep

Format zasobu

Wartości właściwości

containerGroups

KontenerGroupIdentity

ContainerGroupProperties

Kontener

Właściwości kontenera

EnvironmentVariable

ContainerProbe

ContainerExec

ContainerHttpGet

ContainerPort

Wymagania dotyczące zasobów

ResourceLimits

GpuResource

ResourceRequests

VolumeMount

ContainerGroupDiagnostics

LogAnalytics

Konfiguracja dns

ImageRegistryCredential

Ipaddress

Port

ContainerGroupNetworkProfile

Wolumin

AzureFileVolume

GitRepoVolume

Szablony szybkiego startu

Definicja zasobu szablonu usługi ARM

Format zasobu

Wartości właściwości

containerGroups

KontenerGroupIdentity

ContainerGroupProperties

Kontener

Właściwości kontenera

EnvironmentVariable

ContainerProbe

ContainerExec

ContainerHttpGet

ContainerPort

Wymagania dotyczące zasobów

ZasobyLimity

GpuResource

ResourceRequests

VolumeMount

ContainerGroupDiagnostics

LogAnalytics

Konfiguracja dns

ImageRegistryCredential

Ipaddress

Port

ContainerGroupNetworkProfile

Wolumin

AzureFileVolume

GitRepoVolume

Szablony szybkiego startu

Definicja zasobu narzędzia Terraform (dostawcy AzAPI)

Format zasobu

Wartości właściwości

containerGroups

KontenerGroupIdentity

ContainerGroupProperties

Kontener

Właściwości kontenera

EnvironmentVariable

ContainerProbe

ContainerExec

ContainerHttpGet

ContainerPort

Wymagania dotyczące zasobów

ZasobyLimity

GpuResource

ResourceRequests

VolumeMount

ContainerGroupDiagnostics

LogAnalytics