Megjegyzés
Az oldalhoz való hozzáféréshez engedély szükséges. Megpróbálhat bejelentkezni vagy módosítani a címtárat.
Az oldalhoz való hozzáféréshez engedély szükséges. Megpróbálhatja módosítani a címtárat.
Ez a cikk bemutatja, hogyan hozhat létre és helyezhet üzembe mikroszolgáltatást az Azure Container Appsben helyi forráskódból a választott programozási nyelven. Ebben a rövid útmutatóban létrehoz egy háttérbeli webes API-szolgáltatást, amely zenei albumok statikus gyűjteményét adja vissza.
Az alábbi képernyőképen az üzembe helyezhető album API-szolgáltatás kimenete látható.
Előfeltételek
A projekt végrehajtásához a következő elemekre van szüksége:
| 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 lásd : Azure-szerepkörök hozzárendelése az Azure Portal használatával . |
| Git | A Git telepítése. |
| Azure CLI | Telepítse az Azure CLI-t. |
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 a parancssori felület Container Apps bővítményét:
az extension add --name containerapp --upgrade --allow-preview true
Az aktuális bővítmény telepítése után regisztrálja a Microsoft.App és Microsoft.OperationalInsights névteret.
az provider register --namespace Microsoft.App
az provider register --namespace Microsoft.OperationalInsights
Környezeti változók létrehozása
Most, hogy a parancssori felület beállítása befejeződött, definiálhatja a cikkben használt környezeti változókat.
Adja meg a következő változókat a Bash parancsértelmezőben:
export RESOURCE_GROUP="album-containerapps"
export LOCATION="canadacentral"
export ENVIRONMENT="env-album-containerapps"
export API_NAME="album-api"
A mintakód letöltése
Futtassa a következő parancsot a mintaalkalmazás klónozásához a választott nyelven, és váltson a projekt forrásmappájára:
git clone https://github.com/azure-samples/containerapps-albumapi-csharp.git
cd containerapps-albumapi-csharp/src
A tárolóalkalmazás létrehozása és üzembe helyezése
Először futtassa a következő parancsot az ebben a rövid útmutatóban létrehozott erőforrásokat tartalmazó erőforráscsoport létrehozásához.
az group create --name $RESOURCE_GROUP --location $LOCATION
Hozza létre és telepítse az első tárolóalkalmazást a containerapp up parancs használatával. Ez a parancs:
- Létrehozza az erőforráscsoportot.
- Létrehoz egy tárolóregisztrációs adatbázis-erőforrást.
- Létrehozza a tárolórendszerképet, és leküldi a beállításjegyzékbe.
- Létrehozza a Container Apps-környezetet egy Log Analytics-munkaterülettel.
- Létrehozza és üzembe helyezi a tárolóalkalmazást a beépített tárolórendszerkép használatával.
A up parancs a projektmappában lévő Dockerfile használatával hozza létre a tárolólemezképet. A EXPOSE Dockerfile utasítása meghatározza a célportot, amely a tárolóba irányuló bejövő forgalom küldéséhez használt port.
A következő kódpéldában a . (pont) azt jelzi containerapp up , hogy a dockerfile-t is tartalmazó projekt aktuális könyvtárában fut.
az containerapp up \
--name $API_NAME \
--resource-group $RESOURCE_GROUP \
--location $LOCATION \
--environment $ENVIRONMENT \
--source .
Feljegyzés
Ha a parancs a "AADSTS50158: Külső biztonsági kihívás nem teljesül" üzenettel kapcsolatos hibát ad vissza, futtassa az login --scope https://graph.microsoft.com//.default a szükséges engedélyekkel való bejelentkezéshez, majd futtassa újra a az containerapp up parancsot.
Az üzembe helyezés ellenőrzése
Keresse meg a tárolóalkalmazás URL-címét a az containerapp up parancs kimenetében. Keresse meg az URL-címet a böngészőben. Adja hozzá /albums az URL-cím végéhez az API válaszának megtekintéséhez.
Korlátok
A forráskód feltöltésének maximális mérete 200 MB. Ha a feltöltés túl nagy, a rendszer a 413-at adja vissza.
Az erőforrások tisztítása
Ha nem folytatja az előtérbeli oktatóanyag üzembe helyezését , az alábbi paranccsal eltávolíthatja a rövid útmutató során létrehozott Azure-erőforrásokat.
Figyelemfelhívás
Az alábbi parancs törli a megadott erőforráscsoportot és a benne lévő összes erőforrást. Ha a csoport a rövid útmutató hatókörén kívül eső erőforrásokat is tartalmaz, azok is törlődnek.
az group delete --name $RESOURCE_GROUP
Tipp.
Problémákat tapasztal? Tudassa velünk a GitHubon, ha megnyit egy hibát az Azure Container Apps adattárában.
Következő lépés
A rövid útmutató elvégzése után folytathatja a következő oktatóanyagot: Az Azure Container Apps mikroszolgáltatásainak kommunikációja , amelyből megtudhatja, hogyan helyezhet üzembe egy api-t meghívó előtérbeli alkalmazást.