Rychlý start: Nasazení první aplikace do Azure Spring Apps

Poznámka

Prvních 50 hodin vCPU a 100 GB paměti je každý měsíc zdarma. Další informace najdete v tématu Snížení ceny – Azure Spring Apps dělá víc, náklady méně! na blogu o aplikacích v Azure.

Poznámka

Azure Spring Apps je nový název služby Azure Spring Cloud. I když má služba nový název, uvidíte na některých místech na chvíli starý název, protože pracujeme na aktualizaci prostředků, jako jsou snímky obrazovky, videa a diagramy.

Tento článek vysvětluje, jak nasadit malou aplikaci pro spuštění v Azure Spring Apps.

Kód aplikace použitý v tomto kurzu je jednoduchá aplikace. Po dokončení tohoto příkladu bude aplikace přístupná online a můžete ji spravovat prostřednictvím Azure Portal.

Tento článek popisuje následující dvě možnosti nasazení do Azure Spring Apps:

  • Azure Portal představuje konventivnější způsob vytváření prostředků a nasazování aplikací krok za krokem. Je vhodný pro vývojáře spring, kteří používají cloudové služby Azure poprvé.
  • Azure Developer CLI je efektivnější způsob, jak automaticky vytvářet prostředky a nasazovat aplikace pomocí jednoduchých příkazů. Zabývá se kódem aplikace a infrastrukturou jako soubory kódu potřebnými ke zřízení prostředků Azure. Je vhodný pro vývojáře spring, kteří znají cloudové služby Azure.

1. Požadavky

2. Příprava projektu Spring

Při přípravě projektu postupujte následovně:

  1. Pomocí následujícího příkazu naklonujte ukázkový projekt Spring Boot pro Azure z GitHubu.

    git clone https://github.com/spring-guides/gs-spring-boot-for-azure.git
    
  2. Pomocí následujícího příkazu přejděte do složky projektu:

    cd gs-spring-boot-for-azure/complete
    
  3. K sestavení projektu použijte následující příkaz Mavenu :

    ./mvnw clean package
    
  4. Spusťte ukázkový projekt místně pomocí následujícího příkazu:

    ./mvnw spring-boot:run
    

3. Příprava cloudového prostředí

Hlavním prostředkem, který potřebujete ke spuštění této ukázky, je instance Azure Spring Apps. K vytvoření tohoto prostředku použijte následující postup.

3.1. Přihlášení k webu Azure Portal

Otevřete webový prohlížeč a přejděte na 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 Azure Spring Apps

Pomocí následujících kroků vytvořte instanci služby Azure Spring Apps:

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

  2. Vyberte Compute>Azure Spring Apps.

    Snímek obrazovky s Azure Portal, který zobrazuje Azure Spring Apps v seznamu výpočetních prostředků

  3. Ve formuláři Základy vyplňte následující informace.

    Jako vodítko pro vyplnění formuláře použijte následující tabulku. Doporučený plán je Standard consumption & dedicated (preview).

    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 se má 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 pouze malá písmena, číslice a spojovníky. První znak názvu služby musí být písmeno a poslední znak musí být písmeno nebo číslo.
    Plánování Vyhrazená verze Standard Consumption & (Preview) Cenový plán určuje prostředky a náklady přidružené k vaší instanci.
    Oblast Oblast nejbližší vašim uživatelům Umístění co nejblíže vašim uživatelům.
    Prostředí Container Apps Věrnásek Prostředí je zabezpečená hranice kolem jedné nebo více aplikací kontejneru, které spolu můžou komunikovat a sdílet virtuální síť, protokolování a konfiguraci Dapr.

    Snímek obrazovky s Azure Portal se stránkou Vytvořit aplikace Azure Spring

  4. (Volitelné) Vytvořte prostředí Container Apps.

    1. Na kartě Základy vyplňte následující informace:

      • Název prostředí: myacaenv
      • Plán: Consumption
      • Zónová redundance: Zakázáno

      Snímek obrazovky s Azure Portal, který zobrazuje prostředí Vytvořit aplikace kontejneru s vybraným plánem Consumption

    2. Vyberte Vytvořit a vytvořte prostředí Container Apps.

  5. Vyberte Zkontrolovat a vytvořit a zkontrolujte své výběry. Vyberte Vytvořit a zřiďte instanci Azure Spring Apps.

  6. 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, čímž se na řídicím panelu Azure Portal vytvoří dlaždice pro tuto službu jako zástupce na stránce Přehled služby.

    Snímek obrazovky s Azure Portal, který zobrazuje podokno Oznámení pro vytvoření Azure Spring Apps

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

4. Nasazení aplikace do Azure Spring Apps

Tato část obsahuje postup nasazení aplikace do Azure Spring Apps.

