Använd lagringsmonteringar i Azure Container Apps

När du konfigurerar lagring med replikomfattning med hjälp av Azure CLI måste du använda en YAML-definition för att skapa eller uppdatera containerappen.

1. Om du vill uppdatera en befintlig containerapp så att den använder lagring med replikomfattning exporterar du appens specifikation till en YAML-fil med namnet app.yaml.

   az containerapp show -n <APP_NAME> -g <RESOURCE_GROUP_NAME> -o yaml > app.yaml
   

2. Gör följande ändringar i containerappens specifikation.

   • Lägg till en volumes matris i avsnittet i containerappdefinitionen template och definiera en volym. Om du redan har en volumes matris lägger du till en ny volym i matrisen.
     • name är en identifierare för volymen.
     • Använd EmptyDir som storageType.
   • För att montera volymen på varje container i mallen, definierar du en volymmontering i volumeMounts arrayen för containerdefinitionen.
     • volumeName är namnet som definierats i matrisenvolumes.
     • mountPath är sökvägen i containern för att montera volymen.

   properties:
     managedEnvironmentId: /subscriptions/<SUBSCRIPTION_ID>/resourceGroups/<RESOURCE_GROUP_NAME>/providers/Microsoft.App/managedEnvironments/<ENVIRONMENT_NAME>
     configuration:
       activeRevisionsMode: Single
     template:
       containers:
       - image: <IMAGE_NAME1>
         name: my-container-1
         volumeMounts:
         - mountPath: /myempty
           volumeName: myempty
       - image: <IMAGE_NAME_2>
         name: my-container-2
         volumeMounts:
         - mountPath: /myempty
           volumeName: myempty
       volumes:
       - name: myempty
         storageType: EmptyDir
   

3. Uppdatera containerappen med hjälp av YAML-filen.

   az containerapp update --name <APP_NAME> --resource-group <RESOURCE_GROUP_NAME> \
       --yaml app.yaml
   

Ett fullständigt exempel finns i YAML-specifikationen.

För att skapa en replikerad volym och montera den i en container, gör följande ändringar i container-appresursen i en ARM-mall:

• Lägg till en volumes matris i avsnittet i containerappdefinitionen template och definiera en volym. Om du redan har en volumes matris lägger du till en ny volym i matrisen.
  • name är en identifierare för volymen.
  • Använd EmptyDir som storageType.
• För att montera volymen på varje container i mallen, definierar du en volymmontering i volumeMounts arrayen för containerdefinitionen.
  • volumeName är namnet som definierats i matrisenvolumes.
  • mountPath är sökvägen i containern för att montera volymen.

Exempel på ARM-mallfragment:

{
  "apiVersion": "2022-03-01",
  "type": "Microsoft.App/containerApps",
  "name": "[parameters('containerappName')]",
  "location": "[parameters('location')]",
  "properties": {

    ...

    "template": {
      "revisionSuffix": "myrevision",
      "containers": [
        {
          "name": "main",
          "image": "[parameters('container_image')]",
          "resources": {
            "cpu": 0.5,
            "memory": "1Gi"
          },
          "volumeMounts": [
            {
              "mountPath": "/myempty",
              "volumeName": "myempty"
            }
          ]
        },
        {
          "name": "sidecar",
          "image": "[parameters('sidecar_image')]",
          "resources": {
            "cpu": 0.5,
            "memory": "1Gi"
          },
          "volumeMounts": [
            {
              "mountPath": "/myempty",
              "volumeName": "myempty"
            }
          ]
        }
      ],
      "scale": {
        "minReplicas": 1,
        "maxReplicas": 3
      },
      "volumes": [
        {
          "name": "myempty",
          "storageType": "EmptyDir"
        }
      ]
    }
  }
}

Se API-specifikationen för ARM-mallen för ett fullständigt exempel.

Om du vill skapa en volym med replikomfattning och montera den i en container distribuerar du en ny revision av containerappen med hjälp av Azure-portalen.

1. I Azure-portalen går du till containerappen.

