Udostępnij przez


Microsoft.ContainerInstance containerGroups 2017-12-01-wersja zapoznawcza

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.

Format zasobu

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

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

Wartości właściwości

Microsoft.ContainerInstance/containerGroups (Grupy Kontenerów)

Nazwa Opis Wartość
lokalizacja Lokalizacja zasobu. ciąg (wymagany)
nazwa Nazwa zasobu ciąg (wymagany)
Właściwości ContainerGroupProperties (wymagane)
zakres Użyj polecenia podczas tworzenia zasobu w zakresie innym niż zakres wdrożenia. Ustaw tę właściwość na symboliczną nazwę zasobu, aby zastosować zasób rozszerzenia.
Tagi Tagi zasobów Słownik nazw tagów i wartości. Zobacz tagi w szablonach

AzureFileVolume (Wolumin Pliku)

Nazwa Opis Wartość
readOnly (tylko do odczytu) Flaga wskazująca, czy udostępniony plik platformy Azure zainstalowany jako wolumin jest tylko do odczytu. Bool
NazwaUdostępnienia Nazwa udziału plików platformy Azure, który ma zostać zainstalowany jako wolumin. ciąg (wymagany)
kluczKontaPrzechowywania Klucz dostępu konta magazynu używany do uzyskiwania dostępu do udziału plików platformy Azure. ciąg
nazwaKontaPrzechowywania Nazwa konta magazynu zawierającego udział plików platformy Azure. ciąg (wymagany)

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)

ContainerGroupProperties (Właściwości grupy kontenerów)

Nazwa Opis Wartość
Pojemniki Kontenery w grupie kontenerów. Container[] (wymagane)
imageRegistryCredentials (Dane uwierzytelniające imageRegistryCredentials) Poświadczenia rejestru obrazów, na podstawie których jest tworzona grupa kontenerów. Poświadczenie ImageRegistry[]
adres IP Typ adresu IP grupy kontenerów. IpAddress
osType (typ systemu) Typ systemu operacyjnego wymagany przez kontenery w grupie kontenerów. "Linux"
"Windows" (wymagane)
zasadaPonownegoUruchamiania 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"
Woluminów Lista woluminów, które mogą być instalowane przez kontenery w tej grupie kontenerów. woluminu[]

KontenerPort (ContainerPort)

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

Właściwości Kontenera

Nazwa Opis Wartość
polecenie Polecenia do wykonania w ramach wystąpienia kontenera w formularzu exec. ciąg znakowy[]
zmienne środowiskowe Zmienne środowiskowe do ustawienia w wystąpieniu kontenera. Zmienna środowiskowa[]
obraz Nazwa obrazu użytego do utworzenia wystąpienia kontenera. ciąg (wymagany)
Porty Uwidocznione porty w wystąpieniu kontenera. KontenerPort[]
zasoby Wymagania dotyczące zasobów wystąpienia kontenera. ResourceRequirements (wymagane)
WoluminInstalacje Woluminy są montowane w wystąpieniu kontenera. volumeMount[]

Zmienna środowiskowa

Nazwa Opis Wartość
nazwa Nazwa zmiennej środowiskowej. ciąg (wymagany)
wartość Wartość zmiennej środowiskowej. ciąg (wymagany)

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. ciąg
repozytorium Adres URL repozytorium ciąg (wymagany)
rewizja Zatwierdź skrót dla określonej poprawki. ciąg

Poświadczenia 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)

Adresy IP

Nazwa Opis Wartość
Ip Adres IP uwidoczniony w publicznym Internecie. ciąg
Porty Lista portów uwidocznionych w grupie kontenerów. port[] (wymagane)
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"

ZasobyLimits

Nazwa Opis Wartość
procesor Limit procesora CPU dla tego wystąpienia kontenera. Int
memoryInGB (pamięć w GB) Limit pamięci w GB tego wystąpienia kontenera. Int

ResourceRequests

Nazwa Opis Wartość
procesor Żądanie procesora CPU tego wystąpienia kontenera. int (wymagane)
memoryInGB (pamięć w GB) Żą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. ZasobyLimits
Żądania Zasób żąda tego wystąpienia kontenera. ResourceRequests (wymagane)

Tagi zasobów

