Povolení vlastního trvalého úložiště v Azure Spring Apps

Poznámka:

Plány Basic, Standard a Enterprise budou od poloviny března 2025 vyřazeny ze 3letého období vyřazení. Doporučujeme přejít na Azure Container Apps. Další informace najdete v oznámení o vyřazení Azure Spring Apps.

Od 30. září 2024 bude od 30. září 2024 zastaralý plán s úplným vypnutím po šesti měsících. Doporučujeme přejít na Azure Container Apps. Další informace najdete v tématu Migrace spotřeby Azure Spring Apps Úrovně Standard a vyhrazeného plánu do Azure Container Apps.

Tento článek se vztahuje na:✅ Java ✅ C#

Tento článek se vztahuje na:✅ Basic/Standard ✅ Enterprise

V tomto článku se dozvíte, jak povolit vlastní trvalé úložiště v Azure Spring Apps.

Při použití integrovaného trvalého úložiště v Azure Spring Apps se artefakty vygenerované vaší aplikací nahrají do účtů služby Azure Storage. Microsoft řídí zásady správy neaktivních uložených dat a životnosti šifrování těchto artefaktů.

Když používáte vlastní trvalé úložiště, artefakty vygenerované vaší aplikací se nahrají do účtu úložiště, který řídíte. Řídíte zásady šifrování neaktivních uložených dat, zásady správy životnosti a síťový přístup. Zodpovídáte za náklady spojené s tímto účtem úložiště.

Požadavky

• Existující účet služby Azure Storage a existující sdílená složka Azure. Pokud potřebujete vytvořit účet úložiště a sdílenou složku v Azure, přečtěte si téma Vytvoření sdílené složky Azure SMB.
• Azure CLI verze 2.45.0 nebo vyšší

Důležité

Pokud jste nasadili službu Azure Spring Apps ve vlastní virtuální síti a chcete, aby byl účet úložiště přístupný jenom z virtuální sítě, přečtěte si téma Použití privátních koncových bodů pro Azure Storage a udělení přístupu z části Konfigurace bran firewall a virtuálních sítí služby Azure Storage.

Připojení vlastního dalšího trvalého úložiště k aplikacím

Poznámka:

Aktualizace trvalého úložiště restartuje vaše aplikace.

Pokud používáte integraci virtuální sítě, ujistěte se, že jsou otevřené porty 80 a 445.

Azure Portal

Následující postup použijte k vytvoření vazby účtu Azure Storage jako prostředku úložiště ve službě Azure Spring Apps a vytvoření aplikace s vlastním trvalým úložištěm.

1. Přejděte na stránku Přehled služby a v levém navigačním podokně vyberte Úložiště.

2. Na stránce Úložiště vyberte Přidat úložiště.

   

3. Na stránce Přidat úložiště zadejte následující informace a pak vyberte Použít.

   Nastavení	Hodnota
   Název úložiště	Název prostředku úložiště, což je prostředek na úrovni služby v Azure Spring Apps.
   Název účtu	Název účtu úložiště.
   Klíč účtu	Klíč účtu úložiště.

   

4. Přejděte na stránku Aplikace a vyberte aplikaci pro připojení trvalého úložiště.

   

5. Vyberte Možnost Konfigurace a pak vyberte Trvalé úložiště.

6. Vyberte Přidat trvalé úložiště. Přidejte hodnoty v následující tabulce a pak vyberte Použít.

   Nastavení	Hodnota
   Název úložiště	Název prostředku úložiště, který jste zadali dříve.
   Trvalý typ úložiště	AzureFileVolume
   Název sdílené složky	Název sdílené složky Azure v účtu Azure Storage.
   Cesta připojení	Jedinečná cesta připojení.
   Možnosti připojení	Volitelné
   Jen pro čtení	Volitelné

   

7. Chcete-li použít změny konfigurace, vyberte Uložit .

   

Azure CLI

Pomocí následujících kroků povolte vlastní úložiště pomocí Azure CLI.

1. Pomocí následujícího příkazu vytvořte vazbu účtu Azure Storage jako prostředku úložiště v instanci 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>
   

