Az Azure Container Apps üzembe helyezése az az containerapp up paranccsal
A az containerapp up
(vagy up
) paranccsal helyezhet üzembe alkalmazásokat az Azure Container Appsben meglévő rendszerképből, helyi forráskódból vagy GitHub-adattárból. Ezzel az egyetlen paranccsal percek alatt üzembe helyezheti és futtathatja a tárolóalkalmazást.
A az containerapp up
parancs leegyszerűsített módja annak, hogy olyan tárolóalkalmazásokat hozzon létre és telepítsen, amelyek elsősorban az alapértelmezett beállításokat használják. A speciálisabb beállítások konfigurálásához azonban más CLI-parancsokat kell futtatnia:
- Dapr:
az containerapp dapr enable
- Titkok:
az containerapp secret set
- Átviteli protokollok:
az containerapp ingress update
A tárolóalkalmazás erőforrás- vagy méretezési beállításainak testreszabásához használja a up
parancsot, majd a parancsot a az containerapp update
beállítások módosításához. A az containerapp up
parancs nem a parancs rövidítése az containerapp update
.
A up
parancs létrehozhat vagy használhat meglévő erőforrásokat, például:
- Erőforráscsoport
- Azure Container Registry
- Container Apps-környezet és Log Analytics-munkaterület
- A tárolóalkalmazás
A parancs létrehozhat és leküldhet egy tárolórendszerképet egy Azure Container Registrybe (ACR), ha helyi forráskódot vagy GitHub-adattárat ad meg. Amikor Egy GitHub-adattárból dolgozik, az létrehoz egy GitHub Actions-munkafolyamatot, amely automatikusan létrehoz és leküld egy új tárolórendszerképet a GitHub-adattár módosításainak véglegesítésekor.
Ha testre kell szabnia a Container Apps-környezetet, először hozza létre a környezetet a az containerapp env create
paranccsal. Ha nem biztosít meglévő környezetet, a up
parancs az erőforráscsoportban keres egyet, és ha megtalálható, akkor ezt a környezetet használja. Ha nem található, egy Log Analytics-munkaterülettel rendelkező környezetet hoz létre.
A parancsról és annak az containerapp up
beállításairól további információt a következő témakörben talál az containerapp up
: .
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 | Ha GitHub-adattárat használ, regisztráljon ingyenesen. |
Azure CLI | Telepítse az Azure CLI-t. |
Helyi forráskód | Ha helyi forráskódot használ, rendelkeznie kell egy helyi forráskódkönyvtárral. |
Meglévő rendszerkép | Ha meglévő lemezképet használ, szüksége lesz a beállításjegyzék-kiszolgálóra, a rendszerkép nevére és címkéjére. Ha magánregisztrációs adatbázist használ, szüksége lesz a hitelesítő adataira. |
Beállítás
Jelentkezzen be az Azure-ba az Azure CLI-vel.
az login
Ezután telepítse az Azure Container Apps bővítményt a parancssori felülethez.
az extension add --name containerapp --upgrade
Az aktuális bővítmény vagy modul telepítése után regisztrálja a
Microsoft.App
névteret.az provider register --namespace Microsoft.App
Regisztrálja a szolgáltatót
Microsoft.OperationalInsights
az Azure Monitor Log Analytics-munkaterületen.az provider register --namespace Microsoft.OperationalInsights
Üzembe helyezés meglévő lemezképből
Üzembe helyezhet egy olyan tárolóalkalmazást, amely meglévő lemezképet használ egy nyilvános vagy privát tárolóregisztrációs adatbázisban. Ha magánregisztrációs adatbázisból telepíti az üzembe helyezést, meg kell adnia a hitelesítő adatait a , --registry-username
és --registry-password
a --registry-server
beállítások használatával.
Ebben a példában a az containerapp up
parancs a következő műveleteket hajtja végre:
- Létrehoz egy erőforráscsoportot.
- Létrehoz egy környezetet és egy Log Analytics-munkaterületet.
- Létrehoz és üzembe helyez egy tárolóalkalmazást, amely lekéri a rendszerképet egy nyilvános beállításjegyzékből.
- Beállítja a tárolóalkalmazás bejövő forgalmát külsőre, a célport pedig a megadott értékre van állítva.
Futtassa a következő parancsot egy tárolóalkalmazás meglévő lemezképből való üzembe helyezéséhez. Cserélje le a <HELYŐRZŐket> az értékekre.
az containerapp up \
--name <CONTAINER_APP_NAME> \
--image <REGISTRY_SERVER>/<IMAGE_NAME>:<TAG> \
--ingress external \
--target-port <PORT_NUMBER>
A parancs használatával up
újra üzembe helyezhet egy tárolóalkalmazást. Ha új lemezképet szeretne újból üzembe helyezni, a beállítással --image
adjon meg egy új képet. Győződjön meg arról, hogy a beállítások és environment
a --resource-group
beállítások ugyanazokra az értékekre vannak beállítva, mint az eredeti üzembe helyezés.
az containerapp up \
--name <CONTAINER_APP_NAME> \
--image <REGISTRY_SERVER>/<IMAGE_NAME>:<TAG> \
--resource-group <RESOURCE_GROUP_NAME> \
--environment <ENVIRONMENT_NAME> \
--ingress external \
--target-port <PORT_NUMBER>
Üzembe helyezés helyi forráskódból
Ha a up
parancsot helyi forrásból telepíti, az létrehozza a tárolórendszerképet, leküldi azt egy beállításjegyzékbe, és üzembe helyezi a tárolóalkalmazást. Ha nem ad meg egyet, létrehozza a beállításjegyzéket az Azure Container Registryben.
A parancs Docker-fájllal vagy anélkül is létrehozhatja a lemezképet. Ha Dockerfile nélkül készít, a következő nyelvek támogatottak:
- .NET
- Node.js
- PHP
- Python
Az alábbi példa bemutatja, hogyan helyezhet üzembe egy tárolóalkalmazást a helyi forráskódból.
A példában a az containerapp up
parancs a következő műveleteket hajtja végre:
- Létrehoz egy erőforráscsoportot.
- Létrehoz egy környezetet és egy Log Analytics-munkaterületet.
- Létrehoz egy beállításjegyzéket az Azure Container Registryben.
- Létrehozza a tárolórendszerképet (ha létezik, a Dockerfile használatával).
- Leküldi a rendszerképet a beállításjegyzékbe.
- Létrehozza és üzembe helyezi a tárolóalkalmazást.
Futtassa a következő parancsot egy tárolóalkalmazás helyi forráskódból történő üzembe helyezéséhez:
az containerapp up \
--name <CONTAINER_APP_NAME> \
--source <SOURCE_DIRECTORY>\
--ingress external
Ha a Dockerfile tartalmazza az EXPOSE utasítást, a parancs konfigurálja up
a tárolóalkalmazás bejövő és célportját a Dockerfile információi alapján.
Ha a Docker-fájlon keresztül konfigurálja a bejövő forgalmat, vagy az alkalmazás nem igényel bejövő forgalmat, kihagyhatja a ingress
beállítást.
A parancs kimenete tartalmazza a tárolóalkalmazás URL-címét.
Hiba esetén újra futtathatja a parancsot, --debug
ha további információt szeretne kapni a hibáról. Ha a build dockerfile nélkül meghiúsul, megpróbálhat hozzáadni egy Dockerfile-t, és újra futtatni a parancsot.
Ha a az containerapp up
parancs használatával szeretné újból üzembe helyezni a tárolóalkalmazást egy frissített rendszerképpel, adja meg az argumentumokat és --environment
az --resource-group
argumentumokat. Az alábbi példa bemutatja, hogyan helyezhet üzembe újra egy tárolóalkalmazást a helyi forráskódból.
Módosítsa a forráskódot.
Futtassa az alábbi parancsot:
az containerapp up \ --name <CONTAINER_APP_NAME> \ --source <SOURCE_DIRECTORY> \ --resource-group <RESOURCE_GROUP_NAME> \ --environment <ENVIRONMENT_NAME>
Üzembe helyezés GitHub-adattárból
Amikor a az containerapp up
parancsot egy GitHub-adattárból telepíti, az létrehoz egy GitHub Actions-munkafolyamatot, amely létrehozza a tárolólemezképet, leküldi azt egy beállításjegyzékbe, és üzembe helyezi a tárolóalkalmazást. A parancs létrehozza a beállításjegyzéket az Azure Container Registryben, ha nem ad meg egyet.
A rendszerkép létrehozásához Dockerfile szükséges. Ha a Dockerfile tartalmazza az EXPOSE utasítást, a parancs konfigurálja a tárolóalkalmazás bejövő és célportját a Dockerfile információi alapján.
Az alábbi példa bemutatja, hogyan helyezhet üzembe egy tárolóalkalmazást egy GitHub-adattárból.
A példában a az containerapp up
parancs a következő műveleteket hajtja végre:
- Létrehoz egy erőforráscsoportot.
- Létrehoz egy környezetet és egy Log Analytics-munkaterületet.
- Létrehoz egy beállításjegyzéket az Azure Container Registryben.
- A tárolórendszerképet a Dockerfile használatával hozza létre.
- Leküldi a rendszerképet a beállításjegyzékbe.
- Létrehozza és üzembe helyezi a tárolóalkalmazást.
- Létrehoz egy GitHub Actions-munkafolyamatot a tárolórendszerkép létrehozásához és a tárolóalkalmazás üzembe helyezéséhez, amikor a jövőbeli módosítások le lesznek küldve a GitHub-adattárba.
Ha gitHub-adattárból szeretne üzembe helyezni egy alkalmazást, futtassa a következő parancsot:
az containerapp up \
--name <CONTAINER_APP_NAME> \
--repo <GitHub repository URL> \
--ingress external
Ha a Docker-fájlon keresztül konfigurálja a bejövő forgalmat, vagy az alkalmazás nem igényel bejövő forgalmat, kihagyhatja a ingress
beállítást.
Mivel a up
parancs létrehoz egy GitHub Actions-munkafolyamatot, az alkalmazás lemezképének módosításainak újrafuttatása nemkívánatos hatással van arra, hogy több munkafolyamatot hozzon létre. Ehelyett leküldheti a módosításokat a GitHub-adattárba, és a GitHub-munkafolyamat automatikusan létrehozza és üzembe helyezi az alkalmazást. A munkafolyamat módosításához szerkessze a munkafolyamat-fájlt a GitHubon.