Verwenden von Speicherbereitstellungen in Azure Container Apps

Wenn Sie replikatbezogenen Speicher mithilfe der Azure CLI konfigurieren, müssen Sie eine YAML-Definition verwenden, um Ihre Container-App zu erstellen oder zu aktualisieren.

1. Wenn Sie eine vorhandene Container-App aktualisieren möchten, um replikatbezogenen Speicher zu verwenden, exportieren Sie die Spezifikation Ihrer App in eine YAML-Datei namens app.yaml.

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

2. Nehmen Sie die folgenden Änderungen an der Spezifikation Ihrer Container-App vor.

   • Fügen Sie dem Abschnitt template Ihrer Container-App-Definition ein volumes-Array hinzu, und definieren Sie ein Volume. Wenn Sie bereits über ein volumes-Array verfügen, fügen Sie dem Array ein neues Volume hinzu.
     • name ist ein Bezeichner für das Volume.
     • Verwenden Sie EmptyDir als storageType.
   • Definieren Sie für jeden Container in der Vorlage, für den Sie das Volume einbinden möchten, eine Volumeeinbindung im volumeMounts-Array der Containerdefinition.
     • volumeName ist der Name, der im volumes-Array definiert ist.
     • mountPath ist der Pfad im Container zum Einbinden des Volumes.

   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. Aktualisieren Sie Ihre Container-App mithilfe der YAML-Datei.

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

Ein vollständiges Beispiel finden Sie in der YAML-Spezifikation.

Wenn Sie ein replikatbezogenes Volume erstellen und in einen Container einbinden möchten, nehmen Sie die folgenden Änderungen an der Container-App-Ressource in einer ARM-Vorlage vor:

• Fügen Sie dem Abschnitt template Ihrer Container-App-Definition ein volumes-Array hinzu, und definieren Sie ein Volume. Wenn Sie bereits über ein volumes-Array verfügen, fügen Sie dem Array ein neues Volume hinzu.
  • name ist ein Bezeichner für das Volume.
  • Verwenden Sie EmptyDir als storageType.
• Definieren Sie für jeden Container in der Vorlage, für den Sie das Volume einbinden möchten, eine Volumeeinbindung im volumeMounts-Array der Containerdefinition.
  • volumeName ist der Name, der im volumes-Array definiert ist.
  • mountPath ist der Pfad im Container zum Einbinden des Volumes.

ARM-Beispielvorlagenausschnitt:

{
  "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"
        }
      ]
    }
  }
}

Ein vollständiges Beispiel finden Sie in der ARM-Vorlagen-API-Spezifikation.

Um ein replikatbezogenes Volume zu erstellen und in einem Container bereitzustellen, stellen Sie eine neue Revision Ihrer Container-App mithilfe des Azure-Portals bereit.

1. Navigieren Sie im Azure-Portal zu Ihrer Container-App.

2. Wählen Sie im linken Menü Revisionsverwaltung aus.

3. Wählen Sie Create new revision (Neue Revision erstellen) aus.

4. Wählen Sie den Container aus, in den Sie das Volume einbinden möchten.

5. Wählen Sie im Kontextbereich Container bearbeiten die Registerkarte Volumeeinbindungen aus.

6. Erstellen Sie im Abschnitt Flüchtiger Speicher ein neues Volume mit den folgenden Informationen:

   • Volumename: Ein Name für das kurzlebige Volume
   • Bereitstellungspfad: Der absolute Pfad im Container zum Einbinden des Volumes

7. Wählen Sie Speichern aus, um Änderungen zu speichern und den Kontextbereich zu beenden.

8. Wählen Sie Erstellen aus, um die neue Revision zu erstellen.

Wenn Sie eine Container-App zum Einbinden eines Azure Files-Volumes mithilfe der Azure CLI konfigurieren, müssen Sie eine YAML-Definition verwenden, um Ihre Container-App zu erstellen oder zu aktualisieren.

Eine Schritt-für-Schritt-Anleitung zum Einbinden einer SMB-Dateifreigabe finden Sie unter Tutorial: Erstellen einer Azure Files-Volumeeinbindung in Azure Container Apps.

1. Fügen Sie eine Speicherdefinition zu Ihrer Container Apps-Umgebung hinzu.

   • SMB
   • NFS

   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
   

   Ersetzen Sie <STORAGE_ACCOUNT_NAME> und <STORAGE_ACCOUNT_KEY> durch den Namen und Schlüssel Ihres Speicherkontos. Ersetzen Sie <STORAGE_SHARE_NAME> durch den Namen der Dateifreigabe im Speicherkonto.

   Gültige Werte für --access-mode sind ReadWrite und ReadOnly.

