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.