Rychlý start: Nasazení aplikací mikroslužeb do Azure Spring Apps

• Předplatné Azure. Pokud ještě nemáte předplatné Azure, vytvořte si bezplatný účet Azure před tím, než začnete.
• Git
• Java Development Kit (JDK) verze 17.

• Předplatné Azure. Pokud předplatné nemáte, vytvořte si před zahájením bezplatný účet .
• Git
• Java Development Kit (JDK) verze 17.
• Azure Developer CLI verze 1.2.0 nebo vyšší.

• Předplatné Azure. Pokud předplatné nemáte, vytvořte si před zahájením bezplatný účet .
• 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 plánu Enterprise na Azure Marketplace.
• (Volitelné) Git.
• (Volitelné) Java Development Kit (JDK) verze 17.

• Předplatné Azure. Pokud předplatné nemáte, vytvořte si před zahájením bezplatný účet .
• 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 plánu Enterprise na Azure Marketplace.
• Git
• (Volitelné) Java Development Kit (JDK) verze 17.
• (Volitelné) Node.js verze 16.20 nebo vyšší.
• Azure CLI verze 2.45.0 nebo vyšší

• Předplatné Azure. Pokud předplatné nemáte, vytvořte si před zahájením bezplatný účet .
• 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 plánu Enterprise na Azure Marketplace.
• Git
• Java Development Kit (JDK) verze 17.
• Azure CLI verze 2.55.0 nebo vyšší.

Ukázku připravíte místně pomocí následujících kroků:

1. Naklonujte ukázkový projekt pomocí následujícího příkazu:

   git clone https://github.com/Azure-Samples/spring-petclinic-microservices.git
   

2. Přejděte do kořenového adresáře projektu a pak pomocí následujícího příkazu spusťte ukázkový projekt místně:

   bash ./scripts/run_all_without_infra.sh
   

3. Po úspěšném dokončení skriptu přejděte v http://localhost:8080 prohlížeči a přejděte do aplikace PetClinic.

Pomocí následujících kroků inicializujete aplikaci Pet Clinic pomocí šablon Azure Developer CLI:

1. V okně Bash vytvořte novou prázdnou složku a přejděte na ni.

2. K inicializaci projektu použijte následující příkaz:

   azd init --template Azure-Samples/spring-petclinic-microservices
   

   Následující seznam popisuje interakci s příkazy:

   • 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)
   
   Downloading template code to: <your-local-path>
   (✓) Done: Initialized git repository
   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.1. Přihlaste se k portálu Azure Portal.

Přejděte na web Azure Portal, zadejte svoje přihlašovací údaje a přihlaste se k portálu. Výchozím zobrazením je váš řídicí panel služby.

3.2. Vytvoření instance Azure Spring Apps

K vytvoření instance služby použijte následující postup:

1. V rohu webu Azure Portal vyberte Vytvořit prostředek .

2. Na kartě Služby Azure vyberte Compute>Azure Spring Apps.

   

3. Na stránce Vytvořit Azure Spring Apps vyplňte formulář na kartě Základy.

   

   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é, za které 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 instanci 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	Cenový plán určuje prostředky a náklady spojené s vaší instancí.
   Oblast	Oblast, která je nejblíže vašim uživatelům.	Umístění co nejblíže vašim uživatelům.
   Zónově redundantní	Nevybráno	Vytvoří službu Azure Spring Apps v zóně dostupnosti Azure. V současné době se nepodporuje ve všech oblastech.

4. Přejděte na kartu Nastavení diagnostiky na stránce Vytvořit azure Spring Apps a pak vyberte Vytvořit nový a vytvořte novou instanci pracovních prostorů služby Log Analytics. Na stránce Vytvořit nový pracovní prostor služby Log Analytics podle potřeby aktualizujte název pracovního prostoru služby Log Analytics a pak výběrem ok potvrďte vytvoření.

   

5. Přejděte na kartu Application Insights na stránce Vytvořit azure Spring Apps a pak vyberte Vytvořit novou a vytvořte novou instanci Application Insights. Na stránce Vytvořit nový prostředek Application Insights podle potřeby aktualizujte název Application Insights, vyberte pracovní prostor pro režim prostředků a pak výběrem ok potvrďte vytvoření.

   

6. 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.

7. Vyberte ikonu Oznámení (zvonek) a sledujte proces nasazení. Po dokončení nasazení můžete výběrem možnosti Připnout na řídicí panel vytvořit zástupce na řídicím panelu webu Azure Portal na stránce Přehled služby.

   

8. Výběrem možnosti Přejít k prostředku přejděte na stránku Přehled služby Azure Spring Apps.