2. Wenn Sie eine vorhandene Container-App aktualisieren möchten, um eine Dateifreigabe einzubinden, exportieren Sie die Spezifikation Ihrer App in eine YAML-Datei namens app.yaml.

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

3. Nehmen Sie die folgenden Änderungen an der Spezifikation Ihrer Container-App vor.

   • Fügen Sie dem Abschnitt template Ihrer Container-App-Definition ein volumes-Array hinzu, und definieren Sie ein Volume. Wenn Sie bereits über ein volumes-Array verfügen, fügen Sie dem Array ein neues Volume hinzu.
     • name ist ein Bezeichner für das Volume.
     • Verwenden Sie AzureFile (SMB) oder NfsAzureFile (NFS) für storageType. Dieser Wert muss mit dem Speichertyp übereinstimmen, den Sie in der Umgebung definiert haben.
     • Verwenden Sie für storageName den Namen des Speichers, den Sie in der Umgebung definiert haben.
   • Definieren Sie für jeden Container in der Vorlage, für den Sie Azure Files-Speicher einbinden möchten, eine Volumeeinbindung im volumeMounts-Array der Containerdefinition.
     • volumeName ist der Name, der im volumes-Array definiert ist.
     • mountPath ist der Pfad im Container zum Einbinden des Volumes.
   • 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
       volumes:
       - name: azure-files-volume
         storageType: AzureFile
         storageName: mystorage
   

4. Aktualisieren Sie Ihre Container-App mithilfe der YAML-Datei.

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

Ein vollständiges Beispiel finden Sie in der YAML-Spezifikation.

Die folgenden ARM-Vorlagenausschnitte veranschaulichen, wie Sie einer Container Apps-Umgebung eine Azure Files-Freigabe hinzufügen und sie in einer Container-App verwenden.

1. Fügen Sie der Container Apps-Umgebung eine untergeordnete storages-Ressource hinzu.

   • SMB
   • NFS

   {
     "type": "Microsoft.App/managedEnvironments",
     "apiVersion": "2022-03-01",
     "name": "[parameters('environment_name')]",
     "location": "[parameters('location')]",
     "properties": {
       "daprAIInstrumentationKey": "[parameters('dapr_ai_instrumentation_key')]",
       "appLogsConfiguration": {
         "destination": "log-analytics",
         "logAnalyticsConfiguration": {
           "customerId": "[parameters('log_analytics_customer_id')]",
           "sharedKey": "[parameters('log_analytics_shared_key')]"
         }
       }
     },
     "resources": [
       {
         "type": "storages",
         "name": "myazurefiles",
         "apiVersion": "2022-03-01",
         "dependsOn": [
           "[resourceId('Microsoft.App/managedEnvironments', parameters('environment_name'))]"
         ],
         "properties": {
           "azureFile": {
             "accountName": "[parameters('storage_account_name')]",
             "accountKey": "[parameters('storage_account_key')]",
             "shareName": "[parameters('storage_share_name')]",
             "accessMode": "ReadWrite"
           }
         }
       }
     ]
   }
   

2. Aktualisieren Sie die Container-App-Ressource, um ein Volume und eine Volumeeinbindung hinzuzufügen.

   • 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"
               }
             ]
           }
         ],
         "scale": {
           "minReplicas": 1,
           "maxReplicas": 3
         },
         "volumes": [
           {
             "name": "azure-files-volume",
             "storageType": "AzureFile",
             "storageName": "myazurefiles"
           }
         ]
       }
     }
   }
   

   • Fügen Sie dem Abschnitt template Ihrer Container-App-Definition ein volumes-Array hinzu, und definieren Sie ein Volume. Wenn Sie bereits über ein volumes-Array verfügen, fügen Sie dem Array ein neues Volume hinzu.
     • name ist ein Bezeichner für das Volume.
     • Verwenden Sie AzureFile (SMB) oder NfsAzureFile (NFS) für storageType. Dieser Wert muss mit dem Speichertyp übereinstimmen, den Sie in der Umgebung definiert haben.
     • Verwenden Sie für storageName den Namen des Speichers, den Sie in der Umgebung definiert haben.
   • Definieren Sie für jeden Container in der Vorlage, für den Sie Azure Files-Speicher einbinden möchten, eine Volumeeinbindung im volumeMounts-Array der Containerdefinition.
     • volumeName ist der Name, der im volumes-Array definiert ist.
     • mountPath ist der Pfad im Container zum Einbinden des Volumes.

Ein vollständiges Beispiel finden Sie in der ARM-Vorlagen-API-Spezifikation.