Używanie instalacji magazynu w usłudze Azure Container Apps

Podczas konfigurowania magazynu o zakresie repliki przy użyciu interfejsu wiersza polecenia platformy Azure należy użyć definicji YAML do utworzenia lub zaktualizowania aplikacji kontenera.

1. Aby zaktualizować istniejącą aplikację kontenera do korzystania z magazynu o zakresie repliki, wyeksportuj specyfikację aplikacji do pliku YAML o nazwie app.yaml.

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

2. Wprowadź następujące zmiany w specyfikacji aplikacji kontenera.

   • Dodaj tablicę volumestemplate do sekcji definicji aplikacji kontenera i zdefiniuj wolumin. Jeśli masz już tablicę volumes , dodaj do niej nowy wolumin.
     • Jest name to identyfikator woluminu.
     • Użyj EmptyDir jako .storageType
   • Dla każdego kontenera w szablonie, w którym chcesz zainstalować wolumin, zdefiniuj instalację woluminu w tablicy volumeMounts definicji kontenera.
     • Jest to volumeName nazwa zdefiniowana w tablicy volumes .
     • Jest to mountPath ścieżka w kontenerze, w której ma zostać zainstalowany wolumin.

   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. Zaktualizuj aplikację kontenera przy użyciu pliku YAML.

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

Zobacz specyfikację YAML, aby zapoznać się z pełnym przykładem.

Aby utworzyć wolumin o zakresie repliki i zainstalować go w kontenerze, wprowadź następujące zmiany w zasobie aplikacji kontenera w szablonie usługi ARM:

• Dodaj tablicę volumestemplate do sekcji definicji aplikacji kontenera i zdefiniuj wolumin. Jeśli masz już tablicę volumes , dodaj do niej nowy wolumin.
  • Jest name to identyfikator woluminu.
  • Użyj EmptyDir jako .storageType
• Dla każdego kontenera w szablonie, w którym chcesz zainstalować wolumin, zdefiniuj instalację woluminu w tablicy volumeMounts definicji kontenera.
  • Jest to volumeName nazwa zdefiniowana w tablicy volumes .
  • Jest to mountPath ścieżka w kontenerze, w której ma zostać zainstalowany wolumin.

Przykładowy fragment kodu szablonu usługi ARM:

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

Aby zapoznać się z pełnym przykładem, zobacz specyfikację interfejsu API szablonu usługi ARM .

Aby utworzyć wolumin o zakresie repliki i zainstalować go w kontenerze, wdróż nową poprawkę aplikacji kontenera przy użyciu Azure Portal.

1. W Azure Portal przejdź do aplikacji kontenera.

2. Wybierz Zarządzanie wersjami w menu po lewej stronie.

3. Wybierz pozycję Utwórz nową poprawkę.

4. Wybierz kontener, w którym chcesz zainstalować wolumin.

5. W okienku Edytowanie kontekstu kontenera wybierz kartę Instalacje woluminów .

6. W sekcji Magazyn efemeryczny utwórz nowy wolumin z następującymi informacjami.

   • Nazwa woluminu: nazwa woluminu efemerycznego.
   • Ścieżka instalacji: ścieżka bezwzględna w kontenerze, aby zainstalować wolumin.

7. Wybierz pozycję Zapisz , aby zapisać zmiany i zamknąć okienko kontekstowe.

8. Wybierz pozycję Utwórz , aby utworzyć nową poprawkę.

Podczas konfigurowania aplikacji kontenera w celu zainstalowania woluminu Azure Files przy użyciu interfejsu wiersza polecenia platformy Azure należy użyć definicji YAML do utworzenia lub zaktualizowania aplikacji kontenera.

Aby zapoznać się z samouczkiem krok po kroku dotyczącym instalowania udziału plików SMB, zobacz Tworzenie instalacji magazynu Azure Files w usłudze Azure Container Apps.

1. Dodaj definicję magazynu do środowiska usługi Container Apps.

   • 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
   

   Zastąp <STORAGE_ACCOUNT_NAME> i <STORAGE_ACCOUNT_KEY> nazwą i kluczem konta magazynu. Zastąp <STORAGE_SHARE_NAME> ciąg nazwą udziału plików na koncie magazynu.

   Prawidłowe wartości dla --access-mode to i ReadWriteReadOnly.

2. Aby zaktualizować istniejącą aplikację kontenera w celu zainstalowania udziału plików, wyeksportuj specyfikację aplikacji do pliku YAML o nazwie app.yaml.

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