9. V navigačním podokně vyberte Konfigurační server .

10. Na stránce konfiguračního serveru jako identifikátor URI zadejte https://github.com/Azure-Samples/spring-petclinic-microservices-config.git a pak vyberte Ověřit.

    

11. Po ověření vyberte Použít a dokončete konfiguraci konfiguračního serveru.

Pomocí následujících kroků vytvořte požadované prostředky:

1. 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.
   

2. Pomocí následujícího příkazu zabalte nasaditelnou kopii aplikace, zřiďte infrastrukturu šablony do Azure a pak 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.

Pomocí následujících kroků nasaďte aplikace mikroslužeb pomocí modulu plug-in Maven pro Azure Spring Apps:

1. Přejděte do ukázkového adresáře projektu a pak pomocí následujícího příkazu nakonfigurujte aplikace pro Azure Spring Apps:

   ./mvnw -P spring-apps com.microsoft.azure:azure-spring-apps-maven-plugin:1.17.0:config
   

2. Následující seznam popisuje interakce příkazů:

   • Vyberte podřízené moduly, které chcete konfigurovat (vstupní čísla oddělená čárkou, např: [1-2;4;6], ENTER vyberte VŠE): Stisknutím klávesy Enter vyberte vše.
   • Přihlášení OAuth2: Autorizuje přihlášení do 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.
   • 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.
   • Vyberte aplikace pro zveřejnění veřejného přístupu:(vstupní čísla oddělená čárkou, např: [1-2;4;6], ENTER vyberte NONE): Zadejte 1,5 pro admin-server a api-gateway.
   • Potvrďte uložení všech výše uvedených konfigurací (Y/n): Stiskněte y. Pokud stisknete klávesu n, konfigurace se neuloží do souborů POM.

3. Pomocí následujícího příkazu sestavte a nasaďte každou aplikaci:

   ./mvnw azure-spring-apps:deploy
   

4. V případě výzvy k přihlášení OAuth2 autorizujete přihlášení k Azure na základě protokolu OAuth2.

   Poznámka:

   Nasazení do Azure Spring Apps může trvat až 25 minut.

Po spuštění příkazu se v protokolu zobrazí výstup podobný následujícímu příkladu, který označuje, že všechna nasazení jsou úspěšná:

[INFO] Deployment(default) is successfully updated.
[INFO] Deployment Status: Running
[INFO]   InstanceName:admin-server-default-xx-xx-xxx  Status:Running Reason:null       DiscoverStatus:UP
[INFO] Getting public url of app(admin-server)...
[INFO] Application url: https://<your-Azure-Spring-Apps-instance-name>-admin-server.azuremicroservices.io

...

[INFO] Getting public url of app(api-gateway)...
[INFO] Application url: https://<your-Azure-Spring-Apps-instance-name>-api-gateway.azuremicroservices.io

Pomocí následujících kroků zabalte aplikaci, zřiďte prostředky Azure vyžadované webovou aplikací a pak ji nasaďte do Azure Spring Apps:

1. 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 minutes xx seconds.
   

2. 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 admin-server
   - Endpoint: https://<your-Azure-Spring-Apps-instance-name>-admin-server.azuremicroservices.io
   
   (✓) Done: Deploying service api-gateway
   - Endpoint: https://<your-Azure-Spring-Apps-instance-name>-api-gateway.azuremicroservices.io
   
   (✓) Done: Deploying service customers-service
   - No endpoints were found
   
   (✓) Done: Deploying service vets-service
   - No endpoints were found
   
   (✓) Done: Deploying service visits-service
   - 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
   

Tlačítko Nasadit do Azure v další části spustí prostředí webu Azure Portal, které nasadí zdrojový kód z úložiště Spring PetClinic . Nejsou potřeba žádné místní přípravné kroky.

Pokud chcete aplikaci před nasazením do cloudu ověřit, použijte na místním počítači následující kroky:

1. Pomocí následujícího příkazu naklonujte aplikaci Pet Clinic z GitHubu:

   git clone https://github.com/Azure-Samples/spring-petclinic-microservices.git
   

2. Přejděte do kořenového adresáře projektu a pak pomocí následujícího příkazu sestavte projekt:

   ./mvnw clean package -DskipTests
   

Pokud chcete aplikaci spustit místně, postupujte následovně. V opačném případě můžete tyto kroky přeskočit.

1. Otevřete nové okno Bash a pak pomocí následujícího příkazu spusťte konfigurační server:

   ./mvnw spring-boot:run -pl spring-petclinic-config-server
   