Nazwa Opis Wartość

Wolumin tajny

Nazwa Opis Wartość

Głośność

Nazwa Opis Wartość
azureFile (plik azure) Wolumin usługi Azure File. AzureFileVolume (Wolumin Pliku)
emptyDir (pusty katalog) Pusty wolumin katalogu. jakikolwiek
gitRepo Wolumin repozytorium git. GitRepoVolume
nazwa Nazwa woluminu. ciąg (wymagany)
klucz tajny Wolumin tajny. Wolumin tajny

WoluminMount

Nazwa Opis Wartość
mountPath (ścieżka montowania) Ś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 (tylko do odczytu) 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.

Moduł Opis
wystąpienia kontenera Moduł zasobów AVM dla wystąpienia kontenera

Przykłady szybkiego startu platformy Azure

Poniższe szablony szybkiego startu platformy Azure zawierają przykłady Bicep na potrzeby wdrażania tego typu zasobu.

Plik Bicep Opis
Azure Container Instances — bc with SQL Server and IIS Wdróż pojedynczy kontener systemu Windows z w pełni funkcjonalnym autonomicznym środowiskiem usługi Microsoft Dynamics 365 Business Central w usłudze Azure Container Instances.
Azure Container Instances — kontener z wpisami tajnymi Wdróż kontener systemu Linux z woluminem tajnym przy użyciu usługi 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 usługi Azure Container Instances.
Azure Container Instances — sieci wirtualnej Wdrażanie wystąpienia kontenera w sieci wirtualnej platformy Azure.
Tworzenie witryny WordPress Ten szablon tworzy witrynę WordPress w wystąpieniu kontenera
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).
tworzenie usługi Application Gateway przy użyciu certyfikatów Ten szablon przedstawia sposób generowania certyfikatów z podpisem własnym usługi Key Vault, a następnie odwołania z usługi Application Gateway.
usługi Front Door Standard/Premium z usługą Azure Container Instances Ten szablon tworzy usługę Front Door Standard/Premium z grupą kontenerów.
usługi Front Door z wystąpieniami kontenerów i usługą Application Gateway Ten szablon tworzy usługę Front Door Standard/Premium z grupą kontenerów i usługą Application Gateway.
grupy dostępności programu SQL Server w usłudze AKS Spowoduje to utworzenie nowego klastra usługi AKS, a następnie wdrożenie w nim grup dostępności programu SQL Server przy użyciu pakietu CNAB wdrożonego przy użyciu rozwiązań Duffle i ACI

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.

Format zasobu

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

{
  "type": "Microsoft.ContainerInstance/containerGroups",
  "apiVersion": "2017-12-01-preview",
  "name": "string",
  "location": "string",
  "properties": {
    "containers": [
      {
        "name": "string",
        "properties": {
          "command": [ "string" ],
          "environmentVariables": [
            {
              "name": "string",
              "value": "string"
            }
          ],
          "image": "string",
          "ports": [
            {
              "port": "int",
              "protocol": "string"
            }
          ],
          "resources": {
            "limits": {
              "cpu": "int",
              "memoryInGB": "int"
            },
            "requests": {
              "cpu": "int",
              "memoryInGB": "int"
            }
          },
          "volumeMounts": [
            {
              "mountPath": "string",
              "name": "string",
              "readOnly": "bool"
            }
          ]
        }
      }
    ],
    "imageRegistryCredentials": [
      {
        "password": "string",
        "server": "string",
        "username": "string"
      }
    ],
    "ipAddress": {
      "ip": "string",
      "ports": [
        {
          "port": "int",
          "protocol": "string"
        }
      ],
      "type": "string"
    },
    "osType": "string",
    "restartPolicy": "string",
    "volumes": [
      {
        "azureFile": {
          "readOnly": "bool",
          "shareName": "string",
          "storageAccountKey": "string",
          "storageAccountName": "string"
        },
        "emptyDir": {},
        "gitRepo": {
          "directory": "string",
          "repository": "string",
          "revision": "string"
        },
        "name": "string",
        "secret": {
          "{customized property}": "string"
        }
      }
    ]
  },
  "tags": {
    "{customized property}": "string"
  }
}

Wartości właściwości

Microsoft.ContainerInstance/containerGroups (Grupy Kontenerów)

Nazwa Opis Wartość
apiVersion (wersja interfejsu api) Wersja interfejsu API "2017-12-01-preview"
lokalizacja Lokalizacja zasobu. ciąg (wymagany)
nazwa Nazwa zasobu ciąg (wymagany)
Właściwości ContainerGroupProperties (wymagane)
Tagi Tagi zasobów Słownik nazw tagów i wartości. Zobacz tagi w szablonach
typ Typ zasobu "Microsoft.ContainerInstance/containerGroups"

AzureFileVolume (Wolumin Pliku)

Nazwa Opis Wartość
readOnly (tylko do odczytu) Flaga wskazująca, czy udostępniony plik platformy Azure zainstalowany jako wolumin jest tylko do odczytu. Bool
NazwaUdostępnienia Nazwa udziału plików platformy Azure, który ma zostać zainstalowany jako wolumin. ciąg (wymagany)
kluczKontaPrzechowywania Klucz dostępu konta magazynu używany do uzyskiwania dostępu do udziału plików platformy Azure. ciąg
nazwaKontaPrzechowywania Nazwa konta magazynu zawierającego udział plików platformy Azure. ciąg (wymagany)

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)

ContainerGroupProperties (Właściwości grupy kontenerów)

Nazwa Opis Wartość
Pojemniki Kontenery w grupie kontenerów. Container[] (wymagane)
imageRegistryCredentials (Dane uwierzytelniające imageRegistryCredentials) Poświadczenia rejestru obrazów, na podstawie których jest tworzona grupa kontenerów. Poświadczenie ImageRegistry[]
adres IP Typ adresu IP grupy kontenerów. IpAddress
osType (typ systemu) Typ systemu operacyjnego wymagany przez kontenery w grupie kontenerów. "Linux"
"Windows" (wymagane)
zasadaPonownegoUruchamiania 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"
Woluminów Lista woluminów, które mogą być instalowane przez kontenery w tej grupie kontenerów. woluminu[]

KontenerPort (ContainerPort)

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

Właściwości Kontenera

Nazwa Opis Wartość
polecenie Polecenia do wykonania w ramach wystąpienia kontenera w formularzu exec. ciąg znakowy[]
zmienne środowiskowe Zmienne środowiskowe do ustawienia w wystąpieniu kontenera. Zmienna środowiskowa[]
obraz Nazwa obrazu użytego do utworzenia wystąpienia kontenera. ciąg (wymagany)
Porty Uwidocznione porty w wystąpieniu kontenera. KontenerPort[]
zasoby Wymagania dotyczące zasobów wystąpienia kontenera. ResourceRequirements (wymagane)
WoluminInstalacje Woluminy są montowane w wystąpieniu kontenera. volumeMount[]

Zmienna środowiskowa

Nazwa Opis Wartość
nazwa Nazwa zmiennej środowiskowej. ciąg (wymagany)
wartość Wartość zmiennej środowiskowej. ciąg (wymagany)

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. ciąg
repozytorium Adres URL repozytorium ciąg (wymagany)
rewizja Zatwierdź skrót dla określonej poprawki. ciąg

Poświadczenia 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)

Adresy IP

Nazwa Opis Wartość
Ip Adres IP uwidoczniony w publicznym Internecie. ciąg
Porty Lista portów uwidocznionych w grupie kontenerów. port[] (wymagane)
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"

ZasobyLimits

Nazwa Opis Wartość
procesor Limit procesora CPU dla tego wystąpienia kontenera. Int
memoryInGB (pamięć w GB) Limit pamięci w GB tego wystąpienia kontenera. Int

ResourceRequests

Nazwa Opis Wartość
procesor Żądanie procesora CPU tego wystąpienia kontenera. int (wymagane)
memoryInGB (pamięć w GB) Żą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. ZasobyLimits
Żądania Zasób żąda tego wystąpienia kontenera. ResourceRequests (wymagane)

Tagi zasobów

Nazwa Opis Wartość

Wolumin tajny

Nazwa Opis Wartość

Głośność

Nazwa Opis Wartość
azureFile (plik azure) Wolumin usługi Azure File. AzureFileVolume (Wolumin Pliku)
emptyDir (pusty katalog) Pusty wolumin katalogu. jakikolwiek
gitRepo Wolumin repozytorium git. GitRepoVolume
nazwa Nazwa woluminu. ciąg (wymagany)
klucz tajny Wolumin tajny. Wolumin tajny

WoluminMount

Nazwa Opis Wartość
mountPath (ścieżka montowania) Ś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 (tylko do odczytu) 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.

Szablon Opis
Azure Container Instances — bc with SQL Server and IIS

wdrażanie w usłudze Azure
Wdróż pojedynczy kontener systemu Windows z w pełni funkcjonalnym autonomicznym środowiskiem usługi Microsoft Dynamics 365 Business Central w usłudze Azure Container Instances.
Azure Container Instances — kontener z sondą kondycji

wdrażanie w usłudze Azure
Wdróż kontener systemu Linux z sondą kondycji przy użyciu usługi Azure Container Instances.
Azure Container Instances — kontener z wpisami tajnymi

wdrażanie w usłudze Azure
Wdróż kontener systemu Linux z woluminem tajnym przy użyciu usługi Azure Container Instances.
Azure Container Instances — kontener z bezpiecznymi envVar

wdrażanie w usłudze Azure
Wdróż kontener systemu Linux, który ma bezpieczną zmienną środowiskową przy użyciu usługi Azure Container Instances.
Azure Container Instances — kontener systemu Linux z pustym

wdrażanie w usłudze Azure
Wdróż dwa kontenery systemu Linux, które współdzielą wolumin emptyDir przy użyciu usługi Azure Container Instances.
Azure Container Instances — kontener systemu Linux z usługą gitRepo

wdrażanie w usłudze Azure
Wdróż kontener systemu Linux, który używa woluminu gitRepo przy użyciu usługi Azure Container Instances.
Azure Container Instances — kontener systemu Linux z publicznym adresem IP

wdrażanie w usłudze Azure
Wdrażanie pojedynczego kontenera systemu Linux dostępnego za pośrednictwem publicznego adresu IP przy użyciu usługi Azure Container Instances.
Azure Container Instances — sieci wirtualnej

wdrażanie w usłudze Azure
Wdrażanie wystąpienia kontenera w sieci wirtualnej platformy Azure.
tworzenie udziału plików konta magazynu za pośrednictwem kontenerów

wdrażanie w usłudze Azure
Ten szablon tworzy konto magazynu i udział plików za pośrednictwem interfejsu wiersza polecenia platformy Azure w wystąpieniu kontenera
Tworzenie witryny WordPress

wdrażanie w usłudze Azure
Ten szablon tworzy witrynę WordPress w wystąpieniu kontenera
Tworzenie witryny WordPress w sieci wirtualnej

wdrażanie w usłudze Azure
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.
Tworzenie serwera SFTP na żądanie z magazynem trwałym

wdrażanie w usłudze Azure
Ten szablon przedstawia serwer SFTP na żądanie przy użyciu usługi Azure Container Instance (ACI).
tworzenie usługi Application Gateway przy użyciu certyfikatów

wdrażanie w usłudze Azure
Ten szablon przedstawia sposób generowania certyfikatów z podpisem własnym usługi Key Vault, a następnie odwołania z usługi Application Gateway.
usługi Front Door Standard/Premium z usługą Azure Container Instances

wdrażanie w usłudze Azure
Ten szablon tworzy usługę Front Door Standard/Premium z grupą kontenerów.
usługi Front Door z wystąpieniami kontenerów i usługą Application Gateway

wdrażanie w usłudze Azure
Ten szablon tworzy usługę Front Door Standard/Premium z grupą kontenerów i usługą Application Gateway.
serwer SFTP na żądanie przy użyciu istniejącego konta magazynu

wdrażanie w usłudze Azure
Ten szablon przedstawia serwer SFTP na żądanie przy użyciu usługi Azure Container Instance (ACI).
grupy dostępności programu SQL Server w usłudze AKS

wdrażanie w usłudze Azure
Spowoduje to utworzenie nowego klastra usługi AKS, a następnie wdrożenie w nim grup dostępności programu SQL Server przy użyciu pakietu CNAB wdrożonego przy użyciu rozwiązań Duffle i ACI
Kontener UDP w usłudze ACI

wdrażanie w usłudze Azure
Te szablony tworzą zasób ACI i uwidaczniają kontener za pośrednictwem protokołu UDP

Definicja zasobu narzędzia Terraform (dostawcy AzAPI)

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.

Format zasobu

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

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.ContainerInstance/containerGroups@2017-12-01-preview"
  name = "string"
  parent_id = "string"
  location = "string"
  tags = {
    {customized property} = "string"
  }
  body = {
    properties = {
      containers = [
        {
          name = "string"
          properties = {
            command = [
              "string"
            ]
            environmentVariables = [
              {
                name = "string"
                value = "string"
              }
            ]
            image = "string"
            ports = [
              {
                port = int
                protocol = "string"
              }
            ]
            resources = {
              limits = {
                cpu = int
                memoryInGB = int
              }
              requests = {
                cpu = int
                memoryInGB = int
              }
            }
            volumeMounts = [
              {
                mountPath = "string"
                name = "string"
                readOnly = bool
              }
            ]
          }
        }
      ]
      imageRegistryCredentials = [
        {
          password = "string"
          server = "string"
          username = "string"
        }
      ]
      ipAddress = {
        ip = "string"
        ports = [
          {
            port = int
            protocol = "string"
          }
        ]
        type = "string"
      }
      osType = "string"
      restartPolicy = "string"
      volumes = [
        {
          azureFile = {
            readOnly = bool
            shareName = "string"
            storageAccountKey = "string"
            storageAccountName = "string"
          }
          emptyDir = ?
          gitRepo = {
            directory = "string"
            repository = "string"
            revision = "string"
          }
          name = "string"
          secret = {
            {customized property} = "string"
          }
        }
      ]
    }
  }
}

Wartości właściwości

Microsoft.ContainerInstance/containerGroups (Grupy Kontenerów)

Nazwa Opis Wartość
lokalizacja Lokalizacja zasobu. ciąg (wymagany)
nazwa Nazwa zasobu ciąg (wymagany)
parent_id Identyfikator zasobu, do który ma być stosowany ten zasób rozszerzenia. ciąg (wymagany)
Właściwości ContainerGroupProperties (wymagane)
Tagi Tagi zasobów Słownik nazw tagów i wartości.
typ Typ zasobu "Microsoft.ContainerInstance/containerGroups@2017-12-01-preview"

AzureFileVolume (Wolumin Pliku)

Nazwa Opis Wartość
readOnly (tylko do odczytu) Flaga wskazująca, czy udostępniony plik platformy Azure zainstalowany jako wolumin jest tylko do odczytu. Bool
NazwaUdostępnienia Nazwa udziału plików platformy Azure, który ma zostać zainstalowany jako wolumin. ciąg (wymagany)
kluczKontaPrzechowywania Klucz dostępu konta magazynu używany do uzyskiwania dostępu do udziału plików platformy Azure. ciąg
nazwaKontaPrzechowywania Nazwa konta magazynu zawierającego udział plików platformy Azure. ciąg (wymagany)

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)

ContainerGroupProperties (Właściwości grupy kontenerów)

Nazwa Opis Wartość
Pojemniki Kontenery w grupie kontenerów. Container[] (wymagane)
imageRegistryCredentials (Dane uwierzytelniające imageRegistryCredentials) Poświadczenia rejestru obrazów, na podstawie których jest tworzona grupa kontenerów. Poświadczenie ImageRegistry[]
adres IP Typ adresu IP grupy kontenerów. IpAddress
osType (typ systemu) Typ systemu operacyjnego wymagany przez kontenery w grupie kontenerów. "Linux"
"Windows" (wymagane)
zasadaPonownegoUruchamiania 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"
Woluminów Lista woluminów, które mogą być instalowane przez kontenery w tej grupie kontenerów. woluminu[]

KontenerPort (ContainerPort)

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

Właściwości Kontenera

Nazwa Opis Wartość
polecenie Polecenia do wykonania w ramach wystąpienia kontenera w formularzu exec. ciąg znakowy[]
zmienne środowiskowe Zmienne środowiskowe do ustawienia w wystąpieniu kontenera. Zmienna środowiskowa[]
obraz Nazwa obrazu użytego do utworzenia wystąpienia kontenera. ciąg (wymagany)
Porty Uwidocznione porty w wystąpieniu kontenera. KontenerPort[]
zasoby Wymagania dotyczące zasobów wystąpienia kontenera. ResourceRequirements (wymagane)
WoluminInstalacje Woluminy są montowane w wystąpieniu kontenera. volumeMount[]

Zmienna środowiskowa

Nazwa Opis Wartość
nazwa Nazwa zmiennej środowiskowej. ciąg (wymagany)
wartość Wartość zmiennej środowiskowej. ciąg (wymagany)

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. ciąg
repozytorium Adres URL repozytorium ciąg (wymagany)
rewizja Zatwierdź skrót dla określonej poprawki. ciąg

Poświadczenia 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)

Adresy IP

Nazwa Opis Wartość
Ip Adres IP uwidoczniony w publicznym Internecie. ciąg
Porty Lista portów uwidocznionych w grupie kontenerów. port[] (wymagane)
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"

ZasobyLimits

Nazwa Opis Wartość
procesor Limit procesora CPU dla tego wystąpienia kontenera. Int
memoryInGB (pamięć w GB) Limit pamięci w GB tego wystąpienia kontenera. Int

ResourceRequests

Nazwa Opis Wartość
procesor Żądanie procesora CPU tego wystąpienia kontenera. int (wymagane)
memoryInGB (pamięć w GB) Żą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. ZasobyLimits
Żądania Zasób żąda tego wystąpienia kontenera. ResourceRequests (wymagane)

Tagi zasobów

Nazwa Opis Wartość

Wolumin tajny

Nazwa Opis Wartość

Głośność

Nazwa Opis Wartość
azureFile (plik azure) Wolumin usługi Azure File. AzureFileVolume (Wolumin Pliku)
emptyDir (pusty katalog) Pusty wolumin katalogu. jakikolwiek
gitRepo Wolumin repozytorium git. GitRepoVolume
nazwa Nazwa woluminu. ciąg (wymagany)
klucz tajny Wolumin tajny. Wolumin tajny

WoluminMount

Nazwa Opis Wartość
mountPath (ścieżka montowania) Ś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 (tylko do odczytu) Flaga wskazująca, czy instalacja woluminu jest tylko do odczytu. Bool

Przykłady użycia

Przykłady programu Terraform

Podstawowy przykład wdrażania wystąpienia grupy kontenerów platformy Azure.

terraform {
  required_providers {
    azapi = {
      source = "Azure/azapi"
    }
  }
}

provider "azapi" {
  skip_provider_registration = false
}

variable "resource_name" {
  type    = string
  default = "acctest0001"
}

variable "location" {
  type    = string
  default = "westeurope"
}

resource "azapi_resource" "resourceGroup" {
  type     = "Microsoft.Resources/resourceGroups@2020-06-01"
  name     = var.resource_name
  location = var.location
}

resource "azapi_resource" "containerGroup" {
  type      = "Microsoft.ContainerInstance/containerGroups@2023-05-01"
  parent_id = azapi_resource.resourceGroup.id
  name      = var.resource_name
  location  = var.location
  body = {
    properties = {
      containers = [
        {
          name = "hw"
          properties = {
            command = [
            ]
            environmentVariables = [
            ]
            image = "ubuntu:20.04"
            ports = [
              {
                port     = 80
                protocol = "TCP"
              },
            ]
            resources = {
              requests = {
                cpu        = 0.5
                memoryInGB = 0.5
              }
            }
          }
        },
      ]
      initContainers = [
      ]
      ipAddress = {
        autoGeneratedDomainNameLabelScope = "Unsecure"
        ports = [
          {
            port     = 80
            protocol = "TCP"
          },
        ]
        type = "Public"
      }
      osType        = "Linux"
      restartPolicy = "Always"
      volumes = [
      ]
    }
    tags = {
      environment = "Testing"
    }
    zones = [
    ]
  }
  schema_validation_enabled = false
  response_export_values    = ["*"]
}

Moduły zweryfikowane na platformie Azure

Następujące moduły zweryfikowane platformy Azure mogą służyć do wdrażania tego typu zasobu.

Moduł Opis
wystąpienia kontenera Moduł zasobów AVM dla wystąpienia kontenera