Při nasazení pomocí modulu plug-in Maven pro Azure Spring Apps postupujte následovně:

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

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

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

    • Přihlášení OAuth2: Musíte autorizovat přihlášení k Azure na základě protokolu OAuth2.
    • Vybrat 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 přímo Enter .
    • 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 přímo Enter .
    • Zadejte název aplikace: Zadejte název aplikace. Pokud použijete výchozí ID artefaktu projektu, stiskněte klávesu Enter přímo.
    • Zveřejnit veřejný přístup pro tuto aplikaci (boot-for-azure)?: Stiskněte klávesu y.
    • Potvrďte, že chcete uložit všechny výše uvedené konfigurace (A/n): Stiskněte klávesu y. Pokud stisknete klávesu N, konfigurace se neuloží do souborů POM.
  2. K nasazení aplikace použijte následující příkaz:

    ./mvnw com.microsoft.azure:azure-spring-apps-maven-plugin:1.18.0: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 provedení příkazu uvidíte z následujících zpráv protokolu, že nasazení proběhlo úspěšně:

    [INFO] Deployment(default) is successfully updated.
    [INFO] Deployment Status: Running
    [INFO]   InstanceName:demo-default-x-xxxxxxxxxx-xxxxx  Status:Running Reason:null       DiscoverStatus:UNREGISTERED
    [INFO] Getting public url of app(demo)...
    [INFO] Application url: https://<your-Azure-Spring-Apps-instance-name>-demo.azuremicroservices.io
    

2. Příprava jarního projektu

K přípravě projektu použijte následující postup:

  1. Pomocí následujícího příkazu naklonujte ukázkový projekt Spring Boot pro Azure z GitHubu.

    git clone https://github.com/spring-guides/gs-spring-boot-for-azure.git
    
  2. Pomocí následujícího příkazu přejděte do složky projektu:

    cd gs-spring-boot-for-azure/complete
    
  3. K sestavení projektu použijte následující příkaz Mavenu :

    ./mvnw clean package
    
  4. Spusťte ukázkový projekt místně pomocí následujícího příkazu:

    ./mvnw spring-boot:run
    

3. Příprava cloudového prostředí

Hlavním prostředkem, který potřebujete ke spuštění této ukázky, je instance Azure Spring Apps. K vytvoření tohoto prostředku použijte následující postup.

3.1. Přihlášení k webu Azure Portal

Otevřete webový prohlížeč a přejděte na 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 Azure Spring Apps

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

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

  2. Vyberte Compute>Azure Spring Apps.

    Snímek obrazovky s Azure Portal, který zobrazuje Azure Spring Apps v seznamu výpočetních prostředků

  3. Ve formuláři Základy vyplňte následující informace:

    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 se má 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 pouze malá písmena, číslice a spojovníky. První znak názvu služby musí být písmeno a poslední znak musí být písmeno nebo číslo.
    Plánování Standard Cenový plán, který 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.
    Zónově redundantní Nevybrané Určuje, jestli se má služba Azure Spring Apps vytvořit v zóně dostupnosti Azure. Tato funkce se v současné době nepodporuje ve všech oblastech.

    Snímek obrazovky s Azure Portal, který zobrazuje stránku Vytvořit aplikace Azure Spring

  4. Vyberte Zkontrolovat a vytvořit a zkontrolujte své výběry. Vyberte Vytvořit a zřiďte instanci Azure Spring Apps.

  5. 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, čímž se na řídicím panelu Azure Portal vytvoří dlaždice pro tuto službu jako zástupce na stránce Přehled služby.

    Snímek obrazovky s Azure Portal, který zobrazuje podokno Oznámení pro vytvoření Azure Spring Apps

  6. Vyberte Přejít k prostředku a přejděte na stránku Přehled služby Azure Spring Apps .

4. Nasazení aplikace do Azure Spring Apps

Tato část obsahuje postup nasazení aplikace do Azure Spring Apps.

K nasazení použijte modul plug-in Maven pro Azure Spring Apps pomocí následujícího postupu:

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

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

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

    • 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ého instance Azure Spring Apps, kterou jste vytvořili, a ve výchozím nastavení se nastaví 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.
    • Zadejte název aplikace: Zadejte název aplikace. Pokud použijete výchozí ID artefaktu projektu, stiskněte klávesu Enter přímo.
    • Zveřejnit veřejný přístup pro tuto aplikaci (boot-for-azure)?: Stiskněte y.
    • Potvrďte, že chcete uložit všechny výše uvedené konfigurace (Y/n):Stiskněte y. Pokud stisknete klávesu n, konfigurace se neuloží do souborů POM.
  2. K nasazení aplikace použijte následující příkaz:

    ./mvnw com.microsoft.azure:azure-spring-apps-maven-plugin:1.18.0:deploy
    

    Následující seznam popisuje interakce 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 uvidíte z následujících zpráv protokolu, že nasazení proběhlo úspěšně:

    [INFO] Deployment(default) is successfully updated.
    [INFO] Deployment Status: Running
    [INFO]   InstanceName:demo-default-x-xxxxxxxxxx-xxxxx  Status:Running Reason:null       DiscoverStatus:UNREGISTERED
    [INFO] Getting public url of app(demo)...
    [INFO] Application url: https://<your-Azure-Spring-Apps-instance-name>-demo.azuremicroservices.io
    