2. Otevřete nové okno Bash a pak pomocí následujícího příkazu spusťte Discovery Server:

   ./mvnw spring-boot:run -pl spring-petclinic-discovery-server
   

3. Pro služby Customers, Vets, Visits a Spring Cloud Gateway otevřete nové okno Bash a pomocí následujících příkazů spusťte služby:

   ./mvnw spring-boot:run -pl spring-petclinic-customers-service
   ./mvnw spring-boot:run -pl spring-petclinic-vets-service
   ./mvnw spring-boot:run -pl spring-petclinic-visits-service
   ./mvnw spring-boot:run -Dspring-boot.run.profiles=default,development \
       -pl spring-petclinic-api-gateway
   

4. Otevřete nové okno Bash a přejděte do adresáře projektu spring-petclinic-frontend . Pomocí následujících příkazů nainstalujte závislosti a spusťte front-endovou aplikaci:

   npm install
   npm run start
   

5. Po úspěšném dokončení skriptu přejděte v http://localhost:8080 prohlížeči a přejděte do aplikace PetClinic.

Pokud chcete aplikaci před nasazením do cloudu ověřit, použijte na místním počítači následující kroky:

1. Pomocí následujícího příkazu naklonujte aplikaci Pet Clinic z GitHubu:

   git clone https://github.com/Azure-Samples/spring-petclinic-microservices.git
   

2. Přejděte do kořenového adresáře projektu a pak pomocí následujícího příkazu sestavte projekt:

   ./mvnw clean package -DskipTests
   

Pokud chcete aplikaci spustit místně, postupujte následovně. V opačném případě můžete tyto kroky přeskočit.

1. Otevřete nové okno Bash a pak pomocí následujícího příkazu spusťte konfigurační server:

   ./mvnw spring-boot:run -pl spring-petclinic-config-server
   

2. Otevřete nové okno Bash a pak pomocí následujícího příkazu spusťte Discovery Server:

   ./mvnw spring-boot:run -pl spring-petclinic-discovery-server
   

3. Pro služby Customers, Vets, Visits a Spring Cloud Gateway otevřete nové okno Bash a pomocí následujících příkazů spusťte služby:

   ./mvnw spring-boot:run -pl spring-petclinic-customers-service
   ./mvnw spring-boot:run -pl spring-petclinic-vets-service
   ./mvnw spring-boot:run -pl spring-petclinic-visits-service
   ./mvnw spring-boot:run -Dspring-boot.run.profiles=default,development \
       -pl spring-petclinic-api-gateway
   

4. Otevřete nové okno Bash a přejděte do adresáře projektu spring-petclinic-frontend . Pomocí následujících příkazů nainstalujte závislosti a spusťte front-endovou aplikaci:

   npm install
   npm run start
   

5. Po úspěšném dokončení skriptu přejděte v http://localhost:8080 prohlížeči a přejděte do aplikace PetClinic.

Tato část používá tlačítko Nasadit do Azure ke spuštění prostředí nasazení na webu Azure Portal. V tomto prostředí se k vytváření prostředků Azure používá šablona ARM.

3.1. Přihlaste se k portálu Azure Portal.

Přejděte na web Azure Portal, zadejte svoje přihlašovací údaje a přihlaste se 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í:

1. Výběrem následujícího tlačítka Nasadit do Azure spusťte prostředí nasazení na webu Azure Portal:

   

2. 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ů.

   

3. 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.

4. 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 Azure Spring Apps

K vytvoření instance služby použijte následující postup:

1. V rohu webu Azure Portal vyberte Vytvořit prostředek .

2. Vyberte Compute>Azure Spring Apps.

3. 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	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.

4. Přejděte na kartu Nastavení diagnostiky na stránce Vytvořit azure Spring Apps a pak vyberte Vytvořit nový a vytvořte novou instanci pracovních prostorů služby Log Analytics. Na stránce Vytvořit nový pracovní prostor služby Log Analytics podle potřeby aktualizujte název pracovního prostoru služby Log Analytics a pak výběrem ok potvrďte vytvoření.

5. Přejděte na kartu Application Insights na stránce Vytvořit azure Spring Apps a pak vyberte Vytvořit novou a vytvořte novou instanci Application Insights. Na stránce Vytvořit nový prostředek Application Insights podle potřeby aktualizujte název Application Insights, vyberte pracovní prostor pro režim prostředků a pak výběrem ok potvrďte vytvoření.

6. 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.

7. Vyberte ikonu Oznámení (zvonek) a sledujte proces nasazení. Po dokončení nasazení můžete výběrem možnosti Připnout na řídicí panel vytvořit zástupce na řídicím panelu webu Azure Portal na stránce Přehled služby.

   

