Sdílet prostřednictvím

Nastavení přípravného prostředí v Azure Spring Apps

Poznámka:

Plány Basic, Standarda Enterprise vstoupily do důchodového období 17. března 2025. Další informace najdete v oznámení o vyřazení Azure Spring Apps.

Plán Standardní spotřeba a vyhrazený plán vstoupily do fáze vyřazování dne 30. září 2024 s úplným vypnutím do konce března 2025. Další informace najdete v tématu Migrace spotřeby Azure Spring Apps Standard a vyhrazeného plánu do Azure Container Apps.

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

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

Tento článek vysvětluje, jak nastavit přípravné nasazení pomocí vzoru modrého zeleného nasazení v Azure Spring Apps. Modré a zelené nasazení je model průběžného doručování Azure DevOps, který spoléhá na zachování stávající (modré) verze v provozu, zatímco je nasazená nová (zelená). Tento článek vám ukáže, jak převést přípravné nasazení do produkčního prostředí, aniž byste měnili stávající produkční nasazení.

Požadavky

Tento článek používá aplikaci vytvořenou z Aplikace Spring Initializr. Pokud chcete pro tento příklad použít jinou aplikaci, proveďte změnu ve veřejné části aplikace, abyste odlišili přípravné nasazení od produkčního nasazení.

Tip

Azure Cloud Shell je bezplatné interaktivní prostředí, které můžete použít ke spuštění pokynů v tomto článku. Obsahuje běžné předinstalované nástroje Azure, včetně nejnovějších verzí Gitu, JDK, Mavenu a Azure CLI. Pokud jste přihlášení ke svému předplatnému Azure, spusťte instanci Cloud Shellu. Další informace najdete v tématu Přehled služby Azure Cloud Shell.

Pokud chcete v Azure Spring Apps nastavit modré zelené nasazení, postupujte podle pokynů v dalších částech.

Instalace rozšíření Azure CLI

Pomocí následujícího příkazu nainstalujte rozšíření Azure Spring Apps pro Azure CLI:

az extension add --name spring

Příprava aplikace a nasazení

Pokud chcete sestavit aplikaci, postupujte takto:

  1. Vygenerujte kód ukázkové aplikace pomocí aplikace Spring Initializr s touto konfigurací.

  2. Stáhněte si kód.

  3. Do složky **\src\main\java\com\example\hellospring**přidejte následující zdrojový soubor HelloController.java :

    package com.example.hellospring;
import org.springframework.web.bind.annotation.RestController;
import org.springframework.web.bind.annotation.RequestMapping;

@RestController

public class HelloController {

@RequestMapping("/")

  public String index() {
      return "Greetings from Azure Spring Apps!";
  }

}

  4. Sestavte soubor .jar:

    mvn clean package -DskipTests

  5. Vytvořte aplikaci v instanci Azure Spring Apps:

    az spring app create \
    --resource-group <resource-group-name> \
    --service <Azure-Spring-Apps-instance-name> \
    --name demo \
    --runtime-version Java_17 \
    --assign-endpoint

  6. Nasazení aplikace do Azure Spring Apps:

    az spring app deploy \
    --resource-group <resource-group-name> \
    --service <Azure-Spring-Apps-instance-name> \
    --name demo \
    --artifact-path target\hellospring-0.0.1-SNAPSHOT.jar

  7. Upravte kód pro přípravné nasazení:

    package com.example.hellospring;
import org.springframework.web.bind.annotation.RestController;
import org.springframework.web.bind.annotation.RequestMapping;

@RestController

public class HelloController {

@RequestMapping("/")

  public String index() {
      return "Greetings from Azure Spring Apps! THIS IS THE GREEN DEPLOYMENT";
  }

}

  8. Znovu sestavte soubor .jar :

    mvn clean package -DskipTests

  9. Vytvořte zelené nasazení:

    az spring app deployment create \
    --resource-group <resource-group-name> \
    --service <Azure-Spring-Apps-instance-name> \
    --app demo \
    --name green \
    --runtime-version Java_17 \
    --artifact-path target\hellospring-0.0.1-SNAPSHOT.jar

Zobrazení aplikací a nasazení

