Jak włączyć własny magazyn trwały w usłudze Azure Spring Apps

Note

Plany Podstawowy, Standardowy i Enterprise weszły w okres wycofania z dniem 17 marca 2025 r. Aby uzyskać więcej informacji, zobacz ogłoszenie o wycofaniu usługi Azure Spring Apps.

Ten artykuł dotyczy:✅ Java ✅ C#

Ten artykuł dotyczy:✅ Podstawowa/Standardowa ✅ Enterprise

W tym artykule pokazano, jak włączyć własny magazyn trwały w usłudze Azure Spring Apps.

W przypadku korzystania z wbudowanego magazynu trwałego w usłudze Azure Spring Apps artefakty generowane przez aplikację są przekazywane do kont usługi Azure Storage. Firma Microsoft kontroluje zasady zarządzania szyfrowaniem danych w stanie spoczynku i zarządzania cyklem życia dla tych artefaktów.

W przypadku korzystania z własnego magazynu trwałego artefakty generowane przez aplikację są przekazywane do konta magazynu, które kontrolujesz. Kontrolujesz zasady szyfrowania w spoczynku, zasady zarządzania okresem istnienia i dostęp do sieci. Odpowiadasz za koszty związane z tym kontem przechowywania.

Prerequisites

Istniejące konto usługi Azure i istniejący Azure File Share. Jeśli musisz utworzyć konto przechowywania i udział plików w usłudze Azure, zobacz Tworzenie udziału plików SMB w usłudze Azure.
Interfejs wiersza polecenia platformy Azure w wersji 2.45.0 lub nowszej.

Important

Jeśli wdrożyłeś Azure Spring Apps we własnej sieci wirtualnej i chcesz, aby konto magazynu było dostępne tylko z tej sieci, zapoznaj się z Używanie prywatnych punktów końcowych dla Azure Storage oraz sekcją Udzielanie dostępu z sieci wirtualnej w temacie Konfigurowanie zapór i sieci wirtualnych dla Azure Storage.

Podłączanie własnego dodatkowego magazynu trwałego do aplikacji

Note

Aktualizowanie magazynu trwałego powoduje ponowne uruchomienie aplikacji.

W przypadku korzystania z integracji sieci wirtualnej upewnij się, że porty 80 i 445 są otwarte.

Portal Azure
"Azure CLI"

Wykonaj poniższe kroki, aby powiązać konto Azure Storage jako zasób magazynowy w Azure Spring Apps, a następnie utworzyć aplikację z własnym trwałym magazynem.

Przejdź do strony Przegląd usługi, a następnie wybierz Magazyn w okienku nawigacji po lewej.
Na stronie Magazyn wybierz pozycję Dodaj magazyn.

Wprowadź następujące informacje na stronie Dodawanie pamięci, a następnie wybierz Zastosuj.

Setting	Value
Nazwa magazynu	Nazwa zasobu magazynu, będącego zasobem na poziomie usługi w usłudze Azure Spring Apps.
Nazwa konta	Nazwa konta magazynu.
Klucz konta	Klucz konta przechowywania.

Przejdź do strony Aplikacje , a następnie wybierz aplikację, aby zainstalować magazyn trwały.
Wybierz pozycję Konfiguracja, a następnie wybierz pozycję Magazyn trwały.

Wybierz pozycję Dodaj magazyn trwały. Dodaj wartości w poniższej tabeli, a następnie wybierz pozycję Zastosuj.

Setting	Value
Nazwa magazynu	Nazwa zasobu magazynu, którą podałeś wcześniej.
Trwały typ magazynu	AzureFileVolume
Nazwa udostępniania	Nazwa udziału plików platformy Azure na koncie usługi Azure Storage.
Ścieżka instalacji	Unikatowa ścieżka montowania.
Opcje montowania	Optional
Tylko do odczytu	Optional

Wybierz pozycję Zapisz , aby zastosować zmiany konfiguracji.

Wykonaj poniższe kroki, aby skonfigurować dostęp do własnej przestrzeni magazynowej za pomocą Azure CLI.

Użyj następującego polecenia, aby powiązać swoje konto Azure Storage jako zasób magazynowy w wystąpieniu Azure Spring Apps.

az spring storage add \
   --resource-group <resource-group-name> \
   --service <Azure-Spring-Apps-instance-name> \
   --name <storage-resource-name> \
   --storage-type StorageAccount \
   --account-name <account-name> \
   --account-key <account-key>

Użyj następującego polecenia, aby utworzyć aplikację z własną pamięcią trwałą.

az spring app create \
    --resource-group <resource-group-name> \
    --service <Azure-Spring-Apps-instance-name> \
    --name <app-name> \
    --persistent-storage <path-to-JSON-file>

W poniższym przykładzie pokazano plik JSON przekazany do parametru --persistent-storage .