8. 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.3. Konfigurace instance Azure Spring Apps

Následující části ukazují, jak nakonfigurovat instanci služby.

Vytvoření aplikací

K vytvoření aplikací použijte následující postup:

1. V navigačním podokně vyberte Aplikace a pak vyberte Vytvořit aplikaci.

2. Na stránce Vytvořit aplikaci použijte jako název aplikace front-end a nechte všechna ostatní pole s jejich výchozími hodnotami.

3. Opakujte předchozí krok pomocí každého z následujících názvů aplikací:

   • customers-service
   • vets-service
   • visits-service

4. Výběrem možnosti Vytvořit dokončíte vytváření aplikace.

   

Konfigurace registru služby

Pomocí následujících kroků nakonfigurujte registr služeb:

1. V navigačním podokně vyberte Registr služeb.

2. Vyberte vazbu aplikace, vyberte Vytvořit vazbu aplikace, vyberte customers-service ze seznamu a pak vyberte Použít.

3. Opakováním předchozího kroku vytvořte vazbu následujících aplikací:

   • vets-service
   • visits-service

   

Konfigurace služby konfigurace aplikace

Ke konfiguraci služby Application Configuration Service použijte následující kroky:

1. V navigačním podokně vyberte Službu konfigurace aplikace a pak vyberte Nastavení.

2. Vyplňte úložiště následujícími informacemi a pak vyberte Ověřit:

   • Název: výchozí
   • Vzory: aplikace, api-gateway, customers-service, vets-service, visits-service
   • Identifikátor URI: https://github.com/Azure-Samples/spring-petclinic-microservices-config.git.
   • Popisek: předloha

   

3. Po ověření vyberte Použít a dokončete konfiguraci služby Konfigurace aplikace.

4. Vyberte vazbu aplikace, vyberte Vytvořit vazbu aplikace, vyberte customers-service ze seznamu a pak vyberte Použít.

5. Opakováním předchozího kroku vytvořte vazbu následujících aplikací:

   • vets-service
   • visits-service

   

Nastavení vzorů konfiguračních souborů pro aplikace

Pomocí následujících kroků nastavte vzory konfiguračních souborů:

1. V navigačním podokně vyberte Aplikace a pak aplikaci vyberte customers-service .

2. Na stránce Přehled aplikace vyberte Konfigurace, na kartě Obecné nastavení vyberte Vzory konfiguračního souboru a pak vyberte aplikaci a customers-service. Výběrem možnosti Uložit nastavte vzory konfiguračního souboru.

3. Opakujte předchozí krok a uložte vzory konfiguračních souborů pro následující aplikace:

   • vets-service: Vyberte aplikaci a vets-service.
   • visits-service: Vyberte aplikaci a visits-service.

Konfigurace brány Spring Cloud

V této části se dozvíte, jak nakonfigurovat bránu Spring Cloud.

Nejprve pomocí následujících kroků přiřaďte koncový bod pro přístup k bráně:

1. V navigačním podokně vyberte bránu Spring Cloud.

2. Na kartě Přehled vyberte Ano a přiřaďte koncový bod. Uložte adresu URL koncového bodu, abyste ji mohli použít později.

Dále nakonfigurujte směrování pro bránu Spring Cloud. Vzhledem k tomu, že Azure Portal v současné době nepodporuje konfiguraci tras pro bránu Spring Cloud, otevřete okno Bash a pomocí následujících kroků Azure CLI nakonfigurujte směrování:

1. Pomocí následujícího příkazu se přihlaste k Azure CLI:

   az login
   

2. Pomocí následujících příkazů nainstalujte rozšíření Azure Spring Apps pro Azure CLI a zaregistrujte obor názvů Microsoft.SaaS:

   az extension add --name spring --upgrade
   az provider register --namespace Microsoft.SaaS
   

3. Pomocí následujícího příkazu přijměte právní podmínky a prohlášení o zásadách ochrany osobních údajů:

   Poznámka:

   Tento krok je nezbytný jenom v případě, že se vaše předplatné nikdy nepoužilo k vytvoření instance plánu Enterprise pro Azure Spring Apps.

   az term accept \
       --publisher vmware-inc \
       --product azure-spring-cloud-vmware-tanzu-2 \
       --plan asa-ent-hr-mtr
   

4. 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.

   export SUBSCRIPTION_ID=<subscription-ID>
   export RESOURCE_GROUP=<resource-group-name>
   export SPRING_APPS_NAME=<Azure-Spring-Apps-instance-name>
   export APP_CUSTOMERS_SERVICE=customers-service
   export APP_VETS_SERVICE=vets-service
   export APP_VISITS_SERVICE=visits-service
   export APP_FRONTEND=frontend
   

