Sdílet prostřednictvím

Rychlý start: Nasazení souboru artefaktu do Azure Container Apps (Preview)

  • Článek

V tomto rychlém startu se naučíte nasadit aplikaci kontejneru z předem připraveného souboru artefaktů. Příklad v tomto článku nasadí aplikaci Java pomocí souboru JAR, který obsahuje soubor manifestu specifický pro Javu. Vaším úkolem je vytvořit back-endovou webovou službu API, která vrací statickou kolekci hudebních alb. Po dokončení tohoto rychlého startu můžete pokračovat ve komunikaci mezi mikroslužbami a zjistit, jak nasadit front-endovou aplikaci, která volá rozhraní API.

Následující snímek obrazovky ukazuje výstup ze služby rozhraní API alba, kterou nasadíte.

Snímek obrazovky s odpovědí z koncového bodu rozhraní API alb

Požadavky

Požadavek Pokyny
Účet Azure Pokud ho nemáte, vytvořte si účet zdarma. K pokračování potřebujete oprávnění přispěvatele nebo vlastníka předplatného Azure.

Podrobnosti najdete v tématu Přiřazení rolí Azure pomocí webu Azure Portal .
Účet GitHubu Získejte ho zdarma.
git Instalace Gitu
Azure CLI Nainstalujte rozhraní příkazového řádku Azure CLI.
Java Instalace sady JDK, doporučená verze 17 nebo novější
Maven Nainstalujte Maven.

Nastavení

Pokud se chcete přihlásit k Azure z rozhraní příkazového řádku, spusťte následující příkaz a podle pokynů dokončete proces ověřování.

az login

Pokud chcete zajistit, že používáte nejnovější verzi rozhraní příkazového řádku, spusťte příkaz upgrade.

az upgrade

Dále nainstalujte nebo aktualizujte rozšíření Azure Container Apps pro rozhraní příkazového řádku.

Pokud se při spouštění az containerapp příkazů v Azure CLI nebo rutinách Az.App z modulu v Azure PowerShellu zobrazí chyby týkající se chybějících parametrů, ujistěte se, že máte nainstalovanou nejnovější verzi rozšíření Azure Container Apps.

az extension add --name containerapp --upgrade

Poznámka:

Od května 2024 už rozšíření Azure CLI ve výchozím nastavení nepovolují funkce ve verzi Preview. Pokud chcete získat přístup k funkcím Container Apps ve verzi Preview, nainstalujte rozšíření Container Apps pomocí --allow-preview truenástroje .

az extension add --name containerapp --upgrade --allow-preview true

Teď, když je nainstalované aktuální rozšíření nebo modul, zaregistrujte obory Microsoft.App názvů a Microsoft.OperationalInsights obory názvů.

az provider register --namespace Microsoft.App

az provider register --namespace Microsoft.OperationalInsights

Vytvoření proměnných prostředí

Po dokončení nastavení Azure CLI můžete definovat proměnné prostředí, které se používají v tomto článku.

Definujte následující proměnné v prostředí Bash.

RESOURCE_GROUP="album-containerapps"
LOCATION="canadacentral"
ENVIRONMENT="env-album-containerapps"
API_NAME="album-api"
SUBSCRIPTION=<YOUR_SUBSCRIPTION_ID>

V případě potřeby můžete zadat dotaz na ID předplatného.

az account list --output table

Příprava úložiště GitHub

Začněte klonováním ukázkového úložiště.

Pomocí následujícího příkazu Git naklonujte ukázkovou aplikaci do složky code-to-cloud :

git clone https://github.com/azure-samples/containerapps-albumapi-java code-to-cloud

cd code-to-cloud

Vytvoření souboru JAR

Poznámka:

Ukázka v Javě podporuje pouze sestavení Maven, které má za následek spustitelný soubor JAR. Sestavení používá výchozí nastavení, protože předávání proměnných prostředí není podporováno.

Sestavte projekt pomocí Mavenu.

mvn clean package -DskipTests

Spusťte projekt lokálně.

java -jar target\containerapps-albumapi-java-0.0.1-SNAPSHOT.jar

Pokud chcete ověřit, že je aplikace spuštěná, otevřete prohlížeč a přejděte na http://localhost:8080/albums. Stránka vrátí seznam objektů JSON.

Nasazení artefaktu

Pomocí příkazu sestavte a nasaďte svou první aplikaci kontejneru z místního souboru containerapp up JAR.

Tento příkaz:

  • Vytvoří skupinu prostředků.
  • Vytvoří službu Azure Container Registry.
  • Vytvoří image kontejneru a odešle ji do registru.
  • Vytvoří prostředí Container Apps s pracovním prostorem služby Log Analytics.
  • Vytvoří a nasadí aplikaci kontejneru pomocí veřejné image kontejneru.

Příkaz up k sestavení image kontejneru používá soubor Dockeru v kořenovém adresáři úložiště. Instrukce EXPOSE v souboru Dockeru definuje cílový port. K sestavení aplikace kontejneru ale není potřeba soubor Dockeru.

Poznámka:

Poznámka: Při použití containerapp up v kombinaci se základem kódu bez Dockeru --location použijte parametr tak, aby aplikace běžela v jiném umístění než USA – východ.

az containerapp up \
  --name $API_NAME \
  --resource-group $RESOURCE_GROUP \
  --location $LOCATION \
  --environment $ENVIRONMENT \
  --artifact ./target/containerapps-albumapi-java-0.0.1-SNAPSHOT.jar \
  --ingress external \
  --target-port 8080 \
  --subscription $SUBSCRIPTION

Ověření nasazení

Zkopírujte plně kvalifikovaný název domény do webového prohlížeče. Ve webovém prohlížeči přejděte na /albums koncový bod plně kvalifikovaného názvu domény.

Snímek obrazovky s odpovědí z koncového bodu rozhraní API alb

Nasazení souboru WAR

Aplikaci kontejneru můžete také nasadit ze souboru WAR.

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

Pokud tuto aplikaci nebudete dál používat, můžete odstranit instanci Azure Container Apps a všechny přidružené služby odebráním skupiny prostředků.

Prostředky, které jste vytvořili, odeberte takto:

az group delete \
  --resource-group $RESOURCE_GROUP

Tip

Máte problémy? Dejte nám vědět na GitHubu otevřením problému v úložišti Azure Container Apps.

Další kroky

Další informace o vývoji v Javě v Container Apps