K zobrazení nasazených aplikací použijte následující postup.

  1. Na webu Azure Portal přejděte ke své instanci Azure Spring Apps.

  2. V navigačním podokně otevřete podokno Aplikace a zobrazte aplikace pro vaši instanci služby.

    Snímek obrazovky s podoknem Aplikace zobrazující aplikace pro vaši instanci služby

  3. Výběrem aplikace zobrazíte podrobnosti.

    Snímek obrazovky ukázkové aplikace, která zobrazuje stránku Přehled s dostupnými nastaveními

  4. Otevřete Nasazení a zobrazte všechna nasazení aplikace. Mřížka zobrazuje produkční i přípravná nasazení.

    Snímek obrazovky s uvedením nasazení aplikací

  5. Výběrem adresy URL otevřete aktuálně nasazenou aplikaci.

    Snímek obrazovky znázorňující adresu URL nasazené aplikace

  6. Výběrem Produkce ve sloupci Stav zobrazíte výchozí aplikaci.

    Snímek obrazovky znázorňující adresu URL výchozí aplikace

  7. Vyberte Příprava ve sloupci Stav a zobrazte staging aplikaci.

    Snímek obrazovky s adresou URL přípravné aplikace.

Tip

Ověřte, že váš testovací koncový bod končí lomítkem (/), aby se zajistilo správné načtení souboru CSS. Pokud váš prohlížeč vyžaduje, abyste zadali přihlašovací údaje k zobrazení stránky, použijte dekódování adresy URL k dekódování testovacího koncového bodu. Dekódování adresy URL vrátí adresu URL ve formátu https://\<username>:\<password>@\<cluster-name>.test.azuremicroservices.io/demo/green. Tento formát použijte pro přístup ke koncovému bodu. Pokud chcete zakázat základní ověřování pro testovací koncový bod, spusťte následující příkaz Azure CLI: az spring app update --resource-group <resource-group-name> --service <Azure-Spring-Apps-instance-name> --name demo --disable-test-endpoint-auth true

Poznámka:

Nastavení konfiguračního serveru platí pro přípravné i produkční prostředí. Pokud například nastavíte cestu kontextu (server.servlet.context-path) pro ukázku aplikace na konfiguračním serveru jako somepath, cesta k zelenému nasazení se změní na https://\<username>:\<password>@\<cluster-name>.test.azuremicroservices.io/demo/green/somepath/....

Pokud v tuto chvíli navštívíte ukázku veřejné aplikace, měla by se zobrazit stará stránka bez nové změny.

Nastavte zelené nasazení jako produkční prostředí

  1. Po ověření změny v přípravném prostředí ji můžete odeslat do produkčního prostředí. > vyberte aplikaci aktuálně v produkčním prostředí.

  2. Vyberte ikonu se třemi tečkami po stavu registrace zeleného nasazení a pak vyberte Nastavit jako produkční prostředí.

    Snímek obrazovky znázorňující výběry pro nastavení přípravného sestavení do produkčního prostředí

  3. Potvrďte, že adresa URL aplikace zobrazuje vaše změny.

    Snímek obrazovky znázorňující adresu URL aplikace v produkčním prostředí

Poznámka:

Po nastavení zeleného nasazení jako produkčního prostředí se z předchozího nasazení stane přípravné nasazení.

Úprava přípravného nasazení

Pokud se změnou nejste spokojeni, můžete upravit kód aplikace, vytvořit nový balíček .jar a nahrát ho do zeleného nasazení pomocí Azure CLI:

az spring app deploy \
    --resource-group <resource-group-name> \
    --service <service-instance-name> \
    --name demo \
    --deployment green \
    --artifact-path demo.jar

Odstraňte přípravné nasazení

Pokud chcete odstranit své staging nasazení z Azure portálu, přejděte na stránku pro vaše staging nasazení a vyberte tlačítko Odstranit.

Případně odstraňte přípravné nasazení z Azure CLI spuštěním následujícího příkazu:

az spring app deployment delete \
    --resource-group <resource-group-name> \
    --service <service-instance-name> \
    --name <staging-deployment-name> \
    --app demo

Další kroky