5. K nastavení výchozího předplatného použijte následující příkaz:

   az account set --subscription ${SUBSCRIPTION_ID}
   

6. K nastavení směrování aplikace customers-service použijte následující příkaz:

   az spring gateway route-config create \
       --resource-group ${RESOURCE_GROUP} \
       --service ${SPRING_APPS_NAME} \
       --name ${APP_CUSTOMERS_SERVICE} \
       --app-name ${APP_CUSTOMERS_SERVICE} \
       --routes-json \
         '[
           {
             "predicates": [
               "Path=/api/customer/**"
             ],
             "filters": [
               "StripPrefix=2"
             ]
           }
         ]'
   

7. K nastavení směrování aplikace vets-service použijte následující příkaz:

   az spring gateway route-config create \
       --resource-group ${RESOURCE_GROUP} \
       --service ${SPRING_APPS_NAME} \
       --name ${APP_VETS_SERVICE} \
       --app-name ${APP_VETS_SERVICE} \
       --routes-json \
         '[
            {
              "predicates": [
                "Path=/api/vet/**"
              ],
              "filters": [
                "StripPrefix=2"
              ]
            }
          ]'
   

8. K nastavení směrování aplikace visits-service použijte následující příkaz:

   az spring gateway route-config create \
       --resource-group ${RESOURCE_GROUP} \
       --service ${SPRING_APPS_NAME} \
       --name ${APP_VISITS_SERVICE} \
       --app-name ${APP_VISITS_SERVICE} \
       --routes-json \
         '[
            {
              "predicates": [
                "Path=/api/visit/**"
              ],
              "filters": [
                "StripPrefix=2"
              ]
            }
          ]'
   

9. K nastavení směrování front-endové aplikace použijte následující příkaz:

   az spring gateway route-config create \
       --resource-group ${RESOURCE_GROUP} \
       --service ${SPRING_APPS_NAME} \
       --name ${APP_FRONTEND} \
       --app-name ${APP_FRONTEND} \
       --routes-json \
         '[
            {
              "predicates": [
                "Path=/**"
              ],
              "filters": [
                "StripPrefix=0"
              ],
              "order": 1000
            }
          ]'
   

Konfigurace vývojářských nástrojů

Ke konfiguraci vývojářských nástrojů použijte následující postup.

1. V navigačním podokně vyberte Vývojářské nástroje.

2. Vyberte Přiřadit koncový bod a přiřaďte koncový bod pro Vývojářské nástroje.

3. Uložte koncový bod živého zobrazení aplikace, abyste ho mohli použít později.

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.

export LOCATION=<location>
export RESOURCE_GROUP=myresourcegroup
export SPRING_APPS=myasa
export APP_FRONTEND=frontend
export APP_CUSTOMERS_SERVICE=customers-service
export APP_VETS_SERVICE=vets-service
export APP_VISITS_SERVICE=visits-service
export GIT_CONFIG_REPO=default

3.2. Přihlášení k Azure CLI

Přihlaste se pomocí následujících kroků:

1. Pomocí následujícího příkazu se přihlaste k Azure CLI:

   az login
   

2. 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
   

3. K nastavení výchozího předplatného použijte následující příkaz:

   az account set --subscription <subscription-ID>
   

3.3. Vytvoření nové skupiny prostředků

Pomocí následujících kroků vytvořte novou skupinu prostředků:

1. K nastavení výchozího umístění použijte následující příkaz:

   az configure --defaults location=${LOCATION}
   

2. Pomocí následujícího příkazu vytvořte skupinu prostředků:

   az group create --resource-group ${RESOURCE_GROUP}
   

3. 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.4. 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.5. Vytvoření instance Azure Spring Apps

K vytvoření instance služby použijte následující postup:

1. Pomocí následujícího příkazu přijměte právní podmínky a prohlášení o zásadách ochrany osobních údajů pro plán Enterprise:

   Poznámka:

   Tento krok je nezbytný jenom v případě, že se vaše předplatné nikdy nepoužilo k vytvoření instance plánu Enterprise pro Azure Spring Apps.

   az term accept \
       --publisher vmware-inc \
       --product azure-spring-cloud-vmware-tanzu-2 \
       --plan asa-ent-hr-mtr
   

2. Pomocí následujícího příkazu vytvořte instanci služby Azure Spring Apps s potřebnými komponentami Tanzu:

   az spring create \
       --name ${SPRING_APPS} \
       --sku Enterprise \
       --enable-application-configuration-service \
       --enable-service-registry \
       --enable-gateway \
       --enable-application-live-view
   