3. Wprowadź następujące zmiany w specyfikacji aplikacji kontenera.

   • Dodaj tablicę volumestemplate do sekcji definicji aplikacji kontenera i zdefiniuj wolumin. Jeśli masz już tablicę volumes , dodaj do niej nowy wolumin.
     • Jest name to identyfikator woluminu.
     • W przypadku storageTypeprogramu należy użyć AzureFile protokołu SMB lub NfsAzureFile systemu plików NFS. Ta wartość musi być zgodna z typem magazynu zdefiniowanym w środowisku.
     • W przypadku storageNameprogramu użyj nazwy magazynu zdefiniowanego w środowisku.
     • Jest to mountOptions oddzielony przecinkami ciąg opcji montowania. Aby uzyskać więcej informacji, zobacz Używanie ustawień mountOptions w Azure Files.
     • Lista secrets jest listą wpisów tajnych do zainstalowania w woluminie. Aby uzyskać więcej informacji, zobacz Instalowanie wpisów tajnych w woluminie.
   • Dla każdego kontenera w szablonie, który chcesz zainstalować w magazynie Azure Files, zdefiniuj instalację woluminu w tablicy volumeMounts definicji kontenera.
     • Jest to volumeName nazwa zdefiniowana w tablicy volumes .
     • Jest to mountPath ścieżka w kontenerze, w której ma zostać zainstalowany wolumin.
     • Jest subPath to ścieżka w woluminie do zainstalowania. Jeśli nie zostanie określony, zostanie zainstalowany katalog główny. Aby uzyskać więcej informacji, zobacz (#sub-path).
   • 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. Zaktualizuj aplikację kontenera przy użyciu pliku YAML.

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

Zobacz specyfikację YAML, aby zapoznać się z pełnym przykładem.

Poniższe fragmenty szablonu usługi ARM pokazują, jak dodać udział Azure Files do środowiska usługi Container Apps i używać go w aplikacji kontenera.

1. Dodaj zasób podrzędny storages do środowiska usługi Container Apps.

   • 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. Zaktualizuj zasób aplikacji kontenera, aby dodać wolumin i instalację woluminu.

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

   • Dodaj tablicę volumestemplate do sekcji definicji aplikacji kontenera i zdefiniuj wolumin. Jeśli masz już tablicę volumes , dodaj do niej nowy wolumin.
     • Jest name to identyfikator woluminu.
     • W przypadku storageTypeprogramu należy użyć AzureFile protokołu SMB lub NfsAzureFile systemu plików NFS. Ta wartość musi być zgodna z typem magazynu zdefiniowanym w środowisku.
     • W przypadku storageNameprogramu użyj nazwy magazynu zdefiniowanego w środowisku.
     • Jest to mountOptions oddzielony przecinkami ciąg opcji montowania. Aby uzyskać więcej informacji, zobacz Używanie ustawień mountOptions w Azure Files.
     • Lista secrets jest listą wpisów tajnych do zainstalowania w woluminie. Aby uzyskać więcej informacji, zobacz Instalowanie wpisów tajnych w woluminie.
   • Dla każdego kontenera w szablonie, który chcesz zainstalować w magazynie Azure Files, zdefiniuj instalację woluminu w tablicy volumeMounts definicji kontenera.
     • Jest to volumeName nazwa zdefiniowana w tablicy volumes .
     • Jest to mountPath ścieżka w kontenerze, w której ma zostać zainstalowany wolumin.
     • Wartość subPath (opcjonalna) to ścieżka w woluminie do zainstalowania. Jeśli nie zostanie określony, zostanie zainstalowany katalog główny. Aby uzyskać więcej informacji, zobacz (#sub-path).

Aby zapoznać się z pełnym przykładem, zobacz specyfikację interfejsu API szablonu usługi ARM .

Aby skonfigurować instalację woluminu dla magazynu Azure Files w Azure Portal, dodaj udział plików do środowiska Container Apps, a następnie dodaj instalację woluminu do aplikacji kontenera, tworząc nową poprawkę.

1. W Azure Portal przejdź do środowiska usługi Container Apps.

2. W okienku nawigacji w obszarze Ustawienia wybierz pozycję Azure Files.

3. Wybierz Dodaj.

4. Wybierz pozycję Server Message Block (SMB) lub Network File System (NFS), w zależności od protokołu używanego przez udział plików.

5. W okienku kontekstowym Dodawanie udziału plików wprowadź następujące informacje:

   • SMB
   • NFS

   • Nazwa: nazwa udziału plików.
   • Nazwa konta magazynu: nazwa konta magazynu, które zawiera udział plików.
   • Klucz konta magazynu: klucz dostępu dla konta magazynu.
   • Udział plików: nazwa udziału plików.
   • Tryb dostępu: tryb dostępu do udziału plików. Prawidłowe wartości to Odczyt/Zapis i Tylko do odczytu.

6. Wybierz pozycję Dodaj , aby zamknąć okienko kontekstowe.

7. Wybierz pozycję Zapisz , aby zatwierdzić zmiany.

8. Przejdź do aplikacji kontenera.

9. W okienku nawigacji w obszarze Aplikacja wybierz pozycję Poprawki i repliki.

10. Wybierz pozycję Utwórz nową poprawkę.

11. Na stronie Tworzenie i wdrażanie nowej poprawki wybierz kartę Woluminy .

12. Wybierz Dodaj.

13. W okienku Dodawanie kontekstu woluminu ustaw następujące ustawienia.

    • Typ woluminu: wolumin pliku platformy Azure.
    • Nazwa: Wprowadź nazwę woluminu.
    • Nazwa udziału plików: wybierz utworzony wcześniej udział plików.
    • Opcje montowania: Opcjonalnie wprowadź oddzielony przecinkami ciąg opcji montowania. Aby uzyskać więcej informacji, zobacz Używanie ustawień mountOptions w Azure Files.

14. Wybierz pozycję Dodaj , aby zamknąć okienko kontekstowe.

15. Na stronie Tworzenie i ponowne stosowanie nowej poprawki wybierz kartę Kontener .

16. Wybierz kontener, w którym chcesz zainstalować wolumin.

17. W okienku Edytowanie kontekstu kontenera wybierz kartę Instalacje woluminów .

18. W obszarze Nazwa woluminu wybierz utworzony wcześniej wolumin.

19. W polu Ścieżka instalacji wprowadź ścieżkę bezwzględną w kontenerze, aby zainstalować wolumin.

20. W polu Ścieżka podrzędna (opcjonalnie) wprowadź ścieżkę w woluminie do zainstalowania. Jeśli nie zostanie określony, zostanie zainstalowany katalog główny. Aby uzyskać więcej informacji, zobacz (#sub-path).

21. Wybierz pozycję Zapisz , aby zapisać zmiany i zamknąć okienko kontekstowe.

22. Wybierz pozycję Utwórz , aby utworzyć nową poprawkę.