2. Příprava projektu Spring

Při přípravě projektu postupujte následovně:

  1. Pomocí následujícího příkazu naklonujte ukázkový projekt Spring Boot pro Azure z GitHubu.

    git clone https://github.com/spring-guides/gs-spring-boot-for-azure.git
    
  2. Pomocí následujícího příkazu přejděte do složky projektu:

    cd gs-spring-boot-for-azure/complete
    
  3. K sestavení projektu použijte následující příkaz Mavenu :

    ./mvnw clean package
    
  4. Spusťte ukázkový projekt místně pomocí následujícího příkazu:

    ./mvnw spring-boot:run
    

3. Příprava cloudového prostředí

Pomocí následujícího postupu vytvořte instanci služby Azure Spring Apps.

3.1. Zadejte názvy jednotlivých prostředků.

Pomocí následujících příkazů vytvořte proměnné pro uložení názvů prostředků. Nezapomeňte zástupné symboly nahradit vlastními hodnotami.

export LOCATION="<region>"
export RESOURCE_GROUP="<resource-group-name>"
export SERVICE_NAME="<Azure-Spring-Apps-instance-name>"
export APP_NAME="demo"

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

Pomocí následujícího postupu vytvořte novou skupinu prostředků:

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

    az login
    
  2. Pomocí následujícího příkazu nastavte výchozí umístění:

    az configure --defaults location=${LOCATION}
    
  3. Pomocí následujícího příkazu zobrazte seznam všech dostupných předplatných a určete ID předplatného, které se má použít:

    az account list --output table
    
  4. K nastavení výchozího předplatného použijte následující příkaz:

    az account set --subscription <subscription-ID>
    
  5. K vytvoření skupiny prostředků použijte následující příkaz:

    az group create --resource-group ${RESOURCE_GROUP}
    
  6. 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 obor názvů: Microsoft.SaaS

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

3.4. 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 nutný jenom v případě, že se vaše předplatné nikdy nepoužilo k vytvoření instance plánu Enterprise služby 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:

    az spring create \
        --name ${SERVICE_NAME} \
        --sku Enterprise
    

3.5. Vytvoření aplikace v instanci Azure Spring Apps

Aplikace je abstrakce jedné obchodní aplikace. Další informace najdete v tématu Aplikace a nasazení v Azure Spring Apps. Aplikace běží v instanci služby Azure Spring Apps, jak je znázorněno na následujícím diagramu.

Diagram znázorňující vztah mezi aplikacemi a instancí služby Azure Spring Apps

Pomocí následujícího příkazu vytvořte aplikaci v Azure Spring Apps:

az spring app create \
    --service ${SERVICE_NAME} \
    --name ${APP_NAME} \
    --assign-endpoint true

4. Nasazení aplikace do Azure Spring Apps

Tato část obsahuje postup nasazení aplikace do Azure Spring Apps.

Pomocí následujícího příkazu nasaďte soubor .jar pro aplikaci:

az spring app deploy \
    --service ${SERVICE_NAME} \
    --name ${APP_NAME} \
    --artifact-path target/demo-0.0.1-SNAPSHOT.jar

Nasazení aplikace může trvat několik minut.

5. Ověření aplikace

Po nasazení máte k aplikaci přístup na adrese https://<your-Azure-Spring-Apps-instance-name>-demo.azuremicroservices.io. Při otevření aplikace se zobrazí odpověď Hello World.

V navigačním podokně na stránce přehledu instance Azure Spring Apps vyberte Protokoly a zkontrolujte protokoly aplikace.

Snímek obrazovky Azure Portal se stránkou Azure Spring Apps Logs (Protokoly služby Azure Spring Apps)

Pomocí následujícího příkazu zkontrolujte protokol aplikace a prošetřete všechny problémy s nasazením:

az spring app logs \
    --service ${SERVICE_NAME} \
    --name ${APP_NAME}

6. Vyčištění prostředků

Nezapomeňte odstranit prostředky, které jste vytvořili v tomto článku, pokud je už nepotřebujete. Pokud chcete prostředky odstranit, stačí odstranit skupinu prostředků, která je obsahuje. Skupinu prostředků můžete odstranit pomocí Azure Portal. Pokud chcete skupinu prostředků odstranit pomocí Azure CLI, použijte následující příkaz:

az group delete --name ${RESOURCE_GROUP}

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ího postupu odstraňte celou skupinu prostředků, včetně nově vytvořené služby:

  1. Vyhledejte skupinu prostředků na webu Azure Portal. V navigační nabídce vyberte Skupiny prostředků. Pak vyberte název skupiny prostředků , například myresourcegroup.

  2. Na stránce vaší skupiny prostředků vyberte Odstranit. Do textového pole zadejte název vaší skupiny prostředků, abyste potvrdili odstranění – například myresourcegroup – a pak vyberte Odstranit.

7. Další kroky

Další informace najdete v následujících článcích: