Configuratietoewijzingen voor Azure Container Instances (preview)

Een configuratietoewijzing is een eigenschap die kan worden gebruikt om containerconfiguraties toe te passen die vergelijkbaar zijn met omgevingsvariabelen en geheime volumes. In tegenstelling tot het gebruik van omgevingsvariabelen of geheime volumes waarbij het opnieuw opstarten van de pod om de instellingen toe te passen is vereist, is het toepassen van instellingen met behulp van een configuratietoewijzing echter niet vereist dat de wijzigingen van kracht worden.

Azure Container Instances kunnen worden gemaakt met of zonder configuratietoewijzingen en kunnen op elk moment na het maken worden bijgewerkt met behulp van configuratietoewijzingen. Het bijwerken van configuratietoewijzingen in een bestaande actieve containergroep kan snel worden uitgevoerd zonder de uptime van de container in gevaar te brengen.

Hoe het werkt

Een configuratietoewijzing kan worden opgenomen in de containereigenschappen of in een containergroepprofiel. Als u een profiel voor een containergroep maakt met de configuratietoewijzingsinstellingen, kunt u deze instellingen eenvoudig en eenvoudig automatiseren.

Een containergroepprofiel maken met configuratietoewijzingsinstellingen

CLI

Maak een containergroepprofiel met configuratietoewijzingsinstellingen met behulp van az container-group-profile create.

az container container-group-profile create \
    --resource-group myResourceGroup \
    --name myContainerGroupProfile \
    --location WestCentralUS \
    --image nginx \
    --os-type Linux \ 
    --ip-address Public \ 
    --ports 8000 \ 
    --cpu 1 \
    --memory 1.5 \
    --restart-policy never \
    --config-map key1=value1 key2=value2

Powershell

Maak een containergroepprofiel met configuratietoewijzingsinstellingen met behulp van New-AzContainerInstanceContainerGroupProfile.

$port1 = New-AzContainerInstancePortObject -Port 8000 -Protocol TCP
$port2 = New-AzContainerInstancePortObject -Port 8001 -Protocol TCP

$container = New-AzContainerInstanceObject -Name myContainer -Image nginx -RequestCpu 1 -RequestMemoryInGb 1.5 -Port @($port1, $port2) -ConfigMapKeyValuePair @{"key1"="value1"}