{
   "customPersistentDisks": [
      {
          "storageName": "<storage-resource-name>",
          "customPersistentDiskProperties": {
              "type": "AzureFileVolume",
              "shareName": "<Azure-file-share-name>",
              "mountPath": "<unique-mount-path>",
              "mountOptions": [
                  "uid=0",
                  "gid=0"
               ],
               "readOnly": false
            }
      },
      {
          "storageName": "<storage-resource-name>",
          "customPersistentDiskProperties": {
              "type": "AzureFileVolume",
              "shareName": "<Azure-file-share-name>",
              "mountPath": "<unique-mount-path>",
              "readOnly": true
          }
      }
   ]
}

Opcjonalnie użyj następującego polecenia, aby dodać dodatkowy magazyn trwały do istniejącej aplikacji.

az spring app append-persistent-storage \
    --resource-group <resource-group-name> \
    --service <Azure-Spring-Apps-instance-name> \
    --name <app-name> \
    --persistent-storage-type AzureFileVolume \
    --share-name <Azure-file-share-name> \
    --mount-path <unique-mount-path> \
    --storage-name <storage-resource-name>

Opcjonalnie użyj następującego polecenia, aby wyświetlić listę istniejącej trwałej pamięci masowej określonego zasobu magazynowego.

az spring storage list-persistent-storage \
    --resource-group <resource-group-name> \
    --service <Azure-Spring-Apps-instance-name> \
    --name <storage-resource-name>

Najlepsze rozwiązania

Podczas dodawania własnego magazynu trwałego do usługi Azure Spring Apps skorzystaj z poniższych najlepszych rozwiązań.

Aby uniknąć potencjalnych problemów z opóźnieniami, umieść wystąpienie usługi Azure Spring Apps i konto usługi Azure Storage w tym samym regionie świadczenia usługi Azure.
Na koncie usługi Azure Storage unikaj ponownego generowania klucza konta, którego używasz. Konto magazynu zawiera dwa różne klucze. Użyj podejścia krok po kroku, aby upewnić się, że magazyn trwały pozostaje dostępny dla aplikacji podczas ponownego uruchamiania klucza.

Na przykład wykonaj następujące kroki, aby upewnić się, że magazyn trwały pozostaje dostępny, jeśli użyłeś key1 do powiązania konta magazynu z usługą Azure Spring Apps.
1. Wygeneruj key2ponownie .
2. Zaktualizuj klucz konta zasobu magazynowego, aby użyć ponownie wygenerowanego key2.
3. Uruchom ponownie aplikacje, które montują pamięć trwałą z tego zasobu pamięci. Użyj polecenia , az spring storage list-persistent-storage aby wyświetlić listę wszystkich powiązanych aplikacji.
4. Wygeneruj key1ponownie .
Jeśli usuniesz konto magazynu Azure lub udział plików Azure, unikaj możliwych błędów, usuwając odpowiadający im zasób magazynu lub trwały magazyn używany przez aplikacje.
Jeśli chcesz zapisywać pliki w tej samej ścieżce dla każdego pojedynczego wystąpienia aplikacji, ale trzymać je w oddzielnych podkatalogach z punktu widzenia udziału plików, możesz użyć opcji SubPath. Należy pamiętać, że SubPath opcja jest niezgodna z Read only , ponieważ SubPath jest używana do zapisywania nowych plików i Read only jest używana do odczytywania istniejących plików.

Często zadawane pytania

Ta sekcja zawiera często zadawane pytania dotyczące używania własnego magazynu trwałego w usłudze Azure Spring Apps.

Jeśli włączono wbudowany magazyn trwały, a następnie włączono własny magazyn jako dodatkowy magazyn trwały, czy moje dane są migrowane na moje konto usługi Azure Storage?

No. Jednak wkrótce udostępnimy dokument, który pomoże Ci przeprowadzić migrację.
Jakie są zarezerwowane ścieżki instalacji?

Usługa Azure Spring Apps rezerwuje następujące ścieżki instalacji:
- /tmp
- /persistent
- /secrets
- /app-insights/agents
- /etc/azure-spring-cloud/certs
- /app-insights/agents/settings
- /app-lifecycle/settings
Jakie są dostępne opcje instalacji?

Obecnie obsługujemy następujące opcje instalacji:
- uid
- gid
- file_mode
- dir_mode
Właściwość mountOptions jest opcjonalna. Wartości domyślne dla tych opcji instalacji to: ["uid=0", "gid=0", "file_mode=0777", "dir_mode=0777"]
Używam punktu końcowego usługi do skonfigurowania konta magazynowego, aby zezwolić na dostęp tylko z mojej własnej sieci wirtualnej. Dlaczego podczas próby zainstalowania niestandardowego magazynu trwałego w aplikacjach wystąpił błąd Odmowy uprawnień ?

Punkt końcowy usługi zapewnia dostęp sieciowy tylko na poziomie podsieci. Upewnij się, że do zakresu punktu końcowego usługi dodano obie podsieci używane przez wystąpienie usługi Azure Spring Apps.

Dalsze kroki

Sprzężenie zwrotne

Czy ta strona była pomocna?

Last updated on 2025-10-31