Tárolócsatlakozások használata az Azure Container Appsben

Amikor replika hatókörű tárolót konfigurál az Azure CLI használatával, yaML-definíciót kell használnia a tárolóalkalmazás létrehozásához vagy frissítéséhez.

1. Ha egy meglévő tárolóalkalmazást a replika hatókörű tároló használatára szeretne frissíteni, exportálja az alkalmazás specifikációját egy app.yaml nevű YAML-fájlba.

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

2. Végezze el az alábbi módosításokat a tárolóalkalmazás specifikációjához.

   • Adjon hozzá egy volumes tömböt a template tárolóalkalmazás definíciójának szakaszához, és definiáljon egy kötetet. Ha már rendelkezik tömbbel volumes , adjon hozzá egy új kötetet a tömbhöz.
     • Ez name a kötet azonosítója.
     • Használja EmptyDir a storageType.
   • A kötetet csatlakoztatni kívánt sablon minden tárolójában definiáljon egy kötetcsatlakoztatást a volumeMounts tárolódefiníció tömbjében.
     • Ez volumeName a tömbben definiált volumes név.
     • A mountPath kötet csatlakoztatásának elérési útja a tárolóban.

   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. Frissítse a tárolóalkalmazást a YAML-fájl használatával.

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

A teljes példáért tekintse meg a YAML specifikációját .

Replika hatókörű kötet létrehozásához és tárolóba való csatlakoztatásához hajtsa végre a következő módosításokat a tárolóalkalmazások erőforrásán egy ARM-sablonban:

• Adjon hozzá egy volumes tömböt a template tárolóalkalmazás definíciójának szakaszához, és definiáljon egy kötetet. Ha már rendelkezik tömbbel volumes , adjon hozzá egy új kötetet a tömbhöz.
  • Ez name a kötet azonosítója.
  • Használja EmptyDir a storageType.
• A kötetet csatlakoztatni kívánt sablon minden tárolójában definiáljon egy kötetcsatlakoztatást a volumeMounts tárolódefiníció tömbjében.
  • Ez volumeName a tömbben definiált volumes név.
  • A mountPath kötet csatlakoztatásának elérési útja a tárolóban.

Példa ARM-sablonrészletre:

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

A teljes példáért tekintse meg az ARM-sablon API-specifikációját .

Replika hatókörű kötet létrehozásához és tárolóba való csatlakoztatásához helyezze üzembe a tárolóalkalmazás új változatát az Azure Portalon.

1. Az Azure Portalon keresse meg a tárolóalkalmazást.

2. A bal oldali menüben válassza a Korrektúrakezelés lehetőséget.

3. Válassza az Új változat létrehozása lehetőséget.

4. Válassza ki azt a tárolót, amelyhez csatlakoztatni szeretné a kötetet.

5. A Tárolókörnyezet szerkesztése panelen válassza a Kötet csatlakoztatása lapot.

6. A Rövid élettartamú tárolás szakaszban hozzon létre egy új kötetet az alábbi információkkal.

   • Kötet neve: A rövid élettartamú kötet neve.
   • Csatlakoztatási útvonal: A tároló abszolút elérési útja a kötet csatlakoztatásához.

7. A módosítások mentéséhez és a környezeti panelről való kilépéshez válassza a Mentés lehetőséget.

8. Válassza a Létrehozás lehetőséget az új változat létrehozásához.

Amikor konfigurál egy tárolóalkalmazást egy Azure Files-kötet Azure CLI-vel való csatlakoztatásához, yaML-definíciót kell használnia a tárolóalkalmazás létrehozásához vagy frissítéséhez.

Az SMB-fájlmegosztások csatlakoztatásával kapcsolatos részletes oktatóanyagért tekintse meg az Azure Files storage-csatlakoztatásának létrehozását az Azure Container Appsben.

1. Adjon hozzá egy tárolódefiníciót a Container Apps-környezethez.

   • 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
   

   Cserélje le és <STORAGE_ACCOUNT_KEY> írja be <STORAGE_ACCOUNT_NAME> a tárfiók nevét és kulcsát. Cserélje le <STORAGE_SHARE_NAME> a tárfiókban lévő fájlmegosztás nevére.

   Érvényes értékek a következőkre ReadWrite és ReadOnly.--access-mode

2. Ha frissíteni szeretne egy meglévő tárolóalkalmazást egy fájlmegosztás csatlakoztatásához, exportálja az alkalmazás specifikációját egy app.yaml nevű YAML-fájlba.

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

3. Végezze el az alábbi módosításokat a tárolóalkalmazás specifikációjához.

   • Adjon hozzá egy volumes tömböt a template tárolóalkalmazás definíciójának szakaszához, és definiáljon egy kötetet. Ha már rendelkezik tömbbel volumes , adjon hozzá egy új kötetet a tömbhöz.
     • Ez name a kötet azonosítója.
     • AzureFile SMB-hez storageTypevagy NfsAzureFile NFS-hez. Ennek az értéknek meg kell egyeznie a környezetben definiált tárolási típussal.
     • Ehhez storageNamehasználja a környezetben definiált tároló nevét.
   • Az Azure Files Storage-hoz csatlakoztatni kívánt sablon minden tárolója esetében adjon meg egy kötetcsatlakoztatást a volumeMounts tárolódefiníció tömbjében.
     • Ez volumeName a tömbben definiált volumes név.
     • A mountPath kötet csatlakoztatásának elérési útja a tárolóban.
   • 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. Frissítse a tárolóalkalmazást a YAML-fájl használatával.

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

A teljes példáért tekintse meg a YAML specifikációját .

Az alábbi ARM-sablonrészletek bemutatják, hogyan adhat hozzá Azure Files-megosztást egy Container Apps-környezethez, és hogyan használhatja azt egy tárolóalkalmazásban.

1. storages Gyermekerőforrás hozzáadása a Container Apps-környezethez.

   • 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. Frissítse a tárolóalkalmazás erőforrását kötet- és kötetcsatlakoztatás hozzáadásához.

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

   • Adjon hozzá egy volumes tömböt a template tárolóalkalmazás definíciójának szakaszához, és definiáljon egy kötetet. Ha már rendelkezik tömbbel volumes , adjon hozzá egy új kötetet a tömbhöz.
     • Ez name a kötet azonosítója.
     • AzureFile SMB-hez storageTypevagy NfsAzureFile NFS-hez. Ennek az értéknek meg kell egyeznie a környezetben definiált tárolási típussal.
     • Ehhez storageNamehasználja a környezetben definiált tároló nevét.
   • Az Azure Files Storage-hoz csatlakoztatni kívánt sablon minden tárolója esetében adjon meg egy kötetcsatlakoztatást a volumeMounts tárolódefiníció tömbjében.
     • Ez volumeName a tömbben definiált volumes név.
     • A mountPath kötet csatlakoztatásának elérési útja a tárolóban.

A teljes példáért tekintse meg az ARM-sablon API-specifikációját .

Az Azure Files Storage mennyiségi csatlakoztatásának konfigurálásához az Azure Portalon adjon hozzá egy fájlmegosztást a Container Apps-környezethez, majd adjon hozzá egy kötetcsatlakoztatást a tárolóalkalmazáshoz egy új változat létrehozásával.

1. Az Azure Portalon navigáljon a Container Apps-környezethez.

2. A navigációs panel Beállítások csoportjában válassza az Azure Files lehetőséget.

3. Válassza a Hozzáadás lehetőséget.

4. A fájlmegosztás által használt protokolltól függően válassza a Kiszolgálói üzenetblokk (SMB) vagy a hálózati fájlrendszer (NFS) lehetőséget.

5. A Fájlmegosztás hozzáadása környezeti panelen adja meg a következő adatokat:

   • SMB
   • NFS

   • Név: A fájlmegosztás neve.
   • Tárfiók neve: A fájlmegosztást tartalmazó tárfiók neve.
   • Tárfiók kulcsa: A tárfiók hozzáférési kulcsa.
   • Fájlmegosztás: A fájlmegosztás neve.
   • Hozzáférési mód: A fájlmegosztás hozzáférési módja. Az érvényes értékek csak olvasási/írási és olvasási értékek.

6. Válassza a Hozzáadás lehetőséget a környezeti panelről való kilépéshez.

7. A módosítások véglegesítéséhez válassza a Mentés lehetőséget.

8. Lépjen a tárolóalkalmazáshoz.

9. A navigációs panel Alkalmazás területén válassza a Változatok és replikák lehetőséget.

10. Válassza az Új változat létrehozása lehetőséget.

11. Az Új változat létrehozása és üzembe helyezése lapon válassza a Kötetek lapot.

12. Válassza a Hozzáadás lehetőséget.

13. A Kötet hozzáadása környezeti panelen állítsa be a következőket.

    • Kötet típusa: Azure-fájlkötet.
    • Név: Adjon meg egy kötetnevet.
    • Fájlmegosztás neve: Válassza ki a korábban létrehozott fájlmegosztást.

14. Válassza a Hozzáadás lehetőséget a környezeti panelről való kilépéshez.

15. Az új változat létrehozása és ismételt üzembe helyezése lapon válassza a Tároló lapot.

16. Válassza ki azt a tárolót, amelyhez csatlakoztatni szeretné a kötetet.

17. A Tárolókörnyezet szerkesztése panelen válassza a Kötet csatlakoztatása lapot.

18. A Kötet neve területen válassza ki a korábban létrehozott kötetet.

19. A csatlakoztatási útvonalban adja meg a tároló abszolút elérési útját a kötet csatlakoztatásához.

20. A módosítások mentéséhez és a környezeti panelről való kilépéshez válassza a Mentés lehetőséget.

21. Válassza a Létrehozás lehetőséget az új változat létrehozásához.