2. Välj Revisionshantering på den vänstra menyn.

3. Välj Skapa ny revision.

4. Välj den container där du vill montera volymen.

5. I fönstret Redigera en containerkontext väljer du fliken Volymmonteringar .

6. Under avsnittet Tillfällig lagring skapar du en ny volym med följande information:

   • Volymnamn: Ett namn på den tillfälliga volymen.
   • Monteringssökväg: Den absoluta sökvägen i containern för att montera volymen.

7. Välj Spara för att spara ändringar och avsluta kontextfönstret.

8. Välj Skapa för att skapa den nya revisionen.

När du konfigurerar en containerapp för att montera en Azure Files volym med hjälp av Azure CLI måste du använda en YAML-definition för att skapa eller uppdatera containerappen.

Installera den senaste Azure CLI och uppdatera tillägget Container Apps:

az extension add --name containerapp --upgrade

En stegvis handledning om hur du monterar en SMB-filresurs finns i Montera Azure Files-lagringsutrymme i Azure Container Apps.

1. Lägg till en lagringsdefinition i din Container Apps-miljö.

   • SMB
   • NFS

   Hanterad identitetsautentisering (rekommenderas)

   För att använda miljöns systemtilldelade hanterade identitet, aktivera den först:

   az containerapp env identity assign --name my-env --resource-group my-group \
       --system-assigned
   

   Tilldela identiteten Storage File Data SMB MI Admin-rollen på ditt lagringskonto och aktivera Managed Identity for SMB enligt förutsättningarna. Skapa sedan lagringsdefinitionen:

   az containerapp env storage set --name my-env --resource-group my-group \
       --storage-name mystorage \
       --storage-type AzureFile \
       --azure-file-account-name <STORAGE_ACCOUNT_NAME> \
       --azure-file-identity system \
       --azure-file-share-name <STORAGE_SHARE_NAME> \
       --access-mode ReadWrite
   

   Ersätt <STORAGE_SHARE_NAME> och <STORAGE_ACCOUNT_NAME> med namnen på ditt lagringskonto och din filresurs. Värdet system väljer miljöns systemtilldelade hanterade identitet.

   För att använda en användar-tilldelad hanterad identitet istället, tilldela den till miljön:

   az containerapp env identity assign --name my-env --resource-group my-group \
       --user-assigned <MANAGED_IDENTITY_RESOURCE_ID>
   

   Ge den identiteten samma roll på lagringskontot. I lagringskommandot, ersätt --azure-file-identity system med --azure-file-identity <MANAGED_IDENTITY_RESOURCE_ID>, med identitetens fullständiga Azure resource ID, inte dess klient-ID eller principal-ID.

   Kombinera --azure-file-identity inte med --azure-file-account-key eller --azure-file-key-vault-secret-url. Dessa autentiseringsmetoder utesluter varandra.

   Autentisering av lagringskontonyckel (alternativ)

   Om du inte kan använda hanterad identitetsautentisering kan du använda en lagringskontonyckel istället:

   az containerapp env storage set --name my-env --resource-group my-group \
       --storage-name mystorage \
       --storage-type AzureFile \
       --azure-file-account-name <STORAGE_ACCOUNT_NAME> \
       --azure-file-account-key <STORAGE_ACCOUNT_KEY> \
       --azure-file-share-name <STORAGE_SHARE_NAME> \
       --access-mode ReadWrite
   

   Ersätt <STORAGE_ACCOUNT_NAME> och <STORAGE_ACCOUNT_KEY> med namnet och nyckeln för ditt lagringskonto. Ersätt <STORAGE_SHARE_NAME> med namnet på filresursen i lagringskontot.

   Giltiga värden för --access-mode är ReadWrite och ReadOnly.

2. För att uppdatera en befintlig containerapp för att montera en filresursdelning exporterar du appens specifikation till en YAML-fil med namnet app.yaml.

   az containerapp show -n <APP_NAME> -g <RESOURCE_GROUP_NAME> -o yaml > app.yaml
   