3.6. Konfigurace instance Azure Spring Apps

Ke konfiguraci instance služby použijte následující kroky:

1. Pomocí následujícího příkazu nakonfigurujte nastavení diagnostiky pro instanci Azure Spring Apps:

   export SPRING_APPS_RESOURCE_ID=$(az spring show \
       --name ${SPRING_APPS} \
       --query id \
       --output tsv)
   az monitor diagnostic-settings create \
       --resource ${SPRING_APPS_RESOURCE_ID} \
       --name logs-and-metrics \
       --workspace ${SPRING_APPS} \
       --logs '[
         {
           "category": "ApplicationConsole",
           "enabled": true,
           "retentionPolicy": {
             "enabled": false,
             "days": 0
           }
         },
         {
            "category": "SystemLogs",
            "enabled": true,
            "retentionPolicy": {
              "enabled": false,
              "days": 0
            }
         },
         {
            "category": "IngressLogs",
            "enabled": true,
            "retentionPolicy": {
              "enabled": false,
              "days": 0
             }
         }
       ]' \
       --metrics '[
         {
           "category": "AllMetrics",
           "enabled": true,
           "retentionPolicy": {
             "enabled": false,
             "days": 0
           }
         }
       ]'
   

2. K vytvoření aplikací pro instanci Azure Spring Apps použijte následující příkazy:

   az spring app create --service ${SPRING_APPS} --name ${APP_FRONTEND}
   az spring app create --service ${SPRING_APPS} --name ${APP_CUSTOMERS_SERVICE}
   az spring app create --service ${SPRING_APPS} --name ${APP_VETS_SERVICE}
   az spring app create --service ${SPRING_APPS} --name ${APP_VISITS_SERVICE}
   

3. K vytvoření vazby aplikací pro registr služby použijte následující příkazy:

   az spring service-registry bind --service ${SPRING_APPS} --app ${APP_CUSTOMERS_SERVICE}
   az spring service-registry bind --service ${SPRING_APPS} --app ${APP_VETS_SERVICE}
   az spring service-registry bind --service ${SPRING_APPS} --app ${APP_VISITS_SERVICE}
   

4. Pomocí následujícího příkazu vytvořte úložiště konfigurace pro službu Konfigurace aplikace:

   az spring application-configuration-service git repo add \
       --service ${SPRING_APPS} \
       --name ${GIT_CONFIG_REPO} \
       --patterns application,api-gateway,customers-service,vets-service,visits-service \
       --uri https://github.com/Azure-Samples/spring-petclinic-microservices-config.git \
       --label master
   

5. K vytvoření vazby aplikací ke službě Konfigurace aplikace použijte následující příkazy:

   az spring application-configuration-service bind \
       --service ${SPRING_APPS} \
       --app ${APP_CUSTOMERS_SERVICE}
   az spring application-configuration-service bind \
       --service ${SPRING_APPS} \
       --app ${APP_VETS_SERVICE}
   az spring application-configuration-service bind \
       --service ${SPRING_APPS} \
       --app ${APP_VISITS_SERVICE}
   

6. Pomocí následujícího příkazu přiřaďte koncový bod bráně Spring Cloud:

   az spring gateway update --service ${SPRING_APPS} --assign-endpoint
   

7. K nastavení směrování pro customers-service aplikaci použijte následující příkaz:

   az spring gateway route-config create \
       --service ${SPRING_APPS} \
       --name ${APP_CUSTOMERS_SERVICE} \
       --app-name ${APP_CUSTOMERS_SERVICE} \
       --routes-json '[
         {
           "predicates": [
             "Path=/api/customer/**"
           ],
           "filters": [
             "StripPrefix=2"
           ]
         }
      ]'
   

8. K nastavení směrování pro vets-service aplikaci použijte následující příkaz:

   az spring gateway route-config create \
       --service ${SPRING_APPS} \
       --name ${APP_VETS_SERVICE} \
       --app-name ${APP_VETS_SERVICE} \
       --routes-json '[
         {
           "predicates": [
             "Path=/api/vet/**"
           ],
           "filters": [
             "StripPrefix=2"
           ]
         }
       ]'
   

9. K nastavení směrování pro visits-service aplikaci použijte následující příkaz:

   az spring gateway route-config create \
       --service ${SPRING_APPS} \
       --name ${APP_VISITS_SERVICE} \
       --app-name ${APP_VISITS_SERVICE} \
       --routes-json '[
         {
           "predicates": [
             "Path=/api/visit/**"
           ],
           "filters": [
             "StripPrefix=2"
           ]
         }
       ]'
   

