Připojení sdílené složky ve službě Azure Container Instances

Ve výchozím nastavení je služba Azure Container Instances bezstavová. Pokud je kontejner restartován, dojde k chybě nebo se zastaví, veškerý jeho stav bude ztracen. Pokud chcete zachovat stav i po skončení životnosti kontejneru, je nutné připojit svazek z externího úložiště. Jak je znázorněno v tomto článku, Azure Container Instances můžou připojit sdílenou složku Azure vytvořenou se soubory Azure. Soubory Azure nabízí plně spravované sdílené složky hostované v Azure Storage, které jsou přístupné prostřednictvím standardního protokolu SMB (Server Message Block). Použití sdílené složky Azure s Azure Container Instances poskytuje funkce pro sdílení souborů podobně jako použití sdílené složky Azure s virtuálními počítači Azure.

Omezení

• Sdílené složky Azure můžete připojovat jenom do kontejnerů Linux. Přečtěte si další informace o rozdílech v podpoře funkcí pro skupiny kontejnerů pro Linux a Windows v přehledu.
• Připojení svazku sdílené složky Azure vyžaduje, aby byl kořenový adresář spuštění kontejneru Linux.
• Připojení svazků sdílené složky Azure jsou omezená na podporu CIFS.

Vytvoření sdílené složky Azure

Abyste mohli ve službě Azure Container Instances použít sdílenou složku Azure, je potřeba ji napřed vytvořit. Spuštěním následujícího skriptu vytvořte účet úložiště pro hostování sdílené složky a samotné sdílené složky. Název účtu úložiště musí být globálně jedinečný, a proto skript přidá k základnímu řetězci náhodnou hodnotu.

# Change these four parameters as needed
ACI_PERS_RESOURCE_GROUP=myResourceGroup
ACI_PERS_STORAGE_ACCOUNT_NAME=mystorageaccount$RANDOM
ACI_PERS_LOCATION=eastus
ACI_PERS_SHARE_NAME=acishare

# Create the storage account with the parameters
az storage account create \
    --resource-group $ACI_PERS_RESOURCE_GROUP \
    --name $ACI_PERS_STORAGE_ACCOUNT_NAME \
    --location $ACI_PERS_LOCATION \
    --sku Standard_LRS

# Create the file share
az storage share create \
  --name $ACI_PERS_SHARE_NAME \
  --account-name $ACI_PERS_STORAGE_ACCOUNT_NAME

Získání přihlašovacích údajů úložiště

K připojení sdílené složky Azure jako svazku ve službě Azure Container Instances potřebujete tři hodnoty: název účtu úložiště, název sdílené složky a přístupový klíč k úložišti.

• Název účtu úložiště – Pokud jste použili předchozí skript, název účtu úložiště byl uložený v $ACI_PERS_STORAGE_ACCOUNT_NAME proměnné. Název účtu zobrazíte tak, že zadáte:

  echo $ACI_PERS_STORAGE_ACCOUNT_NAME
  

• Název sdílené složky – tato hodnota je už známá (definovaná jako acishare v předchozím skriptu).

• Klíč účtu úložiště – tato hodnota se dá najít pomocí následujícího příkazu:

  STORAGE_KEY=$(az storage account keys list --resource-group $ACI_PERS_RESOURCE_GROUP --account-name $ACI_PERS_STORAGE_ACCOUNT_NAME --query "[0].value" --output tsv)
  echo $STORAGE_KEY
  

Nasazení kontejneru a přípojného svazku – rozhraní příkazového řádku

Pokud chcete připojit sdílenou složku Azure jako svazek v kontejneru pomocí rozhraní příkazového řádku Azure, určete sdílenou složku a přípojný bod svazku při vytváření kontejneru pomocí AZ Container Create. Pokud jste postupovali podle předchozích kroků, můžete sdílenou složku, kterou jste vytvořili dříve, připojit pomocí následujícího příkazu k vytvoření kontejneru:

az container create \
    --resource-group $ACI_PERS_RESOURCE_GROUP \
    --name hellofiles \
    --image mcr.microsoft.com/azuredocs/aci-hellofiles \
    --dns-name-label aci-demo \
    --ports 80 \
    --azure-file-volume-account-name $ACI_PERS_STORAGE_ACCOUNT_NAME \
    --azure-file-volume-account-key $STORAGE_KEY \
    --azure-file-volume-share-name $ACI_PERS_SHARE_NAME \
    --azure-file-volume-mount-path /aci/logs/

--dns-name-labelHodnota musí být jedinečná v rámci oblasti Azure, ve které vytvoříte instanci kontejneru. Pokud se při spuštění příkazu zobrazí chybová zpráva popisku názvu DNS , aktualizujte hodnotu v předchozím příkazu.

Správa souborů na připojeném svazku

Po spuštění kontejneru můžete použít jednoduchou webovou aplikaci nasazenou prostřednictvím image Microsoft ACI-hellofiles k vytvoření malých textových souborů ve sdílené složce Azure v zadané cestě k připojení. Získejte plně kvalifikovaný název domény (FQDN) webové aplikace pomocí příkazu AZ Container show :

az container show --resource-group $ACI_PERS_RESOURCE_GROUP \
  --name hellofiles --query ipAddress.fqdn --output tsv

Po uložení textu pomocí aplikace můžete pomocí Azure Portal nebo nástroje, jako je Průzkumník služby Microsoft Azure Storage , načíst a zkontrolovat soubor nebo soubory zapsané do sdílené složky.

Nasazení kontejneru a připojení svazku – YAML

Můžete také nasadit skupinu kontejnerů a připojit svazek do kontejneru pomocí Azure CLI a šablony YAML. Nasazení pomocí šablony YAML je upřednostňovanou metodou při nasazování skupin kontejnerů, které se skládají z více kontejnerů.

Následující šablona YAML definuje skupinu kontejnerů s jedním kontejnerem vytvořeným s aci-hellofiles imagí. Kontejner připojí sdílenou složku Azure acishare , která byla dříve vytvořena jako svazek. Tam, kde je uvedeno, zadejte název a klíč úložiště pro účet úložiště, který hostuje sdílenou složku.

Stejně jako v příkladu rozhraní příkazového řádku dnsNameLabel musí být hodnota jedinečná v rámci oblasti Azure, kde vytvoříte instanci kontejneru. V případě potřeby aktualizujte hodnotu v souboru YAML.

apiVersion: '2019-12-01'
location: eastus
name: file-share-demo
properties:
  containers:
  - name: hellofiles
    properties:
      environmentVariables: []
      image: mcr.microsoft.com/azuredocs/aci-hellofiles
      ports:
      - port: 80
      resources:
        requests:
          cpu: 1.0
          memoryInGB: 1.5
      volumeMounts:
      - mountPath: /aci/logs/
        name: filesharevolume
  osType: Linux
  restartPolicy: Always
  ipAddress:
    type: Public
    ports:
      - port: 80
    dnsNameLabel: aci-demo
  volumes:
  - name: filesharevolume
    azureFile:
      sharename: acishare
      storageAccountName: <Storage account name>
      storageAccountKey: <Storage account key>
tags: {}
type: Microsoft.ContainerInstance/containerGroups

K nasazení se šablonou YAML uložte předchozí YAML do souboru s názvem deploy-aci.yaml a potom spusťte příkaz AZ Container Create s --file parametrem:

# Deploy with YAML template
az container create --resource-group myResourceGroup --file deploy-aci.yaml

Nasazení kontejneru a připojení svazku – Správce prostředků

Kromě nasazení CLI a YAML můžete nasadit skupinu kontejnerů a připojit svazek do kontejneru pomocí šablony Azure správce prostředků.

Nejdřív naplňte volumes pole do části Skupina kontejnerů v properties šabloně.

Pak u každého kontejneru, do kterého chcete svazek připojit, naplňte volumeMounts pole v properties části definice kontejneru.