3. Gör följande ändringar i containerappens specifikation.

   • Lägg till en volumes matris i avsnittet i containerappdefinitionen template och definiera en volym. Om du redan har en volumes matris lägger du till en ny volym i matrisen.
     • name är en identifierare för volymen.
     • För storageTypeanvänder du AzureFile för SMB eller NfsAzureFile för NFS. Det här värdet måste matcha den lagringstyp som du definierade i miljön.
     • För storageNameanvänder du namnet på lagringen som du definierade i miljön.
     • mountOptions är en kommaavgränsad sträng med monteringsval. Mer information finns i Använd inställningar för mountOptions i Azure Files.
     • Listan secrets är en lista över sekretess som ska monteras i volymen. Mer information finns i Montera hemligheter i en volym.
   • För varje container i mallen som du vill montera Azure Files-lagring, definierar du en volymanslutning i volumeMounts matrisen för containerdefinitionen.
     • volumeName är namnet som definierats i matrisenvolumes.
     • mountPath är sökvägen i containern för att montera volymen.
     • subPath är den sökväg i volymen som ska monteras. Om du inte anger det här värdet monteras volymroten. För mer information, se Underväg.
   • SMB
   • NFS

   properties:
     managedEnvironmentId: /subscriptions/<SUBSCRIPTION_ID>/resourceGroups/<RESOURCE_GROUP_NAME>/providers/Microsoft.App/managedEnvironments/<ENVIRONMENT_NAME>
     configuration:
     template:
       containers:
       - image: <IMAGE_NAME>
         name: my-container
         volumeMounts:
         - volumeName: azure-files-volume
           mountPath: /my-files
           subPath: my-sub-path
       volumes:
       - name: azure-files-volume
         storageType: AzureFile
         storageName: mystorage
   

4. Uppdatera containerappen med hjälp av YAML-filen.

   az containerapp update --name <APP_NAME> --resource-group <RESOURCE_GROUP_NAME> \
       --yaml app.yaml
   

Ett fullständigt exempel finns i YAML-specifikationen.

Följande ARM-mallfragment visar hur du lägger till en Azure Files resurs i en Container Apps-miljö och använder den i en containerapp. För SMB-autentisering med hanterad identitet, aktivera eller tilldela identiteten i miljön och slutför förutsättningarna för lagringskontot innan lagringsdefinitionen distribueras.

