Azure fejlesztői parancssori felület hibáival kapcsolatos gyakori kérdések

Ez a cikk a Azure fejlesztői parancssori felület (azd) használatakor előforduló gyakori hibákra nyújt megoldást.

A szerepkör-hozzárendelés írásához nem sikerült az engedélyezés

Hibaüzenet:The template deployment failed with error: 'Authorization failed for template resource '<guid>' of type 'Microsoft.Authorization/roleAssignments'. The client '##Email##' with object id '<guid>' does not have permission to perform action 'Microsoft.Authorization/roleAssignments/write' at scope '<resourceId>'.'

Cause: Nincs elegendő engedélye a szerepkörök hozzárendeléséhez a cél Azure előfizetésben vagy erőforráscsoportban. Ez akkor fordul elő gyakran, ha a felhasználói fiók Contributor hozzáféréssel rendelkezik, de nincs Owner vagy User Access Administrator hozzáférése. Contributor lehetővé teszi, hogy erőforrásokat hozzon létre, de ne adjon engedélyeket (szerepköröket) ezekhez az erőforrásokhoz.

Felbontás: Győződjön meg arról, hogy a fiókja tulajdonosi vagy felhasználói hozzáférés-rendszergazdai szerepkört kap azon az előfizetésen vagy erőforráscsoporton, amelyen üzembe helyezve van. Ha nem adhatja meg ezeket a szerepköröket, kérje meg a rendszergazdát, hogy végezze el a kezdeti üzembe helyezést vagy szerepkör-hozzárendeléseket. További információ: Azure beépített szerepkörök.

A szerepkör-hozzárendelés már létezik

Hibaüzenet:The role assignment already exists.

Okoz: Ez a hiba akkor fordul elő, ha az üzembe helyezés olyan szerepkör-hozzárendelést próbál létrehozni, amely már létezik az erőforráson. Bár az Azure Resource Manager (ARM) üzemelő példányai idempotensek, a sablonok bizonyos konfigurációi vagy versenyhelyzetek aktiválhatják ezt a hibát újratelepítés során.

Felbontás: Ez a hiba gyakran időszakos vagy jóindulatú.

1. Próbálkozzon újra az üzembe helyezéssel: Futtassa azd up vagy azd deploy újra.
2. Ellenőrizze a Bicep sablonokat: Ha fenntartja a sablont, győződjön meg arról, hogy a szerepkör-hozzárendelések érvényes name tulajdonságokat (gyakran szigorúan determinisztikus GUID-okat) használnak az idempotencia biztosításához. A determinisztikus nevek létrehozásához használja a guid() Bicep függvényt.

A bérlőazonosító, az egyszerű azonosító vagy a hatókör nem frissíthető

Hibaüzenet:Tenant ID, application ID, principal ID, and scope are not allowed to be updated.

Okoz: Olyan szerepkör-hozzárendelést próbál újra üzembe helyezni, amely a meglévő hozzárendeléstől eltérő tulajdonságokkal rendelkezik. A szerepkör-hozzárendelések nem módosíthatók; Nem módosíthatja az egyszerű azonosítót (a szerepkört fogadó felhasználó/alkalmazás) vagy egy meglévő hozzárendelés-azonosító hatókörét.

Felbontás:

1. Paraméterek ellenőrzése: Győződjön meg arról, hogy nem véletlenül ad át egy másik fő azonosítót (például egy felhasználó és egy szolgáltatásazonosító közötti választás) ugyanahhoz a szerepkör-hozzárendelési erőforráshoz.
2. Tisztítás: Ha módosítania kell a hozzárendelést, törölje manuálisan az ütköző szerepköri hozzárendelést a Azure portálon vagy a parancssori felületen az az role assignment delete parancs használatával, majd telepítse újra.

A régió kapacitása vagy termékváltozata nem érhető el

Hibaüzenet:The region 'eastus2' currently does not have enough resources available to provision services with the SKU 'standard'. (vagy "alapszintű")

Cause: A kiválasztott Azure régió átmenetileg nincs kapacitása a kért szolgáltatásváltozathoz. Ez jelenleg gyakori az AI-szolgáltatásokban (például Azure OpenAI) olyan népszerű régiókban, mint a eastus2.