10. K nastavení směrování pro frontend aplikaci použijte následující příkaz:

    az spring gateway route-config create \
        --service ${SPRING_APPS} \
        --name ${APP_FRONTEND} \
        --app-name ${APP_FRONTEND} \
        --routes-json '[
          {
            "predicates": [
              "Path=/**"
            ],
            "filters": [
              "StripPrefix=0"
            ],
            "order": 1000
          }
        ]'
    

11. Pomocí následujícího příkazu přiřaďte koncový bod k živému zobrazení aplikace:

    az spring dev-tool update --service ${SPRING_APPS} --assign-endpoint
    

Tlačítko Nasadit do Azure v předchozí části spustí prostředí webu Azure Portal, které zahrnuje nasazení aplikace, takže není potřeba nic jiného.

Pomocí následujících kroků nasaďte modul plug-in Maven pro Azure Spring Apps:

1. Přejděte do kořenového adresáře projektu a spuštěním následujícího příkazu nakonfigurujte aplikace v Azure Spring Apps:

   ./mvnw -P spring-apps-enterprise com.microsoft.azure:azure-spring-apps-maven-plugin:1.19.0:config
   

   Následující seznam popisuje interakce příkazů:

   • Vyberte podřízené moduly, které chcete konfigurovat: Stisknutím klávesy Enter vyberte vše.
   • 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 aplikace, které chcete zveřejnit veřejný přístup: Stisknutím klávesy Enter vyberte žádné.
   • 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.

2. K nasazení back-endových aplikací použijte následující příkaz:

   ./mvnw azure-spring-apps:deploy
   

   Po spuštění příkazu uvidíte z následujících zpráv protokolu, že nasazení proběhlo úspěšně:

   [INFO] Start deploying artifact(customers-service-3.0.1.jar) to deployment(default) of app(customers-service)...
   [INFO] Artifact(customers-service-3.0.1.jar) is successfully deployed to deployment(default) of app(customers-service).
   [INFO] Starting Spring App after deploying artifacts...
   [INFO] Deployment Status: Running
   
   ...
   
   [INFO] Start deploying artifact(vets-service-3.0.1.jar) to deployment(default) of app(vets-service)...
   [INFO] Artifact(vets-service-3.0.1.jar) is successfully deployed to deployment(default) of app(vets-service).
   [INFO] Starting Spring App after deploying artifacts...
   [INFO] Deployment Status: Running
   
   ...
   
   [INFO] Start deploying artifact(visits-service-3.0.1.jar) to deployment(default) of app(visits-service)...
   [INFO] Artifact(visits-service-3.0.1.jar) is successfully deployed to deployment(default) of app(visits-service).
   [INFO] Starting Spring App after deploying artifacts...
   [INFO] Deployment Status: Running
   

3. Azure Portal nepodporuje nasazování front-endových aplikací, proto k nasazení front-endové aplikace použijte následující příkaz Azure CLI:

   az spring app deploy \
       --resource-group ${RESOURCE_GROUP} \
       --service ${SPRING_APPS_NAME} \
       --name ${APP_FRONTEND} \
       --source-path spring-petclinic-frontend \
       --build-env BP_WEB_SERVER=nginx
   

   Po spuštění příkazu uvidíte z následujících zpráv protokolu, že nasazení proběhlo úspěšně:

   [5/5] Updating deployment in app "frontend" (this operation can take a while to complete)
   Azure Spring Apps will use rolling upgrade to update your deployment, you have 1 instance, Azure Spring Apps will update the deployment in 1 round.
   The deployment is in round 1, 1 old instance is deleted/deleting and 1 new instance is started/starting
   Your application is successfully deployed.
   

K nasazení aplikací použijte následující postup:

1. Zadejte kořenový adresář projektu a pomocí následujícího příkazu sestavte a nasaďte front-endovou aplikaci:

   az spring app deploy \
       --service ${SPRING_APPS} \
       --name ${APP_FRONTEND} \
       --build-env BP_WEB_SERVER=nginx \
       --source-path ./spring-petclinic-frontend
   

2. K sestavení a nasazení customers-service aplikace použijte následující příkaz:

   az spring app deploy \
       --service ${SPRING_APPS} \
       --name ${APP_CUSTOMERS_SERVICE} \
       --source-path \
       --config-file-pattern application,customers-service \
       --build-env \
           BP_MAVEN_BUILT_MODULE=spring-petclinic-customers-service \
           BP_JVM_VERSION=17
   