Následující šablona Správce prostředků definuje skupinu kontejnerů s jedním kontejnerem vytvořeným s aci-hellofiles imagí. Kontejner připojí sdílenou složku Azure acishare , která byla dříve vytvořena jako svazek. Tam, kde je uvedeno, zadejte název a klíč úložiště pro účet úložiště, který hostuje sdílenou složku.

Stejně jako v předchozích příkladech dnsNameLabel musí být hodnota jedinečná v rámci oblasti Azure, kde vytvoříte instanci kontejneru. V případě potřeby aktualizujte hodnotu v šabloně.

{
  "$schema": "https://schema.management.azure.com/schemas/2015-01-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "variables": {
    "container1name": "hellofiles",
    "container1image": "mcr.microsoft.com/azuredocs/aci-hellofiles"
  },
  "resources": [
    {
      "name": "file-share-demo",
      "type": "Microsoft.ContainerInstance/containerGroups",
      "apiVersion": "2019-12-01",
      "location": "[resourceGroup().location]",
      "properties": {
        "containers": [
          {
            "name": "[variables('container1name')]",
            "properties": {
              "image": "[variables('container1image')]",
              "resources": {
                "requests": {
                  "cpu": 1,
                  "memoryInGb": 1.5
                }
              },
              "ports": [
                {
                  "port": 80
                }
              ],
              "volumeMounts": [
                {
                  "name": "filesharevolume",
                  "mountPath": "/aci/logs"
                }
              ]
            }
          }
        ],
        "osType": "Linux",
        "ipAddress": {
          "type": "Public",
          "ports": [
            {
              "protocol": "tcp",
              "port": "80"
            }
          ],
          "dnsNameLabel": "aci-demo"
        },
        "volumes": [
          {
            "name": "filesharevolume",
            "azureFile": {
                "shareName": "acishare",
                "storageAccountName": "<Storage account name>",
                "storageAccountKey": "<Storage account key>"
            }
          }
        ]
      }
    }
  ]
}

Pokud chcete nasadit šablonu Správce prostředků, uložte předchozí JSON do souboru s názvem deploy-aci.json a potom spusťte příkaz AZ Deployment Group Create s --template-file parametrem:

# Deploy with Resource Manager template
az deployment group create --resource-group myResourceGroup --template-file deploy-aci.json

Připojit více svazků

Chcete-li připojit více svazků v instanci kontejneru, je nutné nasadit pomocí šablony Azure Resource Manager, souboru YAML nebo jiné programové metody. Chcete-li použít šablonu nebo soubor YAML, zadejte podrobnosti o sdílené složce a definujte svazky naplněním volumes pole v properties části souboru.

Pokud jste například vytvořili dvě sdílené složky Azure Files s názvem share1 a share2 v účtu úložiště myStorageAccount, volumes pole v šabloně správce prostředků by vypadalo podobně jako v následujícím příkladu:

"volumes": [{
  "name": "myvolume1",
  "azureFile": {
    "shareName": "share1",
    "storageAccountName": "myStorageAccount",
    "storageAccountKey": "<storage-account-key>"
  }
},
{
  "name": "myvolume2",
  "azureFile": {
    "shareName": "share2",
    "storageAccountName": "myStorageAccount",
    "storageAccountKey": "<storage-account-key>"
  }
}]

Dále pro každý kontejner ve skupině kontejnerů, do kterého chcete svazky připojit, vyplňte volumeMounts pole v properties části definice kontejneru. Například to připojí dva svazky, myvolume1 a myvolume2, dříve definované:

"volumeMounts": [{
  "name": "myvolume1",
  "mountPath": "/mnt/share1/"
},
{
  "name": "myvolume2",
  "mountPath": "/mnt/share2/"
}]

Další kroky

Naučte se připojit další typy svazků v Azure Container Instances:

• Připojení svazku emptyDir v Azure Container Instances
• Připojení svazku Gitrepo nepodporují v Azure Container Instances
• Připojit tajný svazek v Azure Container Instances