1. Lägg till en storages underordnad resurs i Container Apps-miljön.

   • SMB
   • NFS

   Hanterad identitetsautentisering (rekommenderas)

   För det första, aktivera en hanterad identitet på resursen Microsoft.App/managedEnvironments , inte på resursen Microsoft.App/containerApps . För att aktivera miljöns systemtilldelade identitet, lägg till följande toppnivåegenskap identity i din miljöresurs:

   {
     "identity": {
       "type": "SystemAssigned"
     }
   }
   

   Slå ihop detta fragment med din befintliga miljöresurs och behåll dess övriga konfiguration. Använd en miljö-API-version som stödjer hanterade identiteter, såsom 2026-03-02-preview. För resursschemat, se Microsoft. App/managedEnvironments.

   Aktivera Managed Identity för SMB (SMBOAuth) på lagringskontot och tilldela miljöidentiteten Storage File Data SMB MI Admin-rollen på lagringskontoområdet, enligt förkunskaperna.

   Använd sedan API-versionen 2026-03-02-preview för lagringsresursen. Ställ in properties.azureFile.identity på system för att välja miljöns systemtilldelade identitet:

   {
     "type": "Microsoft.App/managedEnvironments/storages",
     "apiVersion": "2026-03-02-preview",
     "name": "[concat(parameters('environment_name'), '/myazurefiles')]",
     "properties": {
       "azureFile": {
         "accountName": "[parameters('storage_account_name')]",
         "identity": "system",
         "shareName": "[parameters('storage_share_name')]",
         "accessMode": "ReadWrite"
       }
     }
   }
   

   För att använda en användartilldelad hanterad identitet istället, lägg till den i miljöns toppnivå-egenskap identity :

   {
     "identity": {
       "type": "UserAssigned",
       "userAssignedIdentities": {
         "[parameters('managed_identity_resource_id')]": {}
       }
     }
   }
   

   Definiera parametern managed_identity_resource_id som en string som innehåller identitetens fullständiga Azure resource ID. I lagringsresursen, sätt properties.azureFile.identity till [parameters('managed_identity_resource_id')] istället för system. Ge den identiteten samma roll på lagringskontot.

   Bevara alla identiteter som redan är tilldelade miljön. Om du aktiverar båda identitetstyperna, använd SystemAssigned,UserAssigned för miljöns identity.type och behåll dess userAssignedIdentities poster.

   Inkludera inte accountKey eller accountKeyVaultProperties när du använder hanterad identitetsautentisering. Information om schemat för lagringsresursen finns i Microsoft.App/managedEnvironments/storages.

   Autentisering av lagringskontonyckel (alternativ)

   För att använda en lagringskontonyckel istället, sätt accountKey och utelämna identity. Definiera mallparametern storage_account_key som en secureString.

   {
     "type": "Microsoft.App/managedEnvironments/storages",
     "apiVersion": "2022-03-01",
     "name": "[concat(parameters('environment_name'), '/myazurefiles')]",
     "properties": {
       "azureFile": {
         "accountName": "[parameters('storage_account_name')]",
         "accountKey": "[parameters('storage_account_key')]",
         "shareName": "[parameters('storage_share_name')]",
         "accessMode": "ReadWrite"
       }
     }
   }
   

   Dessa lagringsfragment förutsätter att miljön och fildelningen redan existerar. Om du distribuerar dem i samma mall, lägg till miljö- och fildelningsresurser i lagringsresursens dependsOn matris. För hanterad identitetsautentisering, lägg också till ett beroende av rolltilldelningen om du skapar den i den mallen. Ett driftsättningsberoende eliminerar inte fördröjningar i spridningen av rolltilldelningar.

2. Uppdatera resursen för containerappen för att lägga till en volym och en volymmontering.

   SMB-autentisering konfigureras i miljöns lagringsdefinition. Appnivå-volymkonfigurationen är densamma för autentisering med hanterad identitet och autentisering med lagringskontonyckel. Om du distribuerar lagringsresursen och containerappen i samma mall, lägg till lagringsresursen i containerappens dependsOn array.

   • SMB
   • NFS

   {
     "apiVersion": "2023-05-01",
     "type": "Microsoft.App/containerApps",
     "name": "[parameters('containerappName')]",
     "location": "[parameters('location')]",
     "properties": {
   
       ...
   
       "template": {
         "revisionSuffix": "myrevision",
         "containers": [
           {
             "name": "main",
             "image": "[parameters('container_image')]",
             "resources": {
               "cpu": 0.5,
               "memory": "1Gi"
             },
             "volumeMounts": [
               {
                 "mountPath": "/myfiles",
                 "volumeName": "azure-files-volume",
                 "subPath": "my-sub-path"
               }
             ]
           }
         ],
         "scale": {
           "minReplicas": 1,
           "maxReplicas": 3
         },
         "volumes": [
           {
             "name": "azure-files-volume",
             "storageType": "AzureFile",
             "storageName": "myazurefiles"
           }
         ]
       }
     }
   }
   

   • Lägg till en volumes matris i avsnittet i containerappdefinitionen template och definiera en volym. Om du redan har en volumes matris lägger du till en ny volym i matrisen.
     • name är en identifierare för volymen.
     • För storageTypeanvänder du AzureFile för SMB eller NfsAzureFile för NFS. Det här värdet måste matcha den lagringstyp som du definierade i miljön.
     • För storageNameanvänder du namnet på lagringen som du definierade i miljön.
     • mountOptions är en kommaavgränsad sträng med monteringsval. Mer information finns i Använd inställningar för mountOptions i Azure Files.
     • Listan secrets är en lista över sekretess som ska monteras i volymen. Mer information finns i Montera hemligheter i en volym.
   • För varje container i mallen som du vill montera Azure Files-lagring, definierar du en volymanslutning i volumeMounts matrisen för containerdefinitionen.
     • volumeName är namnet som definierats i matrisenvolumes.
     • mountPath är sökvägen i containern för att montera volymen.
     • subPath (valfritt) är sökvägen i volymen att montera. Om du inte specificerar det så monteras volymroten. För mer information, se Underväg.

