Rychlý start: Nasazení aplikace řízené událostmi do Azure Spring Apps
Článek
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.
Tento článek se vztahuje na:✅ Využití standardu a vyhrazené (Preview) ✅ Basic/Standard ✅ Enterprise
Tento článek vysvětluje, jak nasadit aplikaci řízenou událostmi Spring Boot do Azure Spring Apps.
Ukázkový projekt je aplikace řízená událostmi, která se přihlásí k odběru fronty služby Service Bus s názvem lower-case, a pak zpracuje zprávu a odešle další zprávu do jiné fronty s názvem upper-case. Aby byla aplikace jednoduchá, zpracování zpráv jednoduše převede zprávu na velká písmena. Následující diagram znázorňuje tento proces:
Tento článek obsahuje následující možnosti nasazení do Azure Spring Apps:
Možnost webu Azure Portal je nejjednodušší a nejrychlejší způsob, jak vytvářet prostředky a nasazovat aplikace jediným kliknutím. Tato možnost je vhodná pro vývojáře Springu, kteří chtějí rychle nasazovat aplikace do cloudových služeb Azure.
Možnost modulu plug-in Azure Portal + Maven je konvenční způsob, jak vytvářet prostředky a nasazovat aplikace krok za krokem. Tato možnost je vhodná pro vývojáře springu, kteří používají cloudové služby Azure poprvé.
Možnost Azure Developer CLI je efektivnější způsob, jak automaticky vytvářet prostředky a nasazovat aplikace prostřednictvím jednoduchých příkazů. Azure Developer CLI používá šablonu ke zřízení potřebných prostředků Azure a k nasazení kódu aplikace. Tato možnost je vhodná pro vývojáře Springu, kteří jsou obeznámeni s cloudovými službami Azure.
Možnost webu Azure Portal je nejjednodušším a nejrychlejším způsobem, jak vytvářet prostředky a nasazovat aplikace jediným kliknutím. Tato možnost je vhodná pro vývojáře Springu, kteří chtějí rychle nasazovat aplikace do cloudových služeb Azure.
Možnost modulu plug-in Azure Portal + Maven je konvenční způsob, jak vytvářet prostředky a nasazovat aplikace krok za krokem. Tato možnost je vhodná pro vývojáře springu, kteří používají cloudové služby Azure poprvé.
Možnost Azure CLI používá k správě prostředků Azure výkonný nástroj příkazového řádku. Tato možnost je vhodná pro vývojáře Springu, kteří jsou obeznámeni s cloudovými službami Azure.
Pokud nasazujete instanci plánu Azure Spring Apps Enterprise poprvé v cílovém předplatném, přečtěte si část Požadavky nabídky služby Azure Spring Apps Enterprise na Azure Marketplace.
Pokud nasazujete instanci plánu Azure Spring Apps Enterprise poprvé v cílovém předplatném, přečtěte si část Požadavky nabídky služby Azure Spring Apps Enterprise na Azure Marketplace.
Pokud nasazujete instanci plánu Azure Spring Apps Enterprise poprvé v cílovém předplatném, přečtěte si část Požadavky nabídky služby Azure Spring Apps Enterprise na Azure Marketplace.
Tlačítko Nasadit do Azure v další části spustí prostředí webu Azure Portal, které stáhne balíček JAR ze stránky vydaných verzí ASA-Samples-Web-Application na GitHubu. Nejsou potřeba žádné místní přípravné kroky.
Ukázku připravíte místně pomocí následujících kroků:
Ukázkový projekt je připravený na GitHubu. Naklonujte ukázkový projekt pomocí následujícího příkazu:
Zadejte nový název prostředí: Zadejte název prostředí, který se použije jako přípona pro skupinu prostředků, která je vytvořená pro uložení všech prostředků Azure. Tento název by měl být v rámci vašeho předplatného Azure jedinečný.
Konzola vypíše zprávy podobné následujícímu příkladu:
Initializing a new project (azd init)
(✓) Done: Initialized git repository
(✓) Done: Downloading template code to: <your-local-path>
Enter a new environment name: <your-env-name>
SUCCESS: New project initialized!
You can view the template code in your directory: <your-local-path>
Learn more about running 3rd party code on our DevHub: https://aka.ms/azd-third-party-code-notice
3. Příprava cloudového prostředí
Hlavní prostředky, které potřebujete ke spuštění této ukázky, jsou instance Azure Spring Apps, Azure Key Vault a instance služby Azure Service Bus. K vytvoření těchto prostředků použijte následující postup.
Přejděte na web Azure Portal a zadejte svoje přihlašovací údaje pro přihlášení k portálu. Výchozím zobrazením je váš řídicí panel služby.
3.2. Vytvoření zdrojů Azure
Pomocí následujících kroků vytvořte všechny prostředky Azure, na které aplikace závisí:
Výběrem následujícího tlačítka Nasadit do Azure spusťte prostředí nasazení na webu Azure Portal:
Vyplňte formulář na kartě Základy . Jako vodítko pro dokončení formuláře použijte následující tabulku:
Nastavení
Navrhovaná hodnota
Popis
Předplatné
Název vašeho předplatného
Předplatné Azure, které chcete použít pro váš server. Pokud máte více předplatných, zvolte předplatné, ve kterém chcete prostředek fakturovat.
Skupina prostředků
myresourcegroup
Název nové skupiny prostředků nebo některé ze stávajících ve vašem předplatném.
Oblast
Oblast, která je nejblíže vašim uživatelům.
Oblast slouží k vytvoření skupiny prostředků.
Výběrem možnosti Zkontrolovat a Vytvořit zkontrolujte vybrané možnosti. Pak vyberte Vytvořit a nasaďte aplikaci do Azure Spring Apps.
Pokud chcete monitorovat proces nasazení, na panelu nástrojů vyberte ikonu Oznámení (zvonek). Po dokončení nasazení můžete vybrat Připnout na řídicí panel, který vytvoří dlaždici pro tuto službu na řídicím panelu webu Azure Portal jako zástupce na stránce Přehled služby. Výběrem možnosti Přejít k prostředku otevřete stránku Přehled služby.
3.1. Přihlaste se k portálu Azure Portal.
Otevřete webový prohlížeč a přejděte na web Azure Portal. Zadejte přihlašovací údaje pro přihlášení k portálu. Výchozím zobrazením je váš řídicí panel služby.
3.2. Vytvoření instance služby Service Bus
Pomocí následujících kroků vytvořte instanci služby Service Bus:
V rohu webu Azure Portal vyberte Vytvořit prostředek .
Do vyhledávacího pole Search a marketplace vyhledejte service bus.
V části Service Bus vyberte Vytvořit.
Vyplňte formulář na kartě Základy . Jako vodítko pro dokončení formuláře použijte následující tabulku:
Nastavení
Navrhovaná hodnota
Popis
Předplatné
Název vašeho předplatného
Předplatné Azure, které chcete použít pro váš server. Pokud máte více předplatných, zvolte předplatné, ve kterém chcete prostředek fakturovat.
Skupina prostředků
myresourcegroup
Název nové skupiny prostředků nebo některé ze stávajících ve vašem předplatném.
Název oboru názvů
my-srvbus
Jedinečný název, který identifikuje vaši službu Service Bus.
Místo
Umístění nejblíže vašim uživatelům.
Umístění co nejblíže vašim uživatelům.
Možnosti a plány hostování
Basic
Cenový plán určuje prostředek a náklady spojené s vaší instancí.
Vyberte Zkontrolovat a vytvořit a zkontrolujte parametry vytvoření. Potom výběrem možnosti Vytvořit dokončete vytváření instance služby Service Bus.
Pokud chcete monitorovat proces nasazení, na panelu nástrojů vyberte ikonu Oznámení (zvonek). Po dokončení nasazení můžete vybrat Připnout na řídicí panel, který vytvoří dlaždici pro tuto službu na řídicím panelu webu Azure Portal jako zástupce na stránce Přehled služby. Výběrem možnosti Přejít k prostředku otevřete stránku Přehled služby.
Výběrem možnosti Přejít k prostředku přejděte na stránku Obor názvů služby Service Bus.
V navigační nabídce vyberte Zásady sdíleného přístupu a pak vyberte RootManageSharedAccessKey.
Na stránce Zásady SAS: RootManageSharedAccessKey zkopírujte a uložte hodnotu primárního připojovacího řetězce, která se používá k nastavení připojení z aplikace Spring.
V navigační nabídce vyberte Fronty a pak vyberte Fronta.
Na stránce Vytvořit frontu zadejte malé písmeno pro Název a pak vyberte Vytvořit.
Vytvořte další frontu opakováním předchozího kroku pomocí velkého písmena pro Název.
3.3. Vytvoření instance Azure Spring Apps
K vytvoření instance služby použijte následující postup:
V rohu portálu vyberte Vytvořit prostředek .
Vyberte Compute>Azure Spring Apps.
Vyplňte formulář Standard Consumption & Dedicated (Preview) s následujícími informacemi:
Nastavení
Navrhovaná hodnota
Popis
Předplatné
Název vašeho předplatného
Předplatné Azure, které chcete použít pro váš server. Pokud máte více předplatných, zvolte předplatné, ve kterém chcete prostředek fakturovat.
Skupina prostředků
myresourcegroup
Název nové skupiny prostředků nebo některé ze stávajících ve vašem předplatném.
Název
myasa
Jedinečný název, který identifikuje vaši službu Azure Spring Apps. Název musí mít délku 4 až 32 znaků a může obsahovat jenom malá písmena, číslice a pomlčky. První znak názvu služby musí být písmeno a poslední znak musí být písmeno nebo číslo.
Plán
Standardní spotřeba a vyhrazená verze (Preview)
Cenový plán určuje prostředky a náklady spojené s vaší instancí.
Oblast
Oblast nejbližší vašim uživatelům
Umístění co nejblíže vašim uživatelům.
Prostředí Container Apps
myacaenv
Prostředí je zabezpečená hranice kolem jedné nebo více aplikací kontejnerů, které spolu můžou komunikovat a sdílet virtuální síť, protokolování a konfiguraci Dapr.
(Volitelné) Pomocí následujících kroků vytvořte prostředí Container Apps:
Vyberte Vytvořit a vytvořte prostředí Container Apps.
Na kartě Základy vyplňte následující informace:
Název prostředí: myacaenv
Plán: (Preview) Profily využití a vyhrazené úlohy
Redundance zóny: Zakázáno
Vyberte kartu Profily úloh (Preview) a pak vyberte Přidat profil úlohy a přidejte profil úlohy.
Na stránce Přidat profil úlohy (Preview) přidejte následující informace:
Název profilu úlohy: my-wlp
Velikost profilu úlohy: Vyberte Dedicated-D4
Rozsah počtu instancí automatického škálování: Vyberte 3 a 5
Vyberte Přidat. Tento výběr vás vrátí zpět na stránku Přidat profil úlohy (Preview). Vyberte my-wlp a pak vyberte Vytvořit a vytvořte prostředí Container Apps.
Výběrem možnosti Zkontrolovat a Vytvořit zkontrolujte vybrané možnosti. Výběrem možnosti Vytvořit zřídíte instanci Azure Spring Apps.
Pokud chcete monitorovat proces nasazení, na panelu nástrojů vyberte ikonu Oznámení (zvonek). Po dokončení nasazení můžete vybrat možnost Připnout na řídicí panel, který vytvoří dlaždici pro tuto službu na řídicím panelu webu Azure Portal jako zástupce na stránce Přehled služby. Výběrem možnosti Přejít k prostředku se otevře stránka Přehled služby.
Výběrem možnosti Přejít k prostředku přejděte na stránku Přehled služby Azure Spring Apps.
V levé navigační nabídce vyberte Aplikace a pak vyberte Vytvořit aplikaci.
Na stránce Vytvořit aplikaci zadejte simple-event-driven-app název aplikace a pak vyberte Použít ukázkovou aplikaci Rychlý start k vytvoření aplikace.
Výběrem možnosti Vytvořit dokončete vytváření instance Azure Spring Apps.
Po vytvoření aplikace vyberte název aplikace, který jste vytvořili v předchozím kroku.
V navigačním podokně vyberte Možnost Konfigurace a na kartě Proměnné prostředí nakonfigurujte následující vlastnost.
SERVICE_BUS_CONNECTION_STRING: Zadejte primární připojovací řetězec služby Service Bus.
Vyberte Uložit a uložte vlastnosti připojení.
Pomocí následujícího příkazu se přihlaste k Azure pomocí OAuth2. Tento krok ignorujte, pokud jste se už přihlásili.
azd auth login
Konzola vypíše zprávy podobné následujícímu příkladu:
Logged in to Azure.
Pomocí následujícího příkazu zřiďte infrastrukturu šablony do Azure:
azd provision
Následující seznam popisuje interakce příkazů:
Vyberte předplatné Azure, které chcete použít: K přesunutí použijte šipky, zadejte filtr a stiskněte Enter.
Vyberte umístění Azure, které chcete použít: K přesunutí použijte šipky, zadejte filtr a stiskněte Enter.
Konzola vypíše zprávy podobné následujícímu příkladu:
SUCCESS: Your application was provisioned in Azure in xx minutes xx seconds.
You can view the resources created under the resource group rg-<your-environment-name>-<random-string>> in Azure Portal:
https://portal.azure.com/#@/resource/subscriptions/<your-subscription-id>/resourceGroups/rg-<your-environment-name>/overview
Poznámka:
Dokončení tohoto příkazu může chvíli trvat. Při zřídíte prostředky Azure a zobrazí se indikátor průběhu.
Přihlášení OAuth2: Musíte autorizovat přihlášení k Azure na základě protokolu OAuth2.
Vyberte předplatné: Vyberte číslo seznamu předplatných instance Azure Spring Apps, kterou jste vytvořili. Výchozí hodnota je první předplatné v seznamu. Pokud použijete výchozí číslo, stiskněte klávesu Enter přímo.
Použití existujících aplikací Azure Spring Apps v Azure: Stisknutím klávesy y použijte existující instanci Azure Spring Apps.
Vyberte Azure Spring Apps pro nasazení: Vyberte číslo seznamu instance Azure Spring Apps, kterou jste vytvořili. Pokud použijete výchozí číslo, stiskněte klávesu Enter přímo.
Použijte existující aplikaci ve službě Azure Spring Apps <s názvem> vaší instance: Stisknutím klávesy y použijte vytvořenou aplikaci.
Potvrďte uložení všech výše uvedených konfigurací: Stiskněte y. Pokud stisknete klávesu n, konfigurace se neuloží do souborů POM.
K nasazení aplikace použijte následující příkaz:
./mvnw azure-spring-apps:deploy
Následující seznam popisuje interakci s příkazy:
Přihlášení OAuth2: Musíte autorizovat přihlášení k Azure na základě protokolu OAuth2.
Po spuštění příkazu se zobrazí následující zprávy protokolu, které nasazení proběhlo úspěšně:
[INFO] Deployment(default) is successfully created
[INFO] Starting Spring App after deploying artifacts...
[INFO] Deployment Status: Running
Pomocí následujících kroků zabalíte aplikaci AZD, zřídíte prostředky Azure vyžadované webovou aplikací a pak nasadíte do Azure Spring Apps.
Pomocí následujícího příkazu zabalte nasaditelnou kopii aplikace:
azd package
Konzola vypíše zprávy podobné následujícímu příkladu:
SUCCESS: Your application was packaged for Azure in xx seconds.
Pomocí následujícího příkazu nasaďte kód aplikace do nově zřízených prostředků:
azd deploy
Konzola vypíše zprávy podobné následujícímu příkladu:
Deploying services (azd deploy)
(✓) Done: Deploying service simple-event-driven-app
- No endpoints were found
SUCCESS: Your application was deployed to Azure in xx minutes xx seconds.
You can view the resources created under the resource group rg-<your-environment-name> in Azure Portal:
https://portal.azure.com/#@/resource/subscriptions/<your-subscription-id>/resourceGroups/rg-<your-environment-name>/overview
Poznámka:
Můžete také použít azd up ke kombinování předchozích tří příkazů: azd provision (zřídí prostředky Azure), azd package (zabalí nasaditelnou kopii aplikace) a azd deploy (nasadí kód aplikace). Další informace najdete v tématu Azure-Samples/ASA-Samples-Event-Driven-Application.
Tlačítko Nasadit do Azure v další části spustí prostředí webu Azure Portal, které stáhne balíček JAR ze stránky vydaných verzí ASA-Samples-Web-Application na GitHubu. Nejsou potřeba žádné místní přípravné kroky.
Ukázku připravíte místně pomocí následujících kroků:
Ukázkový projekt je připravený na GitHubu. Naklonujte ukázkový projekt pomocí následujícího příkazu:
Zadejte nový název prostředí: Zadejte název prostředí, který se použije jako přípona pro skupinu prostředků, která je vytvořená pro uložení všech prostředků Azure. Tento název by měl být v rámci vašeho předplatného Azure jedinečný.
Konzola vypíše zprávy podobné následujícímu příkladu:
Initializing a new project (azd init)
(✓) Done: Initialized git repository
(✓) Done: Downloading template code to: <your-local-path>
Enter a new environment name: <your-env-name>
SUCCESS: New project initialized!
You can view the template code in your directory: <your-local-path>
Learn more about running 3rd party code on our DevHub: https://aka.ms/azd-third-party-code-notice
3. Příprava cloudového prostředí
Hlavní prostředky, které potřebujete ke spuštění této ukázky, jsou instance Azure Spring Apps, instance služby Azure Key Vault a instance služby Azure Service Bus. K vytvoření těchto prostředků použijte následující postup.
Přejděte na web Azure Portal a zadejte svoje přihlašovací údaje pro přihlášení k portálu. Výchozím zobrazením je váš řídicí panel služby.
3.2. Vytvoření zdrojů Azure
Pomocí následujících kroků vytvořte všechny prostředky Azure, na které aplikace závisí:
Výběrem následujícího tlačítka Nasadit do Azure spusťte prostředí nasazení na webu Azure Portal:
Vyplňte formulář na kartě Základy . Jako vodítko pro dokončení formuláře použijte následující tabulku:
Nastavení
Navrhovaná hodnota
Popis
Předplatné
Název vašeho předplatného
Předplatné Azure, které chcete použít pro váš server. Pokud máte více předplatných, zvolte předplatné, ve kterém chcete prostředek fakturovat.
Skupina prostředků
myresourcegroup
Název nové skupiny prostředků nebo některé ze stávajících ve vašem předplatném.
Oblast
Oblast, která je nejblíže vašim uživatelům.
Oblast slouží k vytvoření skupiny prostředků.
Výběrem možnosti Zkontrolovat a Vytvořit zkontrolujte vybrané možnosti. Pak vyberte Vytvořit a nasaďte aplikaci do Azure Spring Apps.
Pokud chcete monitorovat proces nasazení, na panelu nástrojů vyberte ikonu Oznámení (zvonek). Po dokončení nasazení můžete vybrat Připnout na řídicí panel, který vytvoří dlaždici pro tuto službu na řídicím panelu webu Azure Portal jako zástupce na stránce Přehled služby. Výběrem možnosti Přejít k prostředku otevřete stránku Přehled služby.
3.1. Přihlaste se k portálu Azure Portal.
Otevřete webový prohlížeč a přejděte na web Azure Portal. Zadejte přihlašovací údaje pro přihlášení k portálu. Výchozím zobrazením je váš řídicí panel služby.
3.2. Vytvoření instance služby Service Bus
Pomocí následujících kroků vytvořte instanci služby Service Bus:
V rohu webu Azure Portal vyberte Vytvořit prostředek .
Do vyhledávacího pole Search a marketplace vyhledejte service bus.
V části Service Bus vyberte Vytvořit.
Vyplňte formulář na kartě Základy . Jako vodítko pro dokončení formuláře použijte následující tabulku:
Nastavení
Navrhovaná hodnota
Popis
Předplatné
Název vašeho předplatného
Předplatné Azure, které chcete použít pro váš server. Pokud máte více předplatných, zvolte předplatné, ve kterém chcete prostředek fakturovat.
Skupina prostředků
myresourcegroup
Název nové skupiny prostředků nebo některé ze stávajících ve vašem předplatném.
Název oboru názvů
my-srvbus
Jedinečný název, který identifikuje vaši službu Service Bus.
Místo
Umístění nejblíže vašim uživatelům.
Umístění co nejblíže vašim uživatelům.
Možnosti a plány hostování
Basic
Cenový plán určuje prostředek a náklady spojené s vaší instancí.
Vyberte Zkontrolovat a vytvořit a zkontrolujte parametry vytvoření. Potom výběrem možnosti Vytvořit dokončete vytváření instance služby Service Bus.
Pokud chcete monitorovat proces nasazení, na panelu nástrojů vyberte ikonu Oznámení (zvonek). Po dokončení nasazení můžete vybrat Připnout na řídicí panel, který vytvoří dlaždici pro tuto službu na řídicím panelu webu Azure Portal jako zástupce na stránce Přehled služby. Výběrem možnosti Přejít k prostředku otevřete stránku Přehled služby.
Výběrem možnosti Přejít k prostředku přejděte na stránku Obor názvů služby Service Bus.
V navigační nabídce vyberte Zásady sdíleného přístupu a pak vyberte RootManageSharedAccessKey.
Na stránce Zásady SAS: RootManageSharedAccessKey zkopírujte a uložte hodnotu primárního připojovacího řetězce, která se používá k nastavení připojení z aplikace Spring.
V navigační nabídce vyberte Fronty a pak vyberte Fronta.
Na stránce Vytvořit frontu zadejte malé písmeno pro Název a pak vyberte Vytvořit.
Vytvořte další frontu opakováním předchozího kroku pomocí velkého písmena pro Název.
3.3. Vytvoření instance Azure Spring Apps
Pomocí následujících kroků vytvořte instanci Azure Spring Apps:
V rohu webu Azure Portal vyberte Vytvořit prostředek .
Vyberte Compute>Azure Spring Apps.
Vyplňte formulář Základy s následujícími informacemi:
Jako vodítko pro dokončení formuláře použijte následující tabulku. Doporučený plán je Standard.
Nastavení
Navrhovaná hodnota
Popis
Předplatné
Název vašeho předplatného
Předplatné Azure, které chcete použít pro váš server. Pokud máte více předplatných, zvolte předplatné, ve kterém chcete prostředek fakturovat.
Skupina prostředků
myresourcegroup
Název nové skupiny prostředků nebo některé ze stávajících ve vašem předplatném.
Název
myasa
Jedinečný název, který identifikuje vaši službu Azure Spring Apps. Název musí mít délku 4 až 32 znaků a může obsahovat jenom malá písmena, číslice a pomlčky. První znak názvu služby musí být písmeno a poslední znak musí být písmeno nebo číslo.
Plán
Standard
Plán určuje prostředek a náklady spojené s vaší instancí.
Oblast
Oblast nejbližší vašim uživatelům
Umístění co nejblíže vašim uživatelům.
Zónově redundantní
Nevybráno
Jestli chcete vytvořit službu Azure Spring Apps v zóně dostupnosti Azure, může se v tuto chvíli podporovat jenom v několika oblastech.
Výběrem možnosti Zkontrolovat a Vytvořit zkontrolujte vybrané možnosti. Výběrem možnosti Vytvořit zřídíte instanci Azure Spring Apps.
Pokud chcete monitorovat proces nasazení, na panelu nástrojů vyberte ikonu Oznámení (zvonek). Po dokončení nasazení můžete vybrat možnost Připnout na řídicí panel, který vytvoří dlaždici pro tuto službu na řídicím panelu webu Azure Portal jako zástupce na stránce Přehled služby. Výběrem možnosti Přejít k prostředku se otevře stránka Přehled služby.
3.4. Připojení instance aplikace k instanci služby Service Bus
Na webu Azure Portal přejděte ke své instanci Azure Spring Apps.
V navigační nabídce vyberte Aplikace a pak vyberte Vytvořit aplikaci.
Na stránce Vytvořit aplikaci zadejte pro název aplikace jednoduchou aplikaci řízenou událostmi a vyberte Javu 17 pro platformu Runtime.
Po vytvoření aplikace vyberte název aplikace, který jste vytvořili v předchozím kroku.
Na stránce Konfigurace vyberte kartu Proměnné prostředí, zadejte SERVICE_BUS_CONNECTION_STRING pro klíč, vložte připojovací řetězec Service Bus pro hodnotu a pak vyberte Uložit.
Pomocí následujícího příkazu se přihlaste k Azure pomocí OAuth2. Tento krok ignorujte, pokud jste se už přihlásili.
azd auth login
Konzola vypíše zprávy podobné následujícímu příkladu:
Logged in to Azure.
K nastavení šablony pomocí standardního plánu použijte následující příkaz:
azd env set PLAN standard
Pomocí následujícího příkazu zabalte nasaditelnou kopii aplikace, zřiďte infrastrukturu šablony do Azure a nasaďte kód aplikace do nově zřízených prostředků:
azd provision
Následující seznam popisuje interakce příkazů:
Vyberte předplatné Azure, které chcete použít: K přesunutí použijte šipky, zadejte filtr a stiskněte Enter.
Vyberte umístění Azure, které chcete použít: Pomocí šipek se můžete přesunout, zadat filtr a stisknout Enter.
Konzola vypíše zprávy podobné následujícímu příkladu:
SUCCESS: Your application was provisioned in Azure in xx minutes xx seconds.
You can view the resources created under the resource group rg-<your-environment-name> in Azure Portal:
https://portal.azure.com/#@/resource/subscriptions/<your-subscription-id>/resourceGroups/rg-<your-environment-name>/overview
Poznámka:
Dokončení tohoto příkazu může chvíli trvat. Zobrazuje se indikátor průběhu při zřídí prostředky Azure.
Přihlášení OAuth2: Musíte autorizovat přihlášení k Azure na základě protokolu OAuth2.
Vyberte předplatné: Vyberte číslo seznamu předplatných instance Azure Spring Apps, kterou jste vytvořili. Výchozí hodnota je první předplatné v seznamu. Pokud použijete výchozí číslo, stiskněte klávesu Enter přímo.
Použití existujících aplikací Azure Spring Apps v Azure: Stisknutím klávesy y použijte existující instanci Azure Spring Apps.
Vyberte Azure Spring Apps pro nasazení: Vyberte číslo seznamu instance Azure Spring Apps, kterou jste vytvořili. Pokud použijete výchozí číslo, stiskněte klávesu Enter přímo.
Použijte existující aplikaci ve službě Azure Spring Apps <s názvem> vaší instance: Stisknutím klávesy y použijte vytvořenou aplikaci.
Potvrďte uložení všech výše uvedených konfigurací: Stiskněte y. Pokud stisknete klávesu n, konfigurace se neuloží do souborů POM.
K nasazení aplikace použijte následující příkaz:
./mvnw azure-spring-apps:deploy
Následující seznam popisuje interakci s příkazy:
Přihlášení OAuth2: Musíte autorizovat přihlášení k Azure na základě protokolu OAuth2.
Po spuštění příkazu se zobrazí následující zprávy protokolu, které nasazení proběhlo úspěšně:
[INFO] Deployment(default) is successfully created
[INFO] Starting Spring App after deploying artifacts...
[INFO] Deployment Status: Running
Pomocí následujících kroků zabalíte aplikaci AZD, zřídíte prostředky Azure vyžadované webovou aplikací a pak nasadíte do Azure Spring Apps.
Pomocí následujícího příkazu zabalte nasaditelnou kopii aplikace:
azd package
Konzola vypíše zprávy podobné následujícímu příkladu:
SUCCESS: Your application was packaged for Azure in xx seconds.
Pomocí následujícího příkazu nasaďte kód aplikace do nově zřízených prostředků:
azd deploy
Konzola vypíše zprávy podobné následujícímu příkladu:
Deploying services (azd deploy)
(✓) Done: Deploying service simple-event-driven-app
- No endpoints were found
SUCCESS: Your application was deployed to Azure in xx minutes xx seconds.
You can view the resources created under the resource group rg-<your-environment-name> in Azure Portal:
https://portal.azure.com/#@/resource/subscriptions/<your-subscription-id>/resourceGroups/rg-<your-environment-name>/overview
Poznámka:
Můžete také použít azd up ke kombinování předchozích tří příkazů: azd provision (zřídí prostředky Azure), azd package (zabalí nasaditelnou kopii aplikace) a azd deploy (nasadí kód aplikace). Další informace najdete v tématu Azure-Samples/ASA-Samples-Event-Driven-Application.
Tlačítko Nasadit do Azure v další části spustí prostředí webu Azure Portal, které stáhne balíček JAR ze stránky vydaných verzí ASA-Samples-Web-Application na GitHubu. Nejsou potřeba žádné místní přípravné kroky.
Ukázku připravíte místně pomocí následujících kroků:
Ukázkový projekt je připravený na GitHubu. Naklonujte ukázkový projekt pomocí následujícího příkazu:
Pomocí následujících příkazů sestavte ukázkový projekt:
cd ASA-Samples-Event-Driven-Application
./mvnw clean package
3. Příprava cloudového prostředí
Hlavní prostředky, které potřebujete ke spuštění této ukázky, jsou instance Azure Spring Apps a instance služby Azure Service Bus. Následující části popisují, jak tyto prostředky vytvořit.
Přejděte na web Azure Portal a zadejte svoje přihlašovací údaje pro přihlášení k portálu. Výchozím zobrazením je váš řídicí panel služby.
3.2. Vytvoření zdrojů Azure
Pomocí následujících kroků vytvořte všechny prostředky Azure, na které aplikace závisí:
Výběrem následujícího tlačítka Nasadit do Azure spusťte prostředí nasazení na webu Azure Portal:
Vyplňte formulář na kartě Základy . Jako vodítko pro dokončení formuláře použijte následující tabulku:
Nastavení
Navrhovaná hodnota
Popis
Předplatné
Název vašeho předplatného
Předplatné Azure, které chcete použít pro váš server. Pokud máte více předplatných, zvolte předplatné, ve kterém chcete prostředek fakturovat.
Skupina prostředků
myresourcegroup
Název nové skupiny prostředků nebo některé ze stávajících ve vašem předplatném.
Oblast
Oblast, která je nejblíže vašim uživatelům.
Oblast slouží k vytvoření skupiny prostředků.
Výběrem možnosti Zkontrolovat a Vytvořit zkontrolujte vybrané možnosti. Pak vyberte Vytvořit a nasaďte aplikaci do Azure Spring Apps.
Pokud chcete monitorovat proces nasazení, na panelu nástrojů vyberte ikonu Oznámení (zvonek). Po dokončení nasazení můžete vybrat Připnout na řídicí panel, který vytvoří dlaždici pro tuto službu na řídicím panelu webu Azure Portal jako zástupce na stránce Přehled služby. Výběrem možnosti Přejít k prostředku otevřete stránku Přehled služby.
3.1. Přihlaste se k portálu Azure Portal.
Přejděte na web Azure Portal a zadejte svoje přihlašovací údaje pro přihlášení k portálu. Výchozím zobrazením je váš řídicí panel služby.
3.2. Vytvoření instance služby Service Bus
Pomocí následujících kroků vytvořte instanci služby Service Bus:
V rohu webu Azure Portal vyberte Vytvořit prostředek .
Do vyhledávacího pole Search a marketplace vyhledejte service bus.
V části Service Bus vyberte Vytvořit.
Vyplňte formulář na kartě Základy . Jako vodítko pro dokončení formuláře použijte následující tabulku:
Nastavení
Navrhovaná hodnota
Popis
Předplatné
Název vašeho předplatného
Předplatné Azure, které chcete použít pro váš server. Pokud máte více předplatných, zvolte předplatné, ve kterém chcete prostředek fakturovat.
Skupina prostředků
myresourcegroup
Název nové skupiny prostředků nebo některé ze stávajících ve vašem předplatném.
Název oboru názvů
my-srvbus
Jedinečný název, který identifikuje vaši službu Service Bus.
Místo
Umístění nejblíže vašim uživatelům.
Umístění co nejblíže vašim uživatelům.
Možnosti a plány hostování
Basic
Cenový plán určuje prostředek a náklady spojené s vaší instancí.
Vyberte Zkontrolovat a vytvořit a zkontrolujte parametry vytvoření. Potom výběrem možnosti Vytvořit dokončete vytváření instance služby Service Bus.
Pokud chcete monitorovat proces nasazení, na panelu nástrojů vyberte ikonu Oznámení (zvonek). Po dokončení nasazení můžete vybrat Připnout na řídicí panel, který vytvoří dlaždici pro tuto službu na řídicím panelu webu Azure Portal jako zástupce na stránce Přehled služby. Výběrem možnosti Přejít k prostředku otevřete stránku Přehled služby.
Výběrem možnosti Přejít k prostředku přejděte na stránku Obor názvů služby Service Bus.
V navigační nabídce vyberte Fronty a pak vyberte Fronta.
Na stránce Vytvořit frontu zadejte malé písmeno pro Název a pak vyberte Vytvořit.
Vytvořte další frontu opakováním předchozího kroku pomocí velkého písmena pro Název.
3.3. Vytvoření instance Azure Spring Apps
K vytvoření instance služby použijte následující postup:
V rohu webu Azure Portal vyberte Vytvořit prostředek .
Vyberte Compute>Azure Spring Apps.
Vyplňte formulář Základy s následujícími informacemi:
Nastavení
Navrhovaná hodnota
Popis
Předplatné
Název vašeho předplatného
Předplatné Azure, které chcete použít pro váš server. Pokud máte více předplatných, zvolte předplatné, ve kterém chcete prostředek fakturovat.
Skupina prostředků
myresourcegroup
Název nové skupiny prostředků nebo některé ze stávajících ve vašem předplatném.
Název
myasa
Jedinečný název, který identifikuje vaši službu Azure Spring Apps. Název musí mít délku 4 až 32 znaků a může obsahovat jenom malá písmena, číslice a pomlčky. První znak názvu služby musí být písmeno a poslední znak musí být písmeno nebo číslo.
Oblast
Oblast, která je nejblíže vašim uživatelům.
Umístění co nejblíže vašim uživatelům.
Možnosti a plány hostování
Enterprise
Cenový plán, který určuje prostředek a náklady spojené s vaší instancí.
Zónově redundantní
Nevybráno
Možnost vytvoření služby Azure Spring Apps v zóně dostupnosti Azure Tato funkce se v současné době nepodporuje ve všech oblastech.
Plán softwarových IP adres
Průběžné platby
Cenový plán, který vám umožní platit při přechodu pomocí Azure Spring Apps.
Nasazení ukázkového projektu
Nevybráno
Možnost použít předdefinované ukázkové aplikace.
Výběrem možnosti Zkontrolovat a Vytvořit zkontrolujte vybrané možnosti. Pak vyberte Vytvořit a zřiďte instanci Azure Spring Apps.
Pokud chcete monitorovat proces nasazení, na panelu nástrojů vyberte ikonu Oznámení (zvonek). Po dokončení nasazení můžete vybrat Připnout na řídicí panel, který vytvoří dlaždici pro tuto službu na řídicím panelu webu Azure Portal jako zástupce na stránce Přehled služby.
Výběrem možnosti Přejít k prostředku přejděte na stránku Přehled služby Azure Spring Apps.
3.4. Připojení instance aplikace k instanci služby Service Bus
K připojení instancí služby použijte následující postup:
Na webu Azure Portal přejděte ke své instanci Azure Spring Apps.
V navigačním podokně otevřete podokno Aplikace a pak vyberte Vytvořit aplikaci.
Na stránce Vytvořit aplikaci jako název aplikace použijte jednoduchou aplikaci řízenou událostmi a nechte všechna ostatní pole s výchozími hodnotami.
Výběrem možnosti Vytvořit dokončíte vytváření aplikace a pak ji vyberete, aby se zobrazily podrobnosti.
V navigačním podokně vyberte Konektor služby a pak vyberte Vytvořit a vytvořte nové připojení služby.
Na kartě Základy vyplňte následující informace:
Typ služby: Vyberte Service Bus.
Název připojení: Naplněný automaticky vygenerovaným názvem, který můžete upravit.
Předplatné: Vyberte předplatné.
Obor názvů: Vyberte obor názvů, který jste vytvořili.
Typ klienta: Vyberte SpringBoot.
Nakonfigurujte kartu Další: Ověřování s následujícími informacemi:
Poznámka:
Microsoft doporučuje používat nejbezpečnější dostupný tok ověřování. Tok ověřování popsaný v tomto postupu, například pro databáze, mezipaměti, zasílání zpráv nebo služby AI, vyžaduje velmi vysoký stupeň důvěryhodnosti v aplikaci a nese rizika, která nejsou přítomna v jiných tocích. Tento tok používejte pouze v případě, že nejsou možné zabezpečit možnosti, jako jsou spravované identity pro připojení bez hesla nebo bez klíčů. V případě místních operací počítačů upřednostňujete identity uživatelů pro připojení bez hesla nebo bez klíčů.
Vyberte typ ověřování, který chcete použít mezi výpočetní službou a cílovou službou.: Vyberte Připojovací řetězec.
Vyberte Další: Sítě. Pomocí výchozí možnosti Konfigurovat pravidla brány firewall povolte přístup k cílové službě.
Vyberte Další: Zkontrolujte a Vytvořte , abyste zkontrolovali výběry, a pak výběrem možnosti Vytvořit vytvořte připojení.
3.1. Zadejte názvy jednotlivých prostředků.
Pomocí následujících příkazů vytvořte proměnné, které budou obsahovat názvy prostředků. Zástupné symboly nezapomeňte nahradit vlastními hodnotami.
Pomocí následujících kroků vytvořte novou skupinu prostředků:
Pomocí následujícího příkazu se přihlaste k Azure CLI:
az login
K nastavení výchozího umístění použijte následující příkaz:
az configure --defaults location=${LOCATION}
Pomocí následujícího příkazu vypíšete všechna dostupná předplatná a určíte ID předplatného, které se má použít:
az account list --output table
K nastavení výchozího předplatného použijte následující příkaz:
az account set --subscription <subscription-ID>
Pomocí následujícího příkazu vytvořte skupinu prostředků:
az group create --resource-group ${RESOURCE_GROUP}
Pomocí následujícího příkazu nastavte nově vytvořenou skupinu prostředků jako výchozí skupinu prostředků:
az configure --defaults group=${RESOURCE_GROUP}
3.3. Instalace rozšíření a registrace oboru názvů
Pomocí následujících příkazů nainstalujte rozšíření Azure Spring Apps pro Azure CLI a zaregistrujte Microsoft.SaaS obor názvů:
az extension add --name spring --upgrade
az provider register --namespace Microsoft.SaaS
3.4. Vytvoření instance Azure Spring Apps
K vytvoření instance Azure Spring Apps použijte následující příkaz:
az spring create \
--name ${AZURE_SPRING_APPS_INSTANCE} \
--sku Enterprise
Pak pomocí následujícího příkazu vytvořte aplikaci v instanci Azure Spring Apps:
az spring app create \
--service ${AZURE_SPRING_APPS_INSTANCE} \
--name ${APP_NAME}
3.5. Vytvoření instance služby Service Bus
Pomocí následujících kroků vytvořte instanci služby Service Bus:
Pomocí následujícího příkazu vytvořte obor názvů služby Service Bus:
az servicebus namespace create --name ${SERVICE_BUS_NAME_SPACE}
Pomocí následujících příkazů vytvořte dvě pojmenované fronty lower-case a upper-case:
az servicebus queue create \
--namespace-name ${SERVICE_BUS_NAME_SPACE} \
--name lower-case
az servicebus queue create \
--namespace-name ${SERVICE_BUS_NAME_SPACE} \
--name upper-case
3.6. Připojení instance aplikace k instanci služby Service Bus
Právě jste vytvořili Service Bus i aplikaci v Azure Spring Apps, ale aplikace se nemůže připojit ke službě Service Bus. Pomocí následujících kroků povolte aplikaci, aby se připojila ke službě Service Bus, a pak aplikaci nasaďte:
Pomocí následujícího příkazu získejte připojovací řetězec služby Service Bus:
Poznámka:
Microsoft doporučuje používat nejbezpečnější dostupný tok ověřování. Tok ověřování popsaný v tomto postupu, například pro databáze, mezipaměti, zasílání zpráv nebo služby AI, vyžaduje velmi vysoký stupeň důvěryhodnosti v aplikaci a nese rizika, která nejsou přítomna v jiných tocích. Tento tok používejte pouze v případě, že nejsou možné zabezpečit možnosti, jako jsou spravované identity pro připojení bez hesla nebo bez klíčů. V případě místních operací počítačů upřednostňujete identity uživatelů pro připojení bez hesla nebo bez klíčů.
Přihlášení OAuth2: Musíte autorizovat přihlášení k Azure na základě protokolu OAuth2.
Vyberte předplatné: Vyberte číslo seznamu předplatných instance Azure Spring Apps, kterou jste vytvořili. Výchozí hodnota je první předplatné v seznamu. Pokud použijete výchozí číslo, stiskněte klávesu Enter přímo.
Použití existujících aplikací Azure Spring Apps v Azure: Stisknutím klávesy y použijte existující instanci Azure Spring Apps.
Vyberte Azure Spring Apps pro nasazení: Vyberte číslo seznamu instance Azure Spring Apps, kterou jste vytvořili. Pokud použijete výchozí číslo, stiskněte klávesu Enter přímo.
Použijte existující aplikaci ve službě Azure Spring Apps <s názvem> vaší instance: Stisknutím klávesy y použijte vytvořenou aplikaci.
Potvrďte uložení všech výše uvedených konfigurací: Stiskněte y. Pokud stisknete klávesu n, konfigurace se neuloží do souborů POM.
K nasazení aplikace použijte následující příkaz:
./mvnw azure-spring-apps:deploy
Následující seznam popisuje interakci s příkazy:
Přihlášení OAuth2: Musíte autorizovat přihlášení k Azure na základě protokolu OAuth2.
Po spuštění příkazu se zobrazí následující zprávy protokolu, které nasazení proběhlo úspěšně:
[INFO] Starting Spring App after deploying artifacts...
[INFO] Deployment Status: Running
Cloudové prostředí je teď připravené. Aplikaci nasaďte pomocí následujícího příkazu:
az spring app deploy \
--service ${AZURE_SPRING_APPS_INSTANCE} \
--name ${APP_NAME} \
--artifact-path target/simple-event-driven-app-0.0.2-SNAPSHOT.jar
5. Ověření aplikace
Pomocí následujícího postupu ověřte, že aplikace řízená událostmi funguje správně. Aplikaci můžete ověřit odesláním zprávy do lower-case fronty a potvrzením, že ve frontě upper-case je zpráva.
Odešle zprávu do fronty lower-case pomocí Service Bus Exploreru. Další informace najdete v části Odeslání zprávy do fronty nebo tématu použití Service Bus Exploreru ke spouštění datových operací ve službě Service Bus.
Potvrďte, že se do fronty odeslala upper-case nová zpráva. Další informace najdete v části Náhled zprávy použití Service Bus Exploreru ke spouštění datových operací ve službě Service Bus.
Přejděte na stránku Přehled instance Azure Spring Apps a výběrem možnosti Protokoly zkontrolujte protokoly aplikace.
Odešle zprávu do fronty lower-case pomocí Service Bus Exploreru. Další informace najdete v části Odeslání zprávy do fronty nebo tématu použití Service Bus Exploreru ke spouštění datových operací ve službě Service Bus.
Potvrďte, že se do fronty odeslala upper-case nová zpráva. Další informace najdete v části Náhled zprávy použití Service Bus Exploreru ke spouštění datových operací ve službě Service Bus.
Přejděte na stránku Přehled instance Azure Spring Apps a výběrem možnosti Protokoly zkontrolujte protokoly aplikace.
Projděte si podrobnosti o každém nasazení prostředků, které jsou užitečné pro zkoumání problémů s nasazením.
Odešle zprávu do fronty lower-case pomocí Service Bus Exploreru. Další informace najdete v části Odeslání zprávy do fronty nebo tématu použití Service Bus Exploreru ke spouštění datových operací ve službě Service Bus.
Potvrďte, že se do fronty odeslala upper-case nová zpráva. Další informace najdete v části Náhled zprávy použití Service Bus Exploreru ke spouštění datových operací ve službě Service Bus.
Přejděte na stránku Přehled instance Azure Spring Apps a výběrem možnosti Protokoly zkontrolujte protokoly aplikace.
Projděte si podrobnosti o každém nasazení prostředků, které jsou užitečné pro zkoumání problémů s nasazením.
Odešle zprávu do fronty lower-case pomocí Service Bus Exploreru. Další informace najdete v části Odeslání zprávy do fronty nebo tématu použití Service Bus Exploreru ke spouštění datových operací ve službě Service Bus.
Potvrďte, že se do fronty odeslala upper-case nová zpráva. Další informace najdete v části Náhled zprávy použití Service Bus Exploreru ke spouštění datových operací ve službě Service Bus.
Přejděte na stránku Přehled instance Azure Spring Apps a výběrem možnosti Protokoly zkontrolujte protokoly aplikace.
Pomocí následujícího příkazu zkontrolujte protokol aplikace a prozkoumejte případné problémy s nasazením:
az spring app logs \
--service ${AZURE_SPRING_APPS_INSTANCE} \
--name ${APP_NAME}
6. Vyčištění prostředků
Pokud už je nepotřebujete, nezapomeňte odstranit prostředky, které jste vytvořili v tomto článku. Můžete odstranit skupinu prostředků Azure, což zahrnuje odstranění všech prostředků v této skupině prostředků.
Pomocí následujících kroků odstraňte celou skupinu prostředků, včetně nově vytvořené služby:
Vyhledejte skupinu prostředků na webu Azure Portal. V navigační nabídce vyberte Skupiny prostředků a pak vyberte název vaší skupiny prostředků.
Na stránce Skupina prostředků vyberte Odstranit. Do textového pole zadejte název skupiny prostředků, abyste potvrdili odstranění, a pak vyberte Odstranit.
Pomocí následujících kroků odstraňte celou skupinu prostředků, včetně nově vytvořené služby:
Vyhledejte skupinu prostředků na webu Azure Portal. V navigační nabídce vyberte Skupiny prostředků a pak vyberte název vaší skupiny prostředků.
Na stránce Skupina prostředků vyberte Odstranit. Do textového pole zadejte název skupiny prostředků, abyste potvrdili odstranění, a pak vyberte Odstranit.
Pomocí následujícího příkazu odstraňte celou skupinu prostředků, včetně nově vytvořené služby:
Pomocí následujících kroků odstraňte celou skupinu prostředků, včetně nově vytvořené služby:
Vyhledejte skupinu prostředků na webu Azure Portal. V navigační nabídce vyberte Skupiny prostředků a pak vyberte název vaší skupiny prostředků.
Na stránce Skupina prostředků vyberte Odstranit. Do textového pole zadejte název skupiny prostředků, abyste potvrdili odstranění, a pak vyberte Odstranit.
Pomocí následujících kroků odstraňte celou skupinu prostředků, včetně nově vytvořené služby:
Vyhledejte skupinu prostředků na webu Azure Portal. V navigační nabídce vyberte Skupiny prostředků a pak vyberte název vaší skupiny prostředků.
Na stránce Skupina prostředků vyberte Odstranit. Do textového pole zadejte název skupiny prostředků, abyste potvrdili odstranění, a pak vyberte Odstranit.
Pomocí následujícího příkazu odstraňte všechny prostředky Azure použité v této ukázkové aplikaci:
azd down
Následující seznam popisuje interakce příkazů:
Celkový počet prostředků, které chcete odstranit: <celkový součet> vašich prostředků, opravdu chcete pokračovat?: Stiskněte y.
Chcete místo toho trvale odstranit tyto prostředky, což umožňuje opakované použití jejich názvů?: Stiskněte y. Pokud chcete znovu použít Key Vault, stiskněte klávesu n .
Konzola vypíše zprávy podobné následujícímu příkladu:
SUCCESS: Your application was removed from Azure in xx minutes xx seconds.
