ACR-feladat futtatása dedikált ügynökkészleten
Állítson be egy Azure által felügyelt virtuálisgép-készletet (ügynökkészletet) a Azure Container Registry feladatok dedikált számítási környezetben való futtatásának engedélyezéséhez. Miután konfigurált egy vagy több készletet a beállításjegyzékben, kiválaszthat egy készletet, amely a szolgáltatás alapértelmezett számítási környezete helyett futtat egy feladatot.
Az ügynökkészlet a következőket biztosítja:
- Virtuális hálózat támogatása – Ügynökkészlet hozzárendelése egy Azure-beli virtuális hálózathoz, amely hozzáférést biztosít a virtuális hálózat erőforrásaihoz, például tárolóregisztrációs adatbázishoz, kulcstartóhoz vagy tárolóhoz.
- Skálázás igény szerint – Növelje az ügynökkészlet példányainak számát a nagy számítási igényű feladatokhoz, vagy skálázzon nullára. A számlázás a készletfoglaláson alapul. További részletekért lásd: Díjszabás.
- Rugalmas lehetőségek – A különböző készletszintek és méretezési lehetőségek közül választhat a tevékenységprofil igényeinek megfelelően.
- Azure-felügyelet – A feladatkészleteket az Azure javítja és karbantartja, és fenntartott foglalást biztosít az egyes virtuális gépek karbantartása nélkül.
Ez a funkció a Prémium szintű tárolóregisztrációs adatbázis szolgáltatási szintjén érhető el. A beállításjegyzék szolgáltatási szintjeiről és korlátairól további információt a Azure Container Registry termékváltozatok című témakörben talál.
Fontos
Ez a funkció jelenleg előzetes verzióban érhető el, és bizonyos korlátozások érvényesek. Az előzetes verziók azzal a feltétellel érhetők el, hogy Ön beleegyezik a kiegészítő használati feltételekbe. A szolgáltatás néhány eleme megváltozhat a nyilvános rendelkezésre állás előtt.
Előzetes verzióra vonatkozó korlátozások
- A feladatügynök-készletek jelenleg támogatják a Linux-csomópontokat. A Windows-csomópontok jelenleg nem támogatottak.
- A feladatügynök-készletek előzetes verzióban érhetők el a következő régiókban: USA 2. nyugati régiója, USA déli középső régiója, USA 2. keleti régiója, USA keleti régiója, USA középső régiója, Nyugat-Európa, Észak-Európa, Közép-Kanada, Kelet-Ázsia, USGov Arizona, USGov Texas és USGov Virginia.
- Minden beállításjegyzék esetében az alapértelmezett teljes vCPU-kvóta (mag) az összes standard ügynökkészlet esetében 16, az izolált ügynökkészletek esetében pedig 0. Nyisson meg egy támogatási kérést a további kiosztáshoz.
- Ügynökkészleten jelenleg nem szakíthatja meg a feladatfuttatást.
Előfeltételek
- A cikkben szereplő Azure CLI-lépések használatához az Azure CLI 2.3.1-es vagy újabb verziójára van szükség. Ha telepíteni vagy frissíteni szeretne: Az Azure CLI telepítése. Vagy futtassa a parancsot az Azure Cloud Shell.
- Ha még nem rendelkezik tárolóregisztrációs adatbázissal, hozzon létre egyet (prémium szint szükséges) egy előzetes verziójú régióban.
Készletszintek
Az ügynökkészlet szintjei példányonként az alábbi erőforrásokat biztosítják a készletben.
Szint | Típus | CPU | Memória (GB) |
---|---|---|---|
S1 | Standard | 2 | 3 |
S2 | Standard | 4 | 8 |
S3 | Standard | 8 | 16 |
I6 | Elszigetelt | 64 | 216 |
Feladatügynök-készlet létrehozása és kezelése
Alapértelmezett beállításjegyzék beállítása (nem kötelező)
A következő Azure CLI-parancsok egyszerűsítése érdekében állítsa be az alapértelmezett beállításjegyzéket az az config parancs futtatásával:
az config set defaults.acr=<registryName>
Az alábbi példák feltételezik, hogy beállította az alapértelmezett beállításjegyzéket. Ha nem, minden parancsban az acr
adjon meg egy --registry <registryName>
paramétert.
Ügynökkészlet létrehozása
Hozzon létre egy ügynökkészletet az az acr agentpool create paranccsal. Az alábbi példa egy S2 szintű készletet hoz létre (4 CPU/példány). A készlet alapértelmezés szerint 1 példányt tartalmaz.
az acr agentpool create \
--registry MyRegistry \
--name myagentpool \
--tier S2
Megjegyzés
Az ügynökkészlet és más készletkezelési műveletek létrehozása több percet vesz igénybe.
Méretezési készlet
Skálázza felfelé vagy lefelé a készlet méretét az az acr agentpool update paranccsal. Az alábbi példa 2 példányra skálázza a készletet. 0 példányra skálázhat.
az acr agentpool update \
--registry MyRegistry \
--name myagentpool \
--count 2
Készlet létrehozása virtuális hálózaton
Tűzfalszabályok hozzáadása
A feladatügynök-készleteknek hozzáférésre van szükségük a következő Azure-szolgáltatásokhoz. A következő tűzfalszabályokat hozzá kell adni minden meglévő hálózati biztonsági csoporthoz vagy felhasználó által megadott útvonalhoz.
Irány | Protokoll | Forrás | Forrásport | Cél | Dest Port | Használt |
---|---|---|---|---|---|---|
Kimenő | TCP | VirtualNetwork | Bármelyik | AzureKeyVault | 443 | Alapértelmezett |
Kimenő | TCP | VirtualNetwork | Bármelyik | Tárolás | 443 | Alapértelmezett |
Kimenő | TCP | VirtualNetwork | Bármelyik | EventHub | 443 | Alapértelmezett |
Kimenő | TCP | VirtualNetwork | Bármelyik | AzureActiveDirectory | 443 | Alapértelmezett |
Kimenő | TCP | VirtualNetwork | Bármelyik | AzureMonitor | 443 | Alapértelmezett |
Megjegyzés
Ha a feladatokhoz további erőforrásokra van szükség a nyilvános internetről, adja hozzá a megfelelő szabályokat. Például további szabályokra van szükség egy docker buildelési feladat futtatásához, amely lekéri az alaprendszerképeket Docker Hub, vagy visszaállít egy NuGet-csomagot.
Készlet létrehozása a virtuális hálózaton
Az alábbi példa létrehoz egy ügynökkészletet a myvnet hálózat mysubnet alhálózatában:
# Get the subnet ID
subnetId=$(az network vnet subnet show \
--resource-group myresourcegroup \
--vnet-name myvnet \
--name mysubnetname \
--query id --output tsv)
az acr agentpool create \
--registry MyRegistry \
--name myagentpool \
--tier S2 \
--subnet-id $subnetId
Feladat futtatása ügynökkészleten
Az alábbi példák bemutatják, hogyan adhatja meg az ügynökkészletet a tevékenységek várólistára helyezésekor.
Megjegyzés
Ha ügynökkészletet szeretne használni egy ACR-feladatban, győződjön meg arról, hogy a készlet legalább 1 példányt tartalmaz.
Gyors feladat
Várjon egy gyors feladatot az ügynökkészleten az az acr build paranccsal, és adja meg a paramétert --agent-pool
:
az acr build \
--registry MyRegistry \
--agent-pool myagentpool \
--image myimage:mytag \
--file Dockerfile \
https://github.com/Azure-Samples/acr-build-helloworld-node.git#main
Automatikusan aktivált feladat
Hozzon létre például egy ütemezett feladatot az ügynökkészleten az az acr task create paranccsal, és adja át a --agent-pool
paramétert.
az acr task create \
--registry MyRegistry \
--name mytask \
--agent-pool myagentpool \
--image myimage:mytag \
--schedule "0 21 * * *" \
--file Dockerfile \
--context https://github.com/Azure-Samples/acr-build-helloworld-node.git#main \
--commit-trigger-enabled false
A feladat beállításának ellenőrzéséhez futtassa az az acr feladatfuttatást:
az acr task run \
--registry MyRegistry \
--name mytask
Lekérdezéskészlet állapota
Az ügynökkészleten jelenleg ütemezett futtatások számának megkereséséhez futtassa az az acr agentpool show parancsot.
az acr agentpool show \
--registry MyRegistry \
--name myagentpool \
--queue-count
Következő lépések
A tárolórendszerképek felhőbeli buildelésével és karbantartásával kapcsolatos további példákért tekintse meg az ACR Tasks oktatóanyag-sorozatát.