Se API-specifikationen för ARM-mallen för ett fullständigt exempel.

Om du vill konfigurera en volymmontering för Azure Files lagring i Azure-portalen lägger du till en filresurs i containerappmiljön och lägger sedan till en volymmontering i containerappen genom att skapa en ny revision. För nya SMB-mounts, välj hanterad identitetsautentisering.

1. I Azure-portalen navigerar du till din Container Apps-miljö.

2. För SMB-hanterad identitetsautentisering, välj Inställningar>Identitet och aktivera en systemtilldelad identitet eller lägg till en användartilldelad identitet i miljön. Slutför lagringskontoinställningarna och rolltilldelningen som beskrivs i förutsättningarna för Azure Files innan du lägger till sharen.

3. I navigeringsfönstret går du till Inställningar och väljer Volymmonteringar.

4. Välj Lägg till.

5. Välj Server Message Block (SMB) eller NFS (Network File System), beroende på vilket protokoll som används av filresursen.

6. I kontrollpanelen Lägg till filresurs anger du följande information:

   • SMB
   • NFS

   • Namn: ett namn för miljöns lagringsdefinition.
   • Lagringskontonamn: Namnet på lagringskontot som innehåller filresursen.
   • Autentisering: Välj Managed identity (rekommenderas).
   • Identitet: Välj miljöns systemtilldelade identitet eller en användar-tilldelad identitet tilldelad miljön från den hanterade identitetslistan. Välj identiteten som har rollen Storage File Data SMB MI Admin på lagringskontot.
   • Fildelningsnamn: Namnet på SMB-fildelningen.
   • Åtkomstläge: Åtkomstläget för fildelningen. Giltiga värden är Läsa/Skriva och endast läsning.

   För att använda autentisering av lagringskontonyckeln istället, välj Lagringskontonyckel under Autentisering och ange lagringskontots åtkomstnyckel. Välj en autentiseringsmetod för lagringsdefinitionen.

7. Välj Lägg till för att avsluta kontextfönstret.

8. Välj Spara för att checka in ändringarna.

9. Gå till din containerapp.

10. I navigeringsfönstret, under Program, väljer du Revisioner och repliker.

11. Välj Skapa ny revision.

12. På sidan Skapa och distribuera ny revision väljer du fliken Volymer .

13. Välj Lägg till.

14. I fönstret Lägg till volymkontext anger du följande värden.

    • Volymtyp: Azure filvolym.
    • Namn: Ange ett volymnamn.
    • Filresursnamn: Välj den filresurs som du skapade tidigare.
    • Valfritt: Ange en kommaavgränsad sträng med monteringsalternativ. Mer information finns i Använd inställningar för mountOptions i Azure Files.

15. Välj Lägg till för att avsluta kontextfönstret.

16. På sidan Skapa och distribuera ny revision , välj fliken Container .

17. Välj den container som du vill montera volymen i.

18. I fönstret Redigera en containerkontext väljer du fliken Volymmonteringar .

19. Under Volymnamn väljer du den volym som du skapade tidigare.

20. I Monteringssökväg anger du den absoluta sökvägen i containern för att montera volymen.

21. I Delväg (valfritt) anger du sökvägen i volymen som ska monteras. Om du inte anger det här värdet monteras volymroten. För mer information, se Underväg.

22. Välj Spara för att spara ändringar och avsluta kontextfönstret.

23. Välj Skapa för att skapa den nya revisionen.