Az Azure Automation állapotkonfigurációs problémáinak elhárítása

  • Cikk

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

  1. Az Azure Portalon nyissa meg a Home>Automation-fiókokat> (az Automation-fiók) >állapotkonfigurációját (DSC).
  2. Válassza a Csomópontok lehetőséget, és válassza ki a problémás csomópontot.
  3. 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

  1. Az Azure Portalon nyissa meg az Otthoni>virtuális gép> (hibás csomópont) >bővítményeket.
  2. Válassza ki a Microsoft.Powershell.DSC-t, a PowerShell DSC-bővítményt.
  3. 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

  1. Az Azure Portalon nyissa meg a Home>Automation-fiókokat> (az Automation-fiók) >állapotkonfigurációját (DSC).
  2. Válassza a Csomópontok lehetőséget.
  3. Select Add.
  4. Válassza ki a hibás csomópontot.
  5. 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, $nulla 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ő ConfigurationDataPSDscAllowPlainTextPassword beállítást az egyes csomópontkonfigurációkhoz.

Resolution (Osztás)

Győződjön meg arról, hogy a megfelelő ConfigurationDataPSDscAllowPlainTextPassword é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:

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 noexeca 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: