Rövid útmutató: Összetevőfájl üzembe helyezése az Azure Container Appsben (előzetes verzió)
Ebben a rövid útmutatóban megismerheti, hogyan helyezhet üzembe egy tárolóalkalmazást egy előre összeállított összetevőfájlból. A cikkben szereplő példa egy Java-alkalmazást helyez üzembe JAR-fájllal, amely egy Java-specifikus jegyzékfájlt is tartalmaz. A feladat egy háttérbeli webes API-szolgáltatás létrehozása, amely zenei albumok statikus gyűjteményét adja vissza. A rövid útmutató elvégzése után folytathatja a mikroszolgáltatások közötti kommunikációt, hogy megtudja, hogyan helyezhet üzembe egy API-t meghívó előtér-alkalmazást.
Az alábbi képernyőképen az üzembe helyezhető album API-szolgáltatás kimenete látható.
Előfeltételek
| Követelmény | Utasítások |
|---|---|
| Azure-fiók | Ha nem rendelkezik ilyen fiókkal, hozzon létre ingyenes fiókot. A folytatáshoz az Azure-előfizetés közreműködői vagy tulajdonosi engedélyére van szüksége. Részletekért tekintse meg az Azure-szerepkörök hozzárendelését az Azure Portalon . |
| GitHub-fiók | Szerezz egyet ingyen. |
| git | Git telepítése |
| Azure CLI | Telepítse az Azure CLI-t. |
| Java | Telepítse a JDK-t, javasolja a 17-et vagy újabb verziót |
| Maven | Telepítse a Mavent. |
Beállítás
Ha a parancssori felületről szeretne bejelentkezni az Azure-ba, futtassa a következő parancsot, és kövesse az utasításokat a hitelesítési folyamat befejezéséhez.
az login
A parancssori felület legújabb verziójának futtatásához futtassa a frissítési parancsot.
az upgrade
Ezután telepítse vagy frissítse az Azure Container Apps bővítményt a parancssori felülethez.
Ha hibaüzenetet kap a hiányzó paraméterekről, amikor parancsokat futtat az Azure CLI-ben, vagy parancsmagokat futtat az containerapp az Az.App Azure PowerShell modulból, győződjön meg arról, hogy telepítve van az Azure Container Apps bővítmény legújabb verziója.
az extension add --name containerapp --upgrade
Feljegyzés
2024 májusától kezdődően az Azure CLI-bővítmények alapértelmezés szerint nem engedélyezik az előzetes verziójú funkciókat. A Container Apps előzetes verziójú funkcióinak eléréséhez telepítse a Container Apps bővítményt a következővel --allow-preview true: .
az extension add --name containerapp --upgrade --allow-preview true
Az aktuális bővítmény vagy modul telepítése után regisztrálja a névtereket és Microsoft.OperationalInsights a Microsoft.App névtereket.
az provider register --namespace Microsoft.App
az provider register --namespace Microsoft.OperationalInsights
Környezeti változók létrehozása
Most, hogy az Azure CLI beállítása befejeződött, meghatározhatja a jelen cikkben használt környezeti változókat.
Adja meg a következő változókat a bash-rendszerhéjban.
RESOURCE_GROUP="album-containerapps"
LOCATION="canadacentral"
ENVIRONMENT="env-album-containerapps"
API_NAME="album-api"
SUBSCRIPTION=<YOUR_SUBSCRIPTION_ID>
Szükség esetén lekérdezheti az előfizetés azonosítóját.
az account list --output table
A GitHub-adattár előkészítése
Először klónozza a mintaadattárat.
A mintaalkalmazást a következő Git-paranccsal klónozza a kód–felhő mappába:
git clone https://github.com/azure-samples/containerapps-albumapi-java code-to-cloud
cd code-to-cloud
JAR-fájl létrehozása
Feljegyzés
A Java-minta csak egy Maven-buildet támogat, amely végrehajtható JAR-fájlt eredményez. A build alapértelmezett beállításokat használ, mivel a környezeti változók átadása nem támogatott.
Készítse el a projektet a Mavennel.
mvn clean package -DskipTests
A projekt helyi futtatása
java -jar target\containerapps-albumapi-java-0.0.1-SNAPSHOT.jar
Az alkalmazás futásának ellenőrzéséhez nyisson meg egy böngészőt, és nyissa meg az http://localhost:8080/albumsalkalmazást. A lap a JSON-objektumok listáját adja vissza.
Az összetevő üzembe helyezése
Hozza létre és telepítse az első tárolóalkalmazást a helyi JAR-fájlból a containerapp up paranccsal.
A parancs a következőket hajtja végre:
- Létrehozza az erőforráscsoportot
- Azure Container Registry létrehozása
- Létrehozza a tárolórendszerképet, és leküldi a beállításjegyzékbe
- A Container Apps-környezet létrehozása Log Analytics-munkaterülettel
- A tárolóalkalmazás létrehozása és üzembe helyezése nyilvános tárolórendszerkép használatával
A up parancs az adattár gyökerében található Docker-fájlt használja a tárolólemezkép létrehozásához. A EXPOSE Docker-fájl utasításai határozzák meg a célportot. A Tárolóalkalmazás létrehozásához azonban nincs szükség Docker-fájlra.
Feljegyzés
Megjegyzés: Ha docker-less kódbázissal kombinálva használja containerapp up , használja a paramétert, hogy az --location alkalmazás az USA keleti régiójától eltérő helyen fusson.
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
Az üzembe helyezés ellenőrzése
Másolja a teljes tartománynevet egy webböngészőbe. A webböngészőben lépjen a /albums teljes tartománynév végpontjára.
WAR-fájl üzembe helyezése
A tárolóalkalmazást WAR-fájlból is üzembe helyezheti.
Az erőforrások eltávolítása
Ha nem fogja tovább használni ezt az alkalmazást, az erőforráscsoport eltávolításával törölheti az Azure Container Apps-példányt és az összes társított szolgáltatást.
A létrehozott erőforrások eltávolításához kövesse az alábbi lépéseket:
az group delete \
--resource-group $RESOURCE_GROUP
Tipp.
Problémákat tapasztal? Tudassa velünk a GitHubon, ha megnyit egy hibát az Azure Container Apps adattárában.