New-AzContainerInstanceContainerGroupProfile `
    -ResourceGroupName myResourceGroup `
    -Name myContainerGroupProfile `
    -Location WestCentralUS `
    -Container $container `
    -OsType Linux `
    -RestartPolicy "Never" `
    -IpAddressType Public

ARM-sjabloon

Maak een containergroepprofiel met en configuratietoewijzingsinstellingen implementeer de sjabloon met behulp van az deployment group create of New-AzResourceGroupDeployment.

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "resources": [
    {
      "type": "Microsoft.ContainerInstance/containerGroups",
      "apiVersion": "2024-05-01-preview",
      "name": "[parameters('profileName')]",
      "location": "[parameters('location')]",
      "properties": {
        "containers": [
          {
            "name": "myContainer",
            "properties": {
              "image": "[parameters('containerImage')]",
              "ports": [
                {
                  "port": 8000
                }
              ],
              "resources": {
                "requests": {
                  "cpu": 1,
                  "memoryInGB": 1.5
                }
              },
              "command": [],
              "configMap": {
                  "keyValuePairs": {
                        "key1": "value1",
                        "key2": "value2"
                                   }                   
              "environmentVariables": []
            }
          }
        ],
        "osType": "Linux",
        "ipAddress": {
          "type": "Public",
          "ports": [
            {
              "protocol": "TCP",
              "port": 8000
            }
          ]
        },
        "imageRegistryCredentials": [],
        "sku": "Standard"
      }
    }
  ],
  "parameters": {
    "profileName": {
      "type": "string",
      "defaultValue": "myContainerGroupProfile",
      "metadata": {
        "description": "Name of the container profile"
      }
    },
    "location": {
      "type": "string",
      "defaultValue": "West Central US",
      "metadata": {
        "description": "Location for the resource"
      }
    },
    "containerImage": {
      "type": "string",
      "defaultValue": "mcr.microsoft.com/azuredocs/aci-helloworld:latest",
      "metadata": {
        "description": "The container image used"
      }
    }
  }
}

REST

Maak een containergroepprofiel met configuratietoewijzingsinstellingen met behulp van Maken of Bijwerken.

PUT https://management.azure.com/subscriptions/{SubscriptionID}/resourceGroups/myResourceGroup/providers/Microsoft.ContainerInstance/containerGroupProfiles/myContainerGroupProfile?api-version=2024-05-01-preview

Request Body
{
    "location": "West Central US",
    "properties":{
        "containers": [
        {
            "name":"myContainerGroupProfile",
            "properties": {
                "command":[],
                "configMap": {
                  "keyValuePairs": {
                        "key1": "value1",
                        "key2": "value2"
                                   }
                            },     
                "environmentVariables":[],
                "image":"mcr.microsoft.com/azuredocs/aci-helloworld:latest",
                "ports":[
                    {
                        "port":8000
                    }
                ],
                "resources": {
                    "requests": {
                        "cpu":1,
                        "memoryInGB":1.5
                                }
                            }
                        }
                    }
                ],
                "imageRegistryCredentials":[],
                "ipAddress":{
                "ports":[
                    {
                        "protocol":"TCP",
                        "port":8000
                    }
            ],
            "type":"Public"
            },
            "osType":"Linux",
            "sku":"Standard"
            }
        }

Configuratietoewijzingsinstellingen toepassen met behulp van een containergroepprofiel

Als u de configuratietoewijzingsinstellingen toepast die zijn opgeslagen in een containergroepsprofiel, moet u de container bijwerken en het containergroepprofiel opgeven dat moet worden gekoppeld aan de update.

CLI

Pas de configuratietoewijzingsinstellingen toe die zijn opgeslagen in het containergroepprofiel met behulp van az container create.

az container create 
        --resource-group myResourceGroup \ 
        --name myContainer \ 
        --location WestCentralUS \
        --container-group-profile-id "/subscriptions/{SubscriptionID}/resourceGroups/myResourceGroup/providers/Microsoft.ContainerInstance/containerGroupProfiles/myContainerGroupProfile" \
        --container-group-profile-revision 1 

Powershell

Pas de configuratietoewijzingsinstellingen toe die zijn opgeslagen in het containergroepprofiel met behulp van New-AzContainerGroup.

$container = New-AzContainerInstancenoDefaultObject -Name myContainer

New-AzContainerGroup `
    -ResourceGroupName myResourceGroup `
    -Name myContainer`
    -Container $container `
    -Location WestCentralUS `
    -ContainerGroupProfileId "/subscriptions/{SubscriptionID}/resourceGroups/myResourceGroup/providers/Microsoft.ContainerInstance/containerGroupProfiles/myContainerGroupProfile" `
    -ContainerGroupProfileRevision 1 
                    

ARM-sjabloon

Pas de configuratietoewijzingsinstellingen toe die zijn opgeslagen in het containergroepprofiel met behulp van az deployment group create of New-AzResourceGroupDeployment.

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "parameters": {
    "subscriptionId": {
      "type": "string",
      "metadata": {
        "description": "The subscription ID."
      }
    },
    "resourceGroup": {
      "type": "string",
      "metadata": {
        "description": "The name of the resource group."
      }
    },
    "location": {
      "type": "string",
      "metadata": {
        "description": "Location for the resource."
      },
      "defaultValue": "West Central US"
    },
    "containerGroupName": {
      "type": "string",
      "metadata": {
        "description": "The name of the container group."
      }
    },
    },
    "containerGroupProfileName": {
      "type": "string",
      "metadata": {
        "description": "The name of the container group profile."
      }
    },
    "newKey": {
      "type": "string",
      "metadata": {
        "description": "The new key for the config map."
      }
    },
    "newValue": {
      "type": "string",
      "metadata": {
        "description": "The new value for the config map."
      }
    },
    "revisionNumber": {
      "type": "int",
      "metadata": {
        "description": "The revision number for the container group profile."
      }
    }
  },
  "resources": [
    {
      "type": "Microsoft.ContainerInstance/containerGroups",
      "apiVersion": "2024-05-01-preview",
      "name": "[parameters('containerGroupName')]",
      "location": "[parameters('location')]",
      "properties": {
        "containerGroupProfile": {
          "id": "[concat('/subscriptions/', parameters('subscriptionId'), '/resourceGroups/', parameters('resourceGroup'), '/providers/Microsoft.ContainerInstance/containerGroupProfiles/', parameters('containerGroupProfileName'))]",
          "revision": "[parameters('revisionNumber')]"
        },
        "containers": [
          {
            "name": "[parameters('myContainerProfile')]",
            "properties": {
              "configMap": {
                "keyValuePairs": {
                  "[parameters('newKey')]": "[parameters('newValue')]"
                }
              }
            }
          }
        ]
      }
    }
  ],
  "outputs": {
    "containerGroupId": {
      "type": "string",
      "value": "[resourceId('Microsoft.ContainerInstance/containerGroups', parameters('containerGroupName'))]"
    }
  }
}

REST

Pas de configuratietoewijzingsinstellingen toe die zijn opgeslagen in het profiel van de containergroep met behulp van Maken of Bijwerken.

PUT
https://management.azure.com/subscriptions/{SubscriptionID}/resourceGroups/myResourceGroup/providers/Microsoft.ContainerInstance/containerGroups/myContainerGroup?api-version=2024-05-01-preview 

Request Body
{
   "location": "{location}",
   "properties": {
           "containerGroupProfile": {
               "id": "/subscriptions/{subscriptionId}/resourceGroups/myResourceGroup/providers/Microsoft.ContainerInstance/containerGroupProfiles/myContainerGroupProfile",
               "revision": {revisionNumber}
           },
           "containers": [
               {
                   "name": "{myContainerGroupProfile}",
                   "properties": {
                   }
               }
           ]
   }
}

Configuratietoewijzingsinstellingen zonder containergroepprofiel toepassen

Configuratietoewijzingsinstellingen kunnen ook rechtstreeks op het exemplaar worden toegepast door de configuratietoewijzingsinstellingen op te geven in de opdrachten voor maken.

CLI

Pas de configuratietoewijzingsinstellingen toe met behulp van az container create.

az container create \
    --resource-group myResourceGroup \ 
    --name myContainer \
    --location WestCentralUS \ 
    --config-map key1=value1 key2=value2 
        

Powershell

Pas de configuratietoewijzingsinstellingen toe met behulp van New-AzContainerGrouop.

$container = New-AzContainerInstancenoDefaultObject -Name myContainer -ConfigMapKeyValuePair @{"key1"="value1"}

New-AzContainerGroup `
    -ResourceGroupName myResourceGroup `
    -Name myContainerGroup ` 
    -Container $container `
    -Location WestCentralUS 

ARM-sjabloon

Pas de configuratietoewijzingsinstellingen toe met behulp van az deployment group create of New-AzResourceGroupDeployment.

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "parameters": {
    "subscriptionId": {
      "type": "string",
      "metadata": {
        "description": "The subscription ID."
      }
    },
    "resourceGroup": {
      "type": "string",
      "metadata": {
        "description": "The name of the resource group."
      }
    },
    "location": {
      "type": "string",
      "metadata": {
        "description": "Location for the resource."
      },
      "defaultValue": "West Central US"
    },
    "containerGroupName": {
      "type": "string",
      "metadata": {
        "description": "The name of the container group."
    }
    },
    "myContainerProfile": {
      "type": "string",
      "metadata": {
        "description": "The name of the container profile."
      }
    },
    "newKey": {
      "type": "string",
      "metadata": {
        "description": "The new key for the config map."
      }
    },
    "newValue": {
      "type": "string",
      "metadata": {
        "description": "The new value for the config map."
      }
    },
  },
  "resources": [
    {
      "type": "Microsoft.ContainerInstance/containerGroups",
      "apiVersion": "2024-05-01-preview",
      "name": "[parameters('containerGroupName')]",
      "location": "[parameters('location')]",
      "properties": {
        "containers": [
          {
            "name": "[parameters('myContainerProfile')]",
            "properties": {
              "configMap": {
                "keyValuePairs": {
                  "[parameters('newKey')]": "[parameters('newValue')]"
                }
              }
            }
          }
        ]
      }
    }
  ],
  "outputs": {
    "containerGroupId": {
      "type": "string",
      "value": "[resourceId('Microsoft.ContainerInstance/containerGroups', parameters('containerGroupName'))]"
    }
  }
}

REST

Pas de configuratietoewijzingsinstellingen toe met maken of bijwerken.

PUT
https://management.azure.com/subscriptions/{SubscriptionID}/resourceGroups/myResourceGroup/providers/Microsoft.ContainerInstance/containerGroups/myContainerGroup?api-version=2024-05-01-preview 

Request Body
{
   "location": "{location}",
   "properties": {
           "containers": [
               {
                   "name": "{myContainerGroupProfile}",
                   "properties": {
                       "configMap": {
                           "keyValuePairs": {
                               "{newKey}": "{newValue}"
                           }
                       }
                   }
               }
           ]
   }
}

Zodra de update is toegepast op een bestaande container, ziet u de waarden die in de container zijn gekoppeld zonder dat u opnieuw hoeft op te starten.

/mnt/configmap/<containername>/key1 with value as “value1”

/mnt/configmap/<containername>/key2 with value as “value2”

Volgende stappen

Meer informatie over het gebruik van configuratiekaarten met stand-bypools om de schaal en beschikbaarheid te vergroten