Az Azure Automation állapotkonfigurációs problémáinak elhárítása
Ez a cikk az Azure Automation State Configuration konfigurációinak fordítása vagy üzembe helyezése során felmerülő problémák hibaelhárításáról és megoldásáról nyújt tájékoztatást. Az Állapotkonfiguráció funkcióval kapcsolatos általános információkért tekintse meg az Azure Automation állapotkonfigurációjának áttekintését.
Probléma diagnosztizálása
Amikor fordítási vagy üzembe helyezési hibát kap a konfigurációhoz, az alábbi lépések segítenek a probléma diagnosztizálásában.
1. Győződjön meg arról, hogy a konfiguráció sikeresen lefordítható a helyi gépen
Az Azure Automation State Configuration a PowerShell Desired State Configuration (DSC) szolgáltatásra épül. A DSC nyelvének és szintaxisának dokumentációját a PowerShell DSC-dokumentumokban találja.
A helyi gépen található DSC-konfiguráció összeállításával felderítheti és megoldhatja a gyakori hibákat, például:
- Hiányzó modulok.
- Szintaxishibák.
- Logikai hibák.
2. DSC-naplók megtekintése a csomóponton
Ha a konfiguráció sikeresen lefordítva, de egy csomópontra alkalmazva meghiúsul, részletes információkat találhat a DSC-naplókban. A naplók megkereséséről további információt a Hol találhatók a DSC eseménynaplói című témakörben talál.
Az xDscDiagnostics modul segítséget nyújthat a DSC-naplók részletes információinak elemzésében. Ha kapcsolatba lép az ügyfélszolgálattal, ezek a naplók szükségesek a probléma diagnosztizálásához.
A modult a xDscDiagnostics
helyi gépére telepítheti a stabil verziójú modul telepítésével kapcsolatos utasításokat követve.
A modul Azure-gépen való telepítéséhez használja az xDscDiagnostics
Invoke-AzVMRunCommand parancsot. A Futtatás parancsot az Azure Portalon is használhatja a Windows rendszerű virtuális gép PowerShell-szkriptjeinek futtatása a Futtatás paranccsal lépésekkel.
További információ az xDscDiagnostics használatáról: DSC-naplók elemzése xDscDiagnostics használatával. Lásd még : xDscDiagnostics Parancsmagok.
3. Győződjön meg arról, hogy a csomópontok és az Automation-munkaterület rendelkezik szükséges modulokkal
A DSC a csomóponton telepített moduloktól függ. Az Azure Automation State Configuration használatakor importálja a szükséges modulokat az Automation-fiókjába a Modulok importálása lépésekkel. A konfigurációk a modulok adott verzióitól is függhetnek. További információ: Modulok hibaelhárítása.
Forgatókönyv: A speciális karaktereket tartalmazó konfiguráció nem törölhető a portálról
Probléma
Amikor megpróbál törölni egy DSC-konfigurációt a portálról, a következő hibaüzenet jelenik meg:
An error occurred while deleting the DSC configuration '<name>'. Error-details: The argument configurationName with the value <name> is not valid. Valid configuration names can contain only letters, numbers, and underscores. The name must start with a letter. The length of the name must be between 1 and 64 characters.
Ok
Ez a hiba egy ideiglenes probléma, amelyet a tervek szerint meg kell oldani.
Resolution (Osztás)
A Konfiguráció törléséhez használja a Remove-AzAutomationDscConfiguration parancsmagot.
Forgatókönyv: Nem sikerült regisztrálni a DSC-ügynököt
Probléma
A Set-DscLocalConfigurationManager vagy egy másik DSC-parancsmag esetén a következő hibaüzenet jelenik meg:
Registration of the Dsc Agent with the server
https://<location>-agentservice-prod-1.azure-automation.net/accounts/00000000-0000-0000-0000-000000000000 failed. The
underlying error is: Failed to register Dsc Agent with AgentId 00000000-0000-0000-0000-000000000000 with the server htt
ps://<location>-agentservice-prod-1.azure-automation.net/accounts/00000000-0000-0000-0000-000000000000/Nodes(AgentId='00000000-0000-0000-0000-000000000000'). .
+ CategoryInfo : InvalidResult: (root/Microsoft/...gurationManager:String) [], CimException
+ FullyQualifiedErrorId : RegisterDscAgentCommandFailed,Microsoft.PowerShell.DesiredStateConfiguration.Commands.Re
gisterDscAgentCommand
+ PSComputerName : <computerName>
Ok
Ezt a hibát általában egy tűzfal, a proxykiszolgáló mögötti gép vagy más hálózati hibák okozzák.
Resolution (Osztás)
Ellenőrizze, hogy a gép hozzáfér-e a DSC megfelelő végpontjaihoz, majd próbálkozzon újra. A szükséges portok és címek listáját lásd : Hálózattervezés.
Forgatókönyv: Az állapotjelentések nem engedélyezett válaszkódot adnak vissza
Probléma
Amikor regisztrál egy csomópontot az Azure Automation State Configuration szolgáltatásban, a következő hibaüzenetek egyikét kapja:
The attempt to send status report to the server https://{your Automation account URL}/accounts/xxxxxxxxxxxxxxxxxxxxxx/Nodes(AgentId='xxxxxxxxxxxxxxxxxxxxxxxxx')/SendReport returned unexpected response code Unauthorized.
VM has reported a failure when processing extension 'Microsoft.Powershell.DSC / Registration of the Dsc Agent with the server failed.
Ok
A lehetséges okok a következők:
Hibás vagy lejárt tanúsítvány. Lásd: Csomópont újbóli regisztrálása.
Proxykonfiguráció, amely nem teszi lehetővé a *.azure-automation.net elérését. További információ: Magánhálózatok konfigurálása.
Ha letiltja a helyi hitelesítést az Azure Automationben. Lásd: Helyi hitelesítés letiltása. A probléma megoldásához tekintse meg a helyi hitelesítés újbóli engedélyezését.
Az ügyfélszámítógép ideje a tényleges időtől számítva több perc pontatlan. (Az időhasználat ellenőrzéséhez: w32tm /stripchart /computer:time.windows.com /samples:6).
Resolution (Osztás)
A sikertelen DSC-csomópont újraregisztrálásához kövesse az alábbi lépéseket.
1. lépés: A csomópont regisztrációjának megszüntetése
- Az Azure Portalon nyissa meg a Home>Automation-fiókokat> (az Automation-fiók) >állapotkonfigurációját (DSC).
- Válassza a Csomópontok lehetőséget, és válassza ki a problémás csomópontot.
- Válassza a Regisztráció törlése lehetőséget a csomópont regisztrációjának megszüntetéséhez.
2. lépés: A DSC-bővítmény eltávolítása a csomópontról
- Az Azure Portalon nyissa meg az Otthoni>virtuális gép> (hibás csomópont) >bővítményeket.
- Válassza ki a Microsoft.Powershell.DSC-t, a PowerShell DSC-bővítményt.
- Válassza az Eltávolítás lehetőséget a bővítmény eltávolításához.
3. lépés: Az összes hibás vagy lejárt tanúsítvány eltávolítása a csomópontról
Az emelt szintű PowerShell-parancssorból származó sikertelen csomóponton futtassa az alábbi parancsokat:
$certs = @()
$certs += dir cert:\localmachine\my | ?{$_.FriendlyName -like "DSC"}
$certs += dir cert:\localmachine\my | ?{$_.FriendlyName -like "DSC-OaaS Client Authentication"}
$certs += dir cert:\localmachine\CA | ?{$_.subject -like "CN=AzureDSCExtension*"}
"";"== DSC Certificates found: " + $certs.Count
$certs | FL ThumbPrint,FriendlyName,Subject
If (($certs.Count) -gt 0)
{
ForEach ($Cert in $certs)
{
RD -LiteralPath ($Cert.Pspath)
}
}
4. lépés: A hibás csomópont újbóli regisztrálása
- Az Azure Portalon nyissa meg a Home>Automation-fiókokat> (az Automation-fiók) >állapotkonfigurációját (DSC).
- Válassza a Csomópontok lehetőséget.
- Select Add.
- Válassza ki a hibás csomópontot.
- Válassza Csatlakozás, és válassza ki a kívánt beállításokat.
Forgatókönyv: A csomópont "Nem található" hibával meghiúsult állapotban van
Probléma
A csomópont egy sikertelen állapotú jelentéssel rendelkezik, amely a következő hibát tartalmazza:
The attempt to get the action from server https://<url>//accounts/<account-id>/Nodes(AgentId=<agent-id>)/GetDscAction failed because a valid configuration <guid> cannot be found.
Ok
Ez a hiba általában akkor fordul elő, ha a csomópontot egy konfigurációs névhez, például ABC-hez rendelik a csomópontkonfiguráció (MOF-fájl) neve helyett, például az ABC-hez. WebServer.
Resolution (Osztás)
Győződjön meg arról, hogy a csomópontot a csomópont konfigurációs nevével rendeli hozzá, nem pedig a konfiguráció nevét.
Csomópontkonfigurációt az Azure Portalon vagy egy PowerShell-parancsmaggal rendelhet hozzá egy csomóponthoz.
- Az Azure Portalon nyissa meg a Home>Automation-fiókokat> (az Automation-fiók) >állapotkonfigurációját (DSC). Ezután válasszon ki egy csomópontot, és válassza a Csomópontkonfiguráció hozzárendelése lehetőséget.
- Használja a Set-AzAutomationDscNode parancsmagot.
Forgatókönyv: A konfiguráció lefordításakor nem jöttek létre csomópontkonfigurációk (MOF-fájlok)
Probléma
A DSC fordítási feladata a következő hibával függeszt fel:
Compilation completed successfully, but no node configuration **.mof** files were generated.
Ok
Amikor a DSC-konfigurációban a Node
kulcsszót követő kifejezés kiértékeli, $null
a rendszer nem hoz létre csomópontkonfigurációkat.
Resolution (Osztás)
A probléma megoldásához használja az alábbi megoldások egyikét:
- Győződjön meg arról, hogy a
Node
konfigurációdefiníció kulcsszója melletti kifejezés nem null értékű. - Ha a konfiguráció lefordításakor adja át a ConfigurationData-t , győződjön meg arról, hogy a konfiguráció által elvárt értékeket adja át a konfigurációs adatoktól.
Forgatókönyv: A DSC-csomópont jelentése elakad a Folyamatban állapotban
Probléma
A DSC-ügynök kimenetei:
No instance found with given property values
Ok
Frissítette a Windows Management Framework (WMF) verzióját, és sérült a Windows Management Instrumentation (WMI).
Resolution (Osztás)
Kövesse a DSC ismert problémáival és korlátozásokkal kapcsolatos utasításait.
Forgatókönyv: A hitelesítő adatok nem használhatók DSC-konfigurációban
Probléma
A DSC fordítási feladatát a következő hibával függesztette fel:
System.InvalidOperationException error processing property 'Credential' of type <some resource name>: Converting and storing an encrypted password as plaintext is allowed only if PSDscAllowPlainTextPassword is set to true.
Ok
Hitelesítő adatokat használt egy konfigurációban, de nem adta meg a megfelelő ConfigurationData
PSDscAllowPlainTextPassword
beállítást az egyes csomópontkonfigurációkhoz.
Resolution (Osztás)
Győződjön meg arról, hogy a megfelelő ConfigurationData
PSDscAllowPlainTextPassword
értéket adja meg, hogy igaz legyen a konfigurációban említett csomópontkonfigurációk esetében. Lásd: DSC-konfigurációk összeállítása az Azure Automation State Configuration szolgáltatásban.
Forgatókönyv: "Hibafeldolgozási bővítmény" hiba a gép DSC-bővítményből való engedélyezésekor
Probléma
Ha DSC-bővítmény használatával engedélyezi a gépet, hiba történik, amely a következő hibát tartalmazza:
VM has reported a failure when processing extension 'Microsoft.Powershell.DSC'. Error message: \"DSC COnfiguration 'RegistrationMetaConfigV2' completed with error(s). Following are the first few: Registration of the Dsc Agent with the server <url> failed. The underlying error is: The attempt to register Dsc Agent with Agent Id <ID> with the server <url> return unexpected response code BadRequest. .\".
Ok
Ez a hiba általában akkor fordul elő, ha a csomóponthoz olyan csomópontkonfigurációs nevet rendel, amely nem létezik a szolgáltatásban.
Resolution (Osztás)
- Győződjön meg arról, hogy a csomópontot olyan névvel rendeli hozzá, amely pontosan egyezik a szolgáltatás nevével.
- Dönthet úgy, hogy nem adja meg a csomópont konfigurációjának nevét, ami lehetővé teszi a csomópont engedélyezését, de nem rendel hozzá csomópontkonfigurációt.
Forgatókönyv: "Egy vagy több hiba történt" hiba, amikor egy csomópontot regisztrál a PowerShell használatával
Probléma
Amikor regisztrál egy csomópontot a Register-AzAutomationDSCNode vagy a Register-AzureRMAutomationDSCNode használatával, a következő hibaüzenet jelenik meg:
One or more errors occurred.
Ok
Ez a hiba akkor fordul elő, ha egy csomópontot az Automation-fiók által használttól eltérő előfizetésben próbál regisztrálni.
Resolution (Osztás)
Kezelje az előfizetések közötti csomópontot úgy, mintha külön felhőhöz vagy helyszínihez lenne definiálva. Regisztrálja a csomópontot az alábbi lehetőségek egyikével a gépek engedélyezéséhez:
- Windows: Fizikai/virtuális Windows-gépek a helyszínen vagy az Azure/AWS-en kívüli felhőben.
- Linux: Fizikai/virtuális Linux-gépek a helyszínen vagy az Azure-on kívüli felhőben.
Forgatókönyv: "A kiépítés meghiúsult" hibaüzenet
Probléma
Amikor regisztrál egy csomópontot, a következő hibaüzenet jelenik meg:
Provisioning has failed
Ok
Ez az üzenet akkor jelenik meg, ha probléma merül fel a csomópont és az Azure közötti kapcsolattal kapcsolatban.
Resolution (Osztás)
Állapítsa meg, hogy a csomópont virtuális magánhálózaton (VPN) található-e, vagy más problémák merülnek fel az Azure-hoz való csatlakozás során. Lásd a funkció üzembe helyezésével kapcsolatos problémák elhárítását.
Forgatókönyv: Általános hibával kapcsolatos hiba a konfiguráció linuxos alkalmazásakor
Probléma
Amikor linuxos konfigurációt alkalmaz, hiba történik, amely a következő hibát tartalmazza:
This event indicates that failure happens when LCM is processing the configuration. ErrorId is 1. ErrorDetail is The SendConfigurationApply function did not succeed.. ResourceId is [resource]name and SourceInfo is ::nnn::n::resource. ErrorMessage is A general error occurred, not covered by a more specific error code..
Ok
Ha a /tmp hely beállításakor noexec
a DSC jelenlegi verziója nem alkalmazza a konfigurációkat.
Resolution (Osztás)
Távolítsa el a noexec
lehetőséget a /tmp helyről.
Forgatókönyv: Az átfedésben lévő csomópont-konfigurációnevek rossz kiadást eredményezhetnek
Probléma
Ha egyetlen konfigurációs szkripttel több csomópontkonfigurációt hoz létre, és egyes csomópontkonfigurációnevek más nevek részhalmazai, a fordítási szolgáltatás végül nem a megfelelő konfigurációt rendeli hozzá. Ez a probléma csak akkor fordul elő, ha egyetlen szkripttel hoz létre konfigurációkat csomópontonkénti konfigurációs adatokkal, és csak akkor, ha a név átfedésben van a sztring elején. Ilyen például egy olyan konfigurációs szkript, amellyel parancsmagok használatával kivonatolóként átadott csomópontadatokon alapuló konfigurációkat hozhat létre, a csomópontadatok pedig kiszolgáló és 1kiszolgáló nevűkiszolgálókat tartalmaznak.
Ok
Ez a fordítási szolgáltatás ismert problémája.
Resolution (Osztás)
A legjobb megoldás az, ha helyileg vagy CI/CD-folyamatban fordítja le, és feltölti a csomópontkonfigurációs MOF-fájlokat közvetlenül a szolgáltatásba. Ha a szolgáltatásban való fordítás követelmény, a következő legjobb megoldás a fordítási feladatok felosztása, hogy ne legyen átfedés a nevek között.
Forgatókönyv: Átjáró időtúllépési hibája a DSC-konfiguráció feltöltésekor
Probléma
A DSC-konfiguráció feltöltésekor hibaüzenet jelenik GatewayTimeout
meg.
Ok
A fordításhoz hosszú ideig tartó DSC-konfigurációk okozhatják ezt a hibát.
Resolution (Osztás)
A DSC-konfigurációk elemzését gyorsabbá teheti, ha explicit módon beleszámít minden ModuleName
Import-DSCResource-hívás paraméterét.
Forgatókönyv: Hiba a gép előkészítése során
Probléma
A gép előkészítésekor hibaüzenet jelenik agent has a problem
meg.
Ok
This is a known issue. Nem rendelheti hozzá újra ugyanazt a konfigurációt, mintha a csomópont függőben marad.
Resolution (Osztás)
A feladat az, hogy különböző tesztkonfigurációt alkalmazzon, és újra alkalmazza az eredeti konfigurációt.
Következő lépések
Ha itt nem látja a problémát, vagy nem tudja megoldani a problémát, próbálkozzon az alábbi csatornák egyikével további támogatásért:
- Azure-szakértők válaszolnak az Azure Fórumain keresztül.
- Csatlakozás a @AzureSupport, a microsoftos Azure hivatalos fiókjával az ügyfélélmény javításához. Az Azure-támogatás összekapcsolja az Azure-közösséget a válaszokhoz, a támogatáshoz és a szakértőkhöz.
- Azure-támogatás incidens bejelentése. Lépjen a Azure-támogatás webhelyre, és válassza a Támogatás kérése lehetőséget.