Rövid útmutató: Helyi forráskód létrehozása és üzembe helyezése az Azure Container Appsben
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 nyelv használatával. 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 tekintse meg az Azure-szerepkörök hozzárendelését az Azure Portalon . |
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 az Azure Container Apps bővítményt a parancssori felülethez.
az extension add --name containerapp --upgrade --allow-preview true
Az aktuális bővítmény 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 a parancssori felület beállítása befejeződött, definiálhatja a cikkben használt környezeti változókat. 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-rendszerhéjban.
export RESOURCE_GROUP="album-containerapps"
export LOCATION="canadacentral"
export ENVIRONMENT="env-album-containerapps"
export API_NAME="album-api"
A mintakód letöltése
Az alábbi paranccsal klónozhatja a mintaalkalmazást a választott nyelven, és átválthat 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
Az első tárolóalkalmazás létrehozása és üzembe helyezése a containerapp up
paranccsal. Ez a parancs a következő lesz:
- Az erőforráscsoport létrehozása
- Azure Container Registry-adatbázis létrehozása
- A tárolórendszerkép létrehozása és leküldése 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 a beépített tárolórendszerkép használatával
A up
parancs a Projekt mappá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 hibaüzenetet 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úllépi a korlátot, a rendszer a 413-at adja vissza.
Az erőforrások eltávolítása
Ha nem folytatja az előtérbeli oktatóanyag üzembe helyezését, az alábbi paranccsal eltávolíthatja az ebben a rövid útmutatóban 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, akkor 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ések
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ér-alkalmazást.