Felbontás:

1. Hely módosítása: Futtassa azd env set AZURE_LOCATION <new-region> a váltást egy jobb rendelkezésre állású régióra (például swedencentral, westus3, francecentral).
2. Rendelkezésre állás ellenőrzése: A Azure Termékek régiónként lapon vagy a az account list-locations futtatásával ellenőrizze, hogy a szolgáltatás és a termékváltozat elérhető-e.

TPM-kvóta túllépve az AI-modellek esetében

Hibaüzenet:This operation require <amount> new capacity in quota Tokens Per Minute (thousands) - <model> - GlobalStandard, which is bigger than the current available capacity <available>.

Cause: Az előfizetés elérte a célrégióban megadott Azure OpenAI-modellhez tartozó percenkénti jogkivonatok (TPM) kvótakorlátját.

Felbontás:

1. Request Quota: Kvótanövelés kérése az Azure AI Studio vagy Azure portálon keresztül. További információért tekintse meg a kvóta Azure OpenAI Service kezelése című dokumentumot.
2. Modellek/régió módosítása: Váltson olyan régióra, ahol kiadatlan kvótája van, vagy használjon egy másik modellverziót, amely belefér a korlátozásokba.

Az If-Match előfeltétel nem teljesült

Hibaüzenet:The specified precondition 'If-Match = ""<guid>""' failed.

Okoz: Ez a probléma általában konkurencia ütközést jelez. Előfordulhat, hogy két folyamat egyszerre próbálja frissíteni ugyanazt az erőforrást, vagy a helyi állapot nincs szinkronizálva a felhőbeli erőforrással (elavult ETag).

Felbontás: Próbálkozzon újra a művelettel. Ha a hiba továbbra is fennáll:

1. Győződjön meg arról, hogy más üzemelő példányok (CI/CD-folyamatok, más munkatársak) nem célozzák meg ugyanazt a környezetet egyidejűleg.
2. Ha Bicep használ, ellenőrizze, hogy a sablon helyesen határozza-e meg a függőségeket (dependsOn), hogy megakadályozza ugyanazon erőforrás párhuzamos módosítását.

Cognitive Services-fiók elfogadott állapotú

Hibaüzenet:Call to Microsoft.CognitiveServices/accounts failed. Error message: Account <resourceId> in state Accepted.

Ok: Ez a hiba egy időzítési probléma, amikor egy függő erőforrás megpróbál kapcsolatba lépni a Cognitive Services (Azure AI) fiókkal, mielőtt az teljesen kiépülne és aktívvá válna. Folytatás előtt hozzáadhat egy parancshookot (például postprovision) a azure.yaml fájlba, hogy szünetet tartson, vagy ellenőrizze az erőforrás készenlétét.

A tárolóalkalmazás verziójának rendelkezésre állása lejárt

Hibaüzenet:Failed to provision revision for container app <appName>. Error details: Operation expired.

Cause: A Azure tárolóalkalmazás nem indult el az alapértelmezett időtúllépési időszakon belül. Gyakori okok például:

• A konténerkép túl nagy, és túl sokáig tart a letöltése.
• Az alkalmazás indításkor összeomlik.
• Az alkalmazás túl sokáig tart a konfigurált port figyeléséhez.

Felbontás:

1. Naplók ellenőrzése: A tárolónaplók megtekintése a Azure portálon (Naplóstream) vagy azd monitor használatával annak megtekintéséhez, hogy az alkalmazás összeomlik-e.
2. Konfiguráció áttekintése: Győződjön meg arról, hogy a targetPort konfiguráció egyezik az alkalmazás által figyelt portokkal. További hibaelhárítási lépések: Troubleshooting Azure Container Apps
3. Naplók ellenőrzése: A tárolónaplók megtekintése a Azure portálon (Naplóstream) vagy azd monitor használatával annak megtekintéséhez, hogy az alkalmazás összeomlik-e.
4. Konfiguráció áttekintése: Győződjön meg arról, hogy a targetPort konfiguráció egyezik az alkalmazás által figyelt portokkal.
5. Kép optimalizálása: A lekérés felgyorsítása érdekében csökkentse a tárolólemezkép méretét.