2. Pomocí následujícího příkazu vytvořte aplikaci s vlastním trvalým úložištěm.

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

   Následující příklad ukazuje soubor JSON předaný 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
             }
         }
      ]
   }
   

3. Volitelně můžete pomocí následujícího příkazu přidat do existující aplikace další trvalé úložiště.

   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>
   

4. Volitelně můžete pomocí následujícího příkazu vypsat existující trvalé úložiště konkrétního prostředku úložiště.

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

Osvědčené postupy

Při přidávání vlastního trvalého úložiště do Azure Spring Apps použijte následující osvědčené postupy.

• Pokud se chcete vyhnout potenciálním problémům s latencí, umístěte instanci Azure Spring Apps a účet služby Azure Storage do stejné oblasti Azure.

• V účtu úložiště Azure se vyhněte opětovnému vygenerování klíče účtu, který používáte. Účet úložiště obsahuje dva různé klíče. Pomocí podrobného přístupu se ujistěte, že trvalé úložiště zůstává dostupné pro aplikace během regenerace klíčů.

  Pomocí následujícího postupu se například ujistěte, že trvalé úložiště zůstane dostupné, pokud jste použili klíč1 k vytvoření vazby účtu úložiště k Azure Spring Apps.

  1. Znovu vygenerujte klíč2.
  2. Aktualizujte klíč účtu prostředku úložiště tak, aby používal znovu vygenerovaný klíč2.
  3. Restartujte aplikace, které připojují trvalé úložiště z tohoto prostředku úložiště. az spring storage list-persistent-storage Pomocí příkazu zobrazíte seznam všech souvisejících aplikací.
  4. Znovu vygenerujte klíč1.

• Pokud odstraníte účet služby Azure Storage nebo sdílenou složku Azure, vyhněte se možným chybám odebráním odpovídajícího prostředku úložiště nebo trvalého úložiště v aplikacích.

• Pokud chcete zapisovat soubory do stejné cesty pro každou instanci aplikace, ale ponechat je v samostatných podadresářích z pohledu sdílené složky, můžete použít možnost SubPath . Všimněte si, že možnost SubPath není kompatibilní se čtením jen pro čtení, protože SubPath se používá k zápisu nových souborů a ke čtení existujících souborů se používá jen pro čtení.

Často kladené dotazy

Tato část se zabývá nejčastějšími dotazy týkajícími se používání vlastního trvalého úložiště se službou Azure Spring Apps.

• Pokud mám předdefinované trvalé úložiště povolené a pak jsem povolil(a) vlastní úložiště jako dodatečné trvalé úložiště, migrují se moje data do svého účtu Azure Storage?

  Ne. Poskytneme vám ale dokument, který vám pomůže s migrací sami.

• Jaké jsou rezervované cesty připojení?

  Azure Spring Apps si vyhrazuje následující cesty připojení:

  • /Tmp
  • /vytrvalý
  • /tajemství
  • /app-insights/agents
  • /etc/azure-spring-cloud/certs
  • /app-insights/agents/settings
  • /app-lifecycle/settings

• Jaké jsou dostupné možnosti připojení?

  V současné době podporujeme následující možnosti připojení:

  • uid
  • gid
  • file_mode
  • dir_mode

  Vlastnost mountOptions je nepovinná. Výchozí hodnoty těchto možností připojení jsou: ["uid=0", "gid=0", "file_mode=0777", "dir_mode=0777"]

• Používám koncový bod služby ke konfiguraci účtu úložiště tak, aby umožňoval přístup pouze z vlastní virtuální sítě. Proč se mi při pokusu o připojení vlastního trvalého úložiště k aplikacím zobrazila chyba Odepření oprávnění?

  Koncový bod služby poskytuje přístup k síti pouze na úrovni podsítě. Ujistěte se, že jste do oboru koncového bodu služby přidali obě podsítě používané instancí Azure Spring Apps.

Další kroky

• Použití zpětného protokolování k zápisu protokolů do vlastního trvalého úložiště
• Škálování aplikace v Azure Spring Apps