3. K sestavení a nasazení vets-service aplikace použijte následující příkaz:

   az spring app deploy \
       --service ${SPRING_APPS} \
       --name ${APP_VETS_SERVICE} \
       --source-path \
       --config-file-pattern application,vets-service \
       --build-env \
           BP_MAVEN_BUILT_MODULE=spring-petclinic-vets-service \
           BP_JVM_VERSION=17
   

4. K sestavení a nasazení visits-service aplikace použijte následující příkaz:

   az spring app deploy \
       --service ${SPRING_APPS} \
       --name ${APP_VISITS_SERVICE} \
       --source-path \
       --config-file-pattern application,visits-service \
       --build-env \
           BP_MAVEN_BUILT_MODULE=spring-petclinic-visits-service \
           BP_JVM_VERSION=17
   

5.1. Přístup k aplikacím

Po dokončení nasazení najdete adresu URL brány Spring Cloud z výstupů nasazení, jak je znázorněno na následujícím snímku obrazovky:

Otevřete adresu URL brány. Aplikace by měla vypadat podobně jako na následujícím snímku obrazovky:

5.2. Dotazování protokolů aplikace

Po procházení jednotlivých funkcí Pet Clinic shromažďuje pracovní prostor Log Analytics protokoly každé aplikace. Protokoly můžete zkontrolovat pomocí vlastních dotazů, jak je znázorněno na následujícím snímku obrazovky:

5.3. Monitorování aplikací

Application Insights monitoruje závislosti aplikací, jak je znázorněno v následující mapě trasování aplikací:

Adresu URL živého zobrazení aplikace najdete ve výstupech nasazení. Otevřete adresu URL živého zobrazení aplikace pro monitorování modulů runtime aplikací, jak je znázorněno na následujícím snímku obrazovky:

5.1. Přístup k aplikacím

Použijte koncový bod přiřazený z brány Spring Cloud , https://<your-Azure-Spring-Apps-instance-name>-gateway-xxxxx.svc.azuremicroservices.ionapříklad . Aplikace by měla vypadat podobně jako na následujícím snímku obrazovky:

5.2. Dotazování protokolů aplikace

Po procházení jednotlivých funkcí Pet Clinic shromažďuje pracovní prostor Log Analytics protokoly každé aplikace. Protokoly můžete zkontrolovat pomocí vlastních dotazů, jak je znázorněno na následujícím snímku obrazovky:

5.3. Monitorování aplikací

Application Insights monitoruje závislosti aplikací, jak je znázorněno v následující mapě trasování aplikací:

Otevřete adresu URL živého zobrazení aplikace vystavenou vývojářskými nástroji, abyste mohli monitorovat moduly runtime aplikací, jak je znázorněno na následujícím snímku obrazovky:

5.1. Přístup k aplikacím

K načtení adresy URL brány Spring Cloud použijte následující příkazy:

export GATEWAY_URL=$(az spring gateway show \
    --service ${SPRING_APPS} \
    --query properties.url \
    --output tsv)
echo "https://${GATEWAY_URL}"

Aplikace by měla vypadat podobně jako na následujícím snímku obrazovky:

5.2. Dotazování protokolů aplikace

Po procházení jednotlivých funkcí Pet Clinic shromažďuje pracovní prostor Log Analytics protokoly každé aplikace. Protokoly můžete zkontrolovat pomocí vlastních dotazů, jak je znázorněno na následujícím snímku obrazovky:

5.3. Monitorování aplikací

Application Insights monitoruje závislosti aplikací, jak je znázorněno v následující mapě trasování aplikací:

K načtení adresy URL živého zobrazení aplikace použijte následující příkazy:

export DEV_TOOL_URL=$(az spring dev-tool show \
    --service ${SPRING_APPS} \
    --query properties.url \
    --output tsv)
echo "https://${DEV_TOOL_URL}/app-live-view"

Otevřete adresu URL živého zobrazení aplikace pro monitorování modulů runtime aplikací, jak je znázorněno na následujícím snímku obrazovky:

Pomocí následujících kroků odstraňte celou skupinu prostředků, včetně nově vytvořené instance služby:

1. 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ů.

2. 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 interakci s příkazy:

• Celkový počet prostředků, které chcete odstranit: <zdroje celkem>, opravdu chcete pokračovat?: Stiskněte y.

Konzola vypíše zprávy podobné následujícímu příkladu:

SUCCESS: Your application was removed from Azure in xx minutes xx seconds.

Pomocí následujících kroků odstraňte celou skupinu prostředků:

1. 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ů.

2. 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ů:

1. 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ů.

2. 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 skupinu prostředků:

az group delete --name ${RESOURCE_GROUP}