Bicep 資源定義
containerGroups 資源類型可以使用目標作業來部署:
如需每個 API 版本中已變更屬性的清單,請參閱 變更記錄。
若要建立 Microsoft.ContainerInstance/containerGroups 資源,請將下列 Bicep 新增至範本。
resource symbolicname 'Microsoft.ContainerInstance/containerGroups@2018-09-01' = {
name: 'string'
location: 'string'
tags: {
tagName1: 'tagValue1'
tagName2: 'tagValue2'
}
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
memoryInGB: json('decimal-as-string')
}
requests: {
cpu: int
memoryInGB: json('decimal-as-string')
}
}
volumeMounts: [
{
mountPath: 'string'
name: 'string'
readOnly: bool
}
]
}
}
]
diagnostics: {
logAnalytics: {
logType: 'string'
metadata: {}
workspaceId: 'string'
workspaceKey: '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: {}
}
]
}
}
屬性值
containerGroups
名稱 |
描述 |
值 |
NAME |
資源名稱 |
字串 (必要)
字元限制:1-63
合法字元: 小寫字母、數字和連字號。
不能以連字號開頭或結尾。 不允許連續的連字號。 |
location |
資源位置。 |
字串 |
tags |
資源標籤。 |
標記名稱和值的字典。 請參閱 範本中的標記 |
properties |
|
ContainerGroupProperties (必要) |
ContainerGroupProperties
容器
ContainerProperties
EnvironmentVariable
名稱 |
描述 |
值 |
NAME |
環境變數的名稱。 |
字串 (必要) |
secureValue |
安全環境變數的值。 |
字串 |
value |
環境變數的值。 |
字串 |
ContainerProbe
名稱 |
描述 |
值 |
exec |
要探查的執行命令 |
ContainerExec |
failureThreshold |
失敗閾值。 |
int |
httpGet |
要探查的 Http 取得設定 |
ContainerHttpGet |
initialDelaySeconds |
初始延遲秒數。 |
int |
periodSeconds |
期間長度秒數。 |
int |
successThreshold |
成功閾值。 |
int |
timeoutSeconds |
逾時秒數。 |
int |
ContainerExec
名稱 |
描述 |
值 |
命令 |
容器中執行的命令。 |
string[] |
ContainerHttpGet
名稱 |
描述 |
值 |
path |
探查的路徑。 |
string |
連接埠 |
探查的連接埠號碼。 |
int (必要) |
scheme |
配置。 |
'http' 'https' |
ContainerPort
名稱 |
描述 |
值 |
連接埠 |
容器群組中公開的連接埠號碼。 |
int (必要) |
protocol |
連接埠相關的通訊協定。 |
'TCP' 'UDP' |
ResourceRequirements
ResourceLimits
名稱 |
描述 |
值 |
cpu |
此容器執行個體的 CPU 限制。 |
int |
memoryInGB |
此容器執行個體的記憶體限制 GB。 若要指定十進位值,請使用 json () 函式。 |
int 或 json decimal |
ResourceRequests
名稱 |
描述 |
值 |
cpu |
此容器執行個體的 CPU 要求。 |
int (必要) |
memoryInGB |
此容器執行個體的記憶體要求 GB。 若要指定十進位值,請使用 json () 函式。 |
int 或 json 十進位 (必要) |
VolumeMount
名稱 |
描述 |
值 |
mountPath |
容器中磁碟區的裝載路徑。 不得包含冒號 (:)。 |
字串 (必要) |
NAME |
磁碟區裝載的名稱。 |
字串 (必要) |
readOnly |
此旗標指出磁碟區裝載是否為唯讀。 |
bool |
ContainerGroupDiagnostics
LogAnalytics
名稱 |
描述 |
值 |
logType |
要使用的記錄類型。 |
'ContainerInsights' 'ContainerInstanceLogs' |
中繼資料 |
記錄分析的中繼資料。 |
物件 (object) |
workspaceId |
記錄分析的工作區標識碼 |
字串 (必要) |
workspaceKey |
記錄分析的工作區金鑰 |
字串 (必要) |
ImageRegistryCredential
名稱 |
描述 |
值 |
password |
私人登錄的密碼。 |
字串 |
伺服器 |
Docker 映像登錄伺服器不具通訊協定 (例如「http」和「https」)。 |
字串 (必要) |
使用者名稱 |
私人登錄的使用者名稱。 |
字串 (必要) |
IpAddress
名稱 |
描述 |
值 |
dnsNameLabel |
IP 的 DNS 名稱標籤。 |
字串 |
ip |
公開至公用網際網路的 IP。 |
字串 |
連接埠 |
容器群組上公開的連接埠清單。 |
埠[] (必要) |
類型 |
指定IP是否公開給公用因特網。 |
'Private' 必要) 'Public' ( |
連接埠
名稱 |
描述 |
值 |
連接埠 |
連接埠號碼。 |
int (必要) |
protocol |
連接埠相關的通訊協定。 |
'TCP' 'UDP' |
ContainerGroupNetworkProfile
名稱 |
描述 |
值 |
id |
網路配置檔的識別碼。 |
字串 (必要) |
磁碟區
名稱 |
描述 |
值 |
azureFile |
Azure 檔案磁碟區。 |
AzureFileVolume |
emptyDir |
空白的目錄磁碟區。 |
針對 Bicep,您可以使用 any () 函式。 |
gitRepo |
Git 存放庫磁碟區。 |
GitRepoVolume |
NAME |
磁碟區的名稱。 |
字串 (必要) |
secret |
祕密磁碟區。 |
物件 (object) |
AzureFileVolume
名稱 |
描述 |
值 |
readOnly |
此旗標指出作為磁碟區裝載的 Azure 檔案共用是否為唯讀。 |
bool |
shareName |
作為磁碟區裝載的 Azure 檔案共用名稱。 |
字串 (必要) |
storageAccountKey |
存取 Azure 檔案共用使用的儲存體帳戶存取金鑰。 |
字串 |
storageAccountName |
包含 Azure 檔案共用的儲存體帳戶名稱。 |
字串 (必要) |
GitRepoVolume
名稱 |
描述 |
值 |
directory |
目標目錄名稱。 不能包含「..」或以「..」為開頭。 如果提供「.」,磁片區目錄即為 git 存放庫。 此外,若有指定,磁片區會包含在指定名稱子目錄中的 git 存放庫。 |
字串 |
repository |
存放庫 URL |
字串 (必要) |
revision |
認可指定修訂的雜湊。 |
字串 |
快速入門範本
下列快速入門範本會部署此資源類型。
ARM 範本資源定義
containerGroups 資源類型可以使用目標作業來部署:
如需每個 API 版本中已變更屬性的清單,請參閱 變更記錄檔。
若要建立 Microsoft.ContainerInstance/containerGroups 資源,請將下列 JSON 新增至您的範本。
{
"type": "Microsoft.ContainerInstance/containerGroups",
"apiVersion": "2018-09-01",
"name": "string",
"location": "string",
"tags": {
"tagName1": "tagValue1",
"tagName2": "tagValue2"
},
"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",
"memoryInGB": "[json('decimal-as-string')]"
},
"requests": {
"cpu": "int",
"memoryInGB": "[json('decimal-as-string')]"
}
},
"volumeMounts": [
{
"mountPath": "string",
"name": "string",
"readOnly": "bool"
}
]
}
}
],
"diagnostics": {
"logAnalytics": {
"logType": "string",
"metadata": {},
"workspaceId": "string",
"workspaceKey": "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": {}
}
]
}
}
屬性值
containerGroups
名稱 |
描述 |
值 |
類型 |
資源類型 |
'Microsoft.ContainerInstance/containerGroups' |
apiVersion |
資源 API 版本 |
'2018-09-01' |
NAME |
資源名稱 |
需要字串 ()
字元限制:1-63
合法字元: 小寫字母、數字和連字號。
不能以連字號開頭或結尾。 不允許連續的連字號。 |
location |
資源位置。 |
字串 |
tags |
資源標籤。 |
標記名稱和值的字典。 請參閱 範本中的標籤 |
properties |
|
ContainerGroupProperties (必要) |
ContainerGroupProperties
容器
ContainerProperties
EnvironmentVariable
名稱 |
描述 |
值 |
NAME |
環境變數的名稱。 |
需要字串 () |
secureValue |
安全環境變數的值。 |
字串 |
value |
環境變數的值。 |
字串 |
ContainerProbe
名稱 |
描述 |
值 |
exec |
要探查的執行命令 |
ContainerExec |
failureThreshold |
失敗閾值。 |
int |
httpGet |
要探查的 Http 取得設定 |
ContainerHttpGet |
initialDelaySeconds |
初始延遲秒數。 |
int |
periodSeconds |
期間長度秒數。 |
int |
successThreshold |
成功閾值。 |
int |
timeoutSeconds |
逾時秒數。 |
int |
ContainerExec
名稱 |
描述 |
值 |
命令 |
容器中執行的命令。 |
string[] |
ContainerHttpGet
名稱 |
描述 |
值 |
path |
探查的路徑。 |
string |
連接埠 |
探查的連接埠號碼。 |
需要 int () |
scheme |
配置。 |
'http' 'https' |
ContainerPort
名稱 |
描述 |
值 |
連接埠 |
容器群組中公開的連接埠號碼。 |
需要 int () |
protocol |
連接埠相關的通訊協定。 |
'TCP' 'UDP' |
ResourceRequirements
ResourceLimits
名稱 |
描述 |
值 |
cpu |
此容器執行個體的 CPU 限制。 |
int |
memoryInGB |
此容器執行個體的記憶體限制 GB。 若要指定十進位值,請使用 json () 函式。 |
int 或 json decimal |
ResourceRequests
名稱 |
描述 |
值 |
cpu |
此容器執行個體的 CPU 要求。 |
int (必要) |
memoryInGB |
此容器執行個體的記憶體要求 GB。 若要指定十進位值,請使用 json () 函式。 |
int 或 json 十進位 (必要) |
VolumeMount
名稱 |
描述 |
值 |
mountPath |
容器中磁碟區的裝載路徑。 不得包含冒號 (:)。 |
字串 (必要) |
NAME |
磁碟區裝載的名稱。 |
字串 (必要) |
readOnly |
此旗標指出磁碟區裝載是否為唯讀。 |
bool |
ContainerGroupDiagnostics
LogAnalytics
名稱 |
描述 |
值 |
logType |
要使用的記錄類型。 |
'ContainerInsights' 'ContainerInstanceLogs' |
中繼資料 |
記錄分析的中繼資料。 |
物件 (object) |
workspaceId |
記錄分析的工作區標識碼 |
字串 (必要) |
workspaceKey |
記錄分析的工作區金鑰 |
字串 (必要) |
ImageRegistryCredential
名稱 |
描述 |
值 |
password |
私人登錄的密碼。 |
字串 |
伺服器 |
Docker 映像登錄伺服器不具通訊協定 (例如「http」和「https」)。 |
字串 (必要) |
使用者名稱 |
私人登錄的使用者名稱。 |
字串 (必要) |
IpAddress
名稱 |
描述 |
值 |
dnsNameLabel |
IP 的 DNS 名稱標籤。 |
字串 |
ip |
公開至公用網際網路的 IP。 |
字串 |
連接埠 |
容器群組上公開的連接埠清單。 |
埠[] (必要) |
類型 |
指定IP是否公開給公用因特網。 |
'Private' 必要) 'Public' ( |
連接埠
名稱 |
描述 |
值 |
連接埠 |
連接埠號碼。 |
需要 int () |
protocol |
連接埠相關的通訊協定。 |
'TCP' 'UDP' |
ContainerGroupNetworkProfile
名稱 |
描述 |
值 |
id |
網路配置檔的識別碼。 |
需要字串 () |
磁碟區
名稱 |
描述 |
值 |
azureFile |
Azure 檔案磁碟區。 |
AzureFileVolume |
emptyDir |
空白的目錄磁碟區。 |
|
gitRepo |
Git 存放庫磁碟區。 |
GitRepoVolume |
NAME |
磁碟區的名稱。 |
需要字串 () |
secret |
祕密磁碟區。 |
物件 (object) |
AzureFileVolume
名稱 |
描述 |
值 |
readOnly |
此旗標指出作為磁碟區裝載的 Azure 檔案共用是否為唯讀。 |
bool |
shareName |
作為磁碟區裝載的 Azure 檔案共用名稱。 |
需要字串 () |
storageAccountKey |
存取 Azure 檔案共用使用的儲存體帳戶存取金鑰。 |
字串 |
storageAccountName |
包含 Azure 檔案共用的儲存體帳戶名稱。 |
需要字串 () |
GitRepoVolume
名稱 |
描述 |
值 |
directory |
目標目錄名稱。 不能包含「..」或以「..」為開頭。 如果提供「.」,磁片區目錄即為 git 存放庫。 此外,若有指定,磁片區會包含在指定名稱子目錄中的 git 存放庫。 |
字串 |
repository |
存放庫 URL |
需要字串 () |
revision |
認可指定修訂的雜湊。 |
字串 |
快速入門範本
下列快速入門範本會部署此資源類型。
containerGroups 資源類型可以使用目標作業來部署:
如需每個 API 版本中已變更屬性的清單,請參閱 變更記錄。
若要建立 Microsoft.ContainerInstance/containerGroups 資源,請將下列 Terraform 新增至範本。
resource "azapi_resource" "symbolicname" {
type = "Microsoft.ContainerInstance/containerGroups@2018-09-01"
name = "string"
location = "string"
parent_id = "string"
tags = {
tagName1 = "tagValue1"
tagName2 = "tagValue2"
}
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
memoryInGB = "decimal-as-string"
}
requests = {
cpu = int
memoryInGB = "decimal-as-string"
}
}
volumeMounts = [
{
mountPath = "string"
name = "string"
readOnly = bool
}
]
}
}
]
diagnostics = {
logAnalytics = {
logType = "string"
metadata = {}
workspaceId = "string"
workspaceKey = "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 = {}
}
]
}
})
}
屬性值
containerGroups
名稱 |
描述 |
值 |
類型 |
資源類型 |
“Microsoft.ContainerInstance/containerGroups@2018-09-01” |
NAME |
資源名稱 |
字串 (必要)
字元限制:1-63
合法字元: 小寫字母、數字和連字號。
不能以連字號開頭或結尾。 不允許連續的連字號。 |
location |
資源位置。 |
字串 |
parent_id |
若要部署至資源群組,請使用該資源群組的標識碼。 |
字串 (必要) |
tags |
資源標籤。 |
標記名稱和值的字典。 |
properties |
|
ContainerGroupProperties (必要) |
ContainerGroupProperties
容器
ContainerProperties
EnvironmentVariable
名稱 |
描述 |
值 |
NAME |
環境變數的名稱。 |
字串 (必要) |
secureValue |
安全環境變數的值。 |
字串 |
value |
環境變數的值。 |
字串 |
ContainerProbe
名稱 |
描述 |
值 |
exec |
要探查的執行命令 |
ContainerExec |
failureThreshold |
失敗閾值。 |
int |
httpGet |
要探查的 Http 取得設定 |
ContainerHttpGet |
initialDelaySeconds |
初始延遲秒數。 |
int |
periodSeconds |
期間長度秒數。 |
int |
successThreshold |
成功閾值。 |
int |
timeoutSeconds |
逾時秒數。 |
int |
ContainerExec
名稱 |
描述 |
值 |
命令 |
容器中執行的命令。 |
string[] |
ContainerHttpGet
名稱 |
描述 |
值 |
path |
探查的路徑。 |
string |
連接埠 |
探查的連接埠號碼。 |
int (必要) |
scheme |
配置。 |
“http” “https” |
ContainerPort
名稱 |
描述 |
值 |
連接埠 |
容器群組中公開的連接埠號碼。 |
int (必要) |
protocol |
連接埠相關的通訊協定。 |
“TCP” “UDP” |
ResourceRequirements
ResourceLimits
名稱 |
描述 |
值 |
cpu |
此容器執行個體的 CPU 限制。 |
int |
memoryInGB |
此容器執行個體的記憶體限制 GB。 將十進位值指定為字串。 |
int 或 json decimal |
ResourceRequests
名稱 |
描述 |
值 |
cpu |
此容器執行個體的 CPU 要求。 |
需要 int () |
memoryInGB |
此容器執行個體的記憶體要求 GB。 將十進位值指定為字串。 |
需要 int 或 json 十進位 () |
VolumeMount
名稱 |
描述 |
值 |
mountPath |
容器中磁碟區的裝載路徑。 不得包含冒號 (:)。 |
需要字串 () |
NAME |
磁碟區裝載的名稱。 |
需要字串 () |
readOnly |
此旗標指出磁碟區裝載是否為唯讀。 |
bool |
ContainerGroupDiagnostics
LogAnalytics
名稱 |
描述 |
值 |
logType |
要使用的記錄類型。 |
“ContainerInsights” “ContainerInstanceLogs” |
中繼資料 |
記錄分析的中繼資料。 |
物件 (object) |
workspaceId |
記錄分析的工作區標識碼 |
需要字串 () |
workspaceKey |
記錄分析的工作區金鑰 |
需要字串 () |
ImageRegistryCredential
名稱 |
描述 |
值 |
password |
私人登錄的密碼。 |
字串 |
伺服器 |
Docker 映像登錄伺服器不具通訊協定 (例如「http」和「https」)。 |
需要字串 () |
使用者名稱 |
私人登錄的使用者名稱。 |
需要字串 () |
IpAddress
名稱 |
描述 |
值 |
dnsNameLabel |
IP 的 DNS 名稱標籤。 |
字串 |
ip |
公開至公用網際網路的 IP。 |
字串 |
連接埠 |
容器群組上公開的連接埠清單。 |
Port[] (必要) |
類型 |
指定IP是否公開至公用因特網。 |
“Private” “Public” (必要) |
連接埠
名稱 |
描述 |
值 |
連接埠 |
連接埠號碼。 |
int (必要) |
protocol |
連接埠相關的通訊協定。 |
“TCP” “UDP” |
ContainerGroupNetworkProfile
名稱 |
描述 |
值 |
id |
網路配置檔的識別碼。 |
字串 (必要) |
磁碟區
名稱 |
描述 |
值 |
azureFile |
Azure 檔案磁碟區。 |
AzureFileVolume |
emptyDir |
空白的目錄磁碟區。 |
|
gitRepo |
Git 存放庫磁碟區。 |
GitRepoVolume |
NAME |
磁碟區的名稱。 |
字串 (必要) |
secret |
祕密磁碟區。 |
物件 (object) |
AzureFileVolume
名稱 |
描述 |
值 |
readOnly |
此旗標指出作為磁碟區裝載的 Azure 檔案共用是否為唯讀。 |
bool |
shareName |
作為磁碟區裝載的 Azure 檔案共用名稱。 |
字串 (必要) |
storageAccountKey |
存取 Azure 檔案共用使用的儲存體帳戶存取金鑰。 |
字串 |
storageAccountName |
包含 Azure 檔案共用的儲存體帳戶名稱。 |
字串 (必要) |
GitRepoVolume
名稱 |
描述 |
值 |
directory |
目標目錄名稱。 不能包含「..」或以「..」為開頭。 如果提供「.」,磁片區目錄即為 git 存放庫。 此外,若有指定,磁片區會包含在指定名稱子目錄中的 git 存放庫。 |
字串 |
repository |
存放庫 URL |
字串 (必要) |
revision |
認可指定修訂的雜湊。 |
字串 |