Kom igång med Azure Automation State Configuration

Kommentar

Innan du aktiverar Automation State Configuration vill vi att du ska veta att en nyare version av DSC nu är allmänt tillgänglig, som hanteras av en funktion i Azure Policy med namnet gästkonfiguration. Gästkonfigurationstjänsten kombinerar funktioner i DSC-tillägget, Azure Automation State Configuration och de vanligaste funktionerna från kundfeedback. Gästkonfigurationen omfattar även stöd för hybriddatorer via Arc-aktiverade servrar.

Den här artikeln innehåller en stegvis guide för att utföra de vanligaste uppgifterna med Azure Automation State Configuration, till exempel att skapa, importera och kompilera konfigurationer, göra det möjligt för datorer att hantera och visa rapporter. En översikt över Tillståndskonfiguration finns i Översikt över tillståndskonfiguration. Dokumentation om önskad tillståndskonfiguration (DSC) finns i Översikt över önskad tillståndskonfiguration i Windows PowerShell.

Om du vill ha en exempelmiljö som redan har konfigurerats utan att följa stegen som beskrivs i den här artikeln kan du använda mallen Hanterad nod i Azure Automation. Den här mallen konfigurerar en fullständig miljö för tillståndskonfiguration (DSC), inklusive en virtuell Azure-dator som hanteras av State Configuration (DSC).

Förutsättningar

För att slutföra exemplen i den här artikeln krävs följande:

Skapa en DSC-konfiguration

Du skapar en enkel DSC-konfiguration som säkerställer att webbserverns Windows-funktion (IIS) finns eller saknas, beroende på hur du tilldelar noder.

Konfigurationsnamn i Azure Automation får begränsas till högst 100 tecken.

  1. Starta VSCode (eller valfri textredigerare).

  2. Skriv följande text:

    configuration TestConfig
    {
        Node IsWebServer
        {
            WindowsFeature IIS
            {
                Ensure               = 'Present'
                Name                 = 'Web-Server'
                IncludeAllSubFeature = $true
            }
        }
    
        Node NotWebServer
        {
            WindowsFeature IIS
            {
                Ensure               = 'Absent'
                Name                 = 'Web-Server'
            }
        }
    }
    
  3. Spara filen som TestConfig.ps1.

Den här konfigurationen anropar en resurs i varje nodblock, WindowsFeature-resursen. Den här resursen säkerställer antingen förekomsten eller frånvaron av webbserverfunktionen .

Importera en konfiguration till Azure Automation

Därefter importerar du konfigurationen till Automation-kontot.

  1. Logga in på Azure-portalen.

  2. Till vänster klickar du på Alla resurser och sedan på namnet på ditt Automation-konto.

  3. På sidan Automation-konto väljer du Tillståndskonfiguration (DSC) under Konfigurationshantering.

  4. På sidan Tillståndskonfiguration (DSC) klickar du på fliken Konfigurationer och klickar sedan på Lägg till.

  5. I fönstret Importera konfiguration bläddrar du till TestConfig.ps1 filen på datorn.

    Screenshot of the Import Configuration blade

  6. Klicka på OK.

Visa en konfiguration i Azure Automation

När du har importerat en konfiguration kan du visa den i Azure-portalen.

  1. Logga in på Azure-portalen.

  2. Till vänster klickar du på Alla resurser och sedan på namnet på ditt Automation-konto.

  3. På sidan Automation-konto väljer du Tillståndskonfiguration (DSC) under Konfigurationshantering.

  4. På sidan Tillståndskonfiguration (DSC) klickar du på fliken Konfigurationer och sedan på TestConfig. Det här är namnet på konfigurationen som du importerade i föregående procedur.

  5. I fönstret TestConfig-konfiguration klickar du på Visa konfigurationskälla.

    Screenshot of the TestConfig configuration blade

    Fönstret TestConfig Configuration-källa öppnas med PowerShell-koden för konfigurationen.

Kompilera en konfiguration i Azure Automation

Innan du kan tillämpa ett önskat tillstånd på en nod måste en DSC-konfiguration som definierar det tillståndet kompileras till en eller flera nodkonfigurationer (MOF-dokument) och placeras på Automation DSC-hämtningsservern. En mer detaljerad beskrivning av kompilering av konfigurationer i State Configuration (DSC) finns i Kompilera konfigurationer i Azure Automation State Configuration. Mer information om hur du kompilerar konfigurationer finns i DSC-konfigurationer.

  1. Logga in på Azure-portalen.

  2. Till vänster klickar du på Alla resurser och sedan på namnet på ditt Automation-konto.

  3. På sidan Automation-konto klickar du på Tillståndskonfiguration (DSC) under Konfigurationshantering.

  4. På sidan Tillståndskonfiguration (DSC) klickar du på fliken Konfigurationer och sedan på TestConfig. Det här är namnet på den tidigare importerade konfigurationen.

  5. I fönstret TestConfig-konfiguration klickar du på Kompilera och klickar sedan på Ja. Detta startar ett kompileringsjobb.

    Screenshot of the TestConfig configuration page highlighting compile button

Kommentar

När du kompilerar en konfiguration i Azure Automation distribuerar den automatiskt alla MOF-filer för nodkonfiguration som skapats till pull-servern.

Visa ett kompileringsjobb

När du har startat en kompilering kan du visa den i panelen Kompileringsjobbsidan Konfiguration . Panelen Kompileringsjobb visar pågående, slutförda och misslyckade jobb. När du öppnar ett samlingsjobbfönster visas information om jobbet, inklusive eventuella fel eller varningar som påträffas, indataparametrar som används i konfigurationen och kompileringsloggar.

  1. Logga in på Azure-portalen.

  2. Till vänster klickar du på Alla resurser och sedan på namnet på ditt Automation-konto.

  3. På sidan Automation-konto klickar du på Tillståndskonfiguration (DSC) under Konfigurationshantering.

  4. På sidan Tillståndskonfiguration (DSC) klickar du på fliken Konfigurationer och sedan på TestConfig. Det här är namnet på den tidigare importerade konfigurationen.

  5. Under Kompileringsjobb väljer du det kompileringsjobb som ska visas. Fönstret Kompileringsjobb öppnas, märkt med datumet då kompileringsjobbet startades.

    Screenshot of the Compilation Job page

  6. Klicka på valfri panel i fönstret Kompileringsjobb för att se mer information om jobbet.

Visa nodkonfigurationer

När ett kompileringsjobb har slutförts skapas en eller flera nya nodkonfigurationer. En nodkonfiguration är ett MOF-dokument som distribueras till pull-servern och som är redo att hämtas och tillämpas av en eller flera noder. Du kan visa nodkonfigurationerna i ditt Automation-konto på sidan Tillståndskonfiguration (DSC). En nodkonfiguration har ett namn med formuläret ConfigurationName.NodeName.

  1. Logga in på Azure-portalen.

  2. Till vänster klickar du på Alla resurser och sedan på namnet på ditt Automation-konto.

  3. På sidan Automation-konto klickar du på Tillståndskonfiguration (DSC) under Konfigurationshantering.

  4. På sidan Tillståndskonfiguration (DSC) klickar du på fliken Kompilerade konfigurationer .

    Screenshot of the Compiled Configurations tab

Aktivera en virtuell Azure Resource Manager-dator för hantering med tillståndskonfiguration

Du kan använda Tillståndskonfiguration för att hantera virtuella Azure-datorer (både klassiska datorer och Resource Manager), lokala virtuella datorer, Linux-datorer, virtuella AWS-datorer och lokala fysiska datorer. I den här artikeln lär du dig att endast aktivera virtuella Azure Resource Manager-datorer. Information om hur du aktiverar andra typer av datorer finns i Aktivera datorer för hantering av Azure Automation State Configuration.

  1. Logga in på Azure-portalen.

  2. Till vänster klickar du på Alla resurser och sedan på namnet på ditt Automation-konto.

  3. På sidan Automation-konto klickar du på Tillståndskonfiguration (DSC) under Konfigurationshantering.

  4. På sidan Tillståndskonfiguration (DSC) väljer du fliken Noder och klickar sedan på + Lägg till.

    Screenshot of the DSC Nodes page highlighting the Add Azure VM button

  5. Välj den virtuella datorn i fönstret Virtuella datorer.

  6. Klicka på + Anslut i informationsfönstret Virtuell dator.

    Viktigt!

    Den virtuella datorn måste vara en virtuell Azure Resource Manager-dator som kör ett operativsystem som stöds.

  7. På sidan Registrering väljer du namnet på nodkonfigurationen som ska tillämpas på den virtuella datorn i fältet Nodkonfigurationsnamn . Det är valfritt att ange ett namn i det här läget. Du kan ändra den tilldelade nodkonfigurationen när du har aktiverat noden.

  8. Kontrollera Starta om nod om det behövs och klicka sedan på OK.

    Screenshot of the Registration blade

    Nodkonfigurationen som du angav tillämpas på den virtuella datorn med intervall som anges av värdet för konfigurationslägesfrekvens. Den virtuella datorn söker efter uppdateringar av nodkonfigurationen med intervall som anges av värdet Uppdateringsfrekvens. Mer information om hur dessa värden används finns i Konfigurera den lokala konfigurationshanteraren.

Azure startar processen med att aktivera den virtuella datorn. När den är klar visas den virtuella datorn på fliken Noder på sidan Tillståndskonfiguration (DSC) i Automation-kontot.

Visa listan över hanterade noder

Du kan visa listan över alla datorer som har aktiverats för hantering i ditt Automation-konto på fliken Noder på sidan Tillståndskonfiguration (DSC).

  1. Logga in på Azure-portalen.
  2. Till vänster klickar du på Alla resurser och sedan på namnet på ditt Automation-konto.
  3. På sidan Automation-konto klickar du på Tillståndskonfiguration (DSC) under Konfigurationshantering.
  4. På sidan Tillståndskonfiguration (DSC) klickar du på fliken Noder.

Statusvärden för DSC-noder

DSC-noden kan ta något av följande sex värden enligt följande:

  • Misslyckades – Den här statusen visas när ett fel inträffar när en eller flera konfigurationer tillämpas på en nod.
  • Inte kompatibel – Den här statusen visas när drift inträffar på en nod och det krävs en noggrann granskning om den är systematisk.
  • Svarar inte – Den här statusen visas när en nod inte har checkats in på mer än 24 timmar.
  • Väntar – Den här statusen visas när en nod har en ny konfiguration att tillämpa och pull-servern väntar på nodkontroll.
  • Pågår – Den här statusen visas när en nod tillämpar konfigurationen och pull-servern väntar på status.
  • Kompatibel – Den här statusen visas när en nod har en giltig konfiguration och ingen drift inträffar för närvarande.

Kommentar

  • RefreshFrequencyMins – Det definierar frekvensen för noden som kontaktar agenttjänsten och kan tillhandahållas som en del av registrering till DSC. Det tar ett maximalt värde på 1 0080 minuter.
  • Noden markeras som Svarar inte om noden inte kontaktar agenttjänsten på 1440 minuter (1 dag). Vi rekommenderar att du använder RefreshFrequencyMins-värdet< 1440 minuter, annars visas noden i ett falskt tillstånd som inte svarar .

Visa rapporter för hanterade noder

Varje gång State Configuration utför en konsekvenskontroll på en hanterad nod skickar noden en statusrapport tillbaka till pull-servern. Du kan visa dessa rapporter på sidan för den noden.

  1. Logga in på Azure-portalen.

  2. Till vänster klickar du på Alla resurser och sedan på namnet på ditt Automation-konto.

  3. På sidan Automation-konto klickar du på Tillståndskonfiguration (DSC) under Konfigurationshantering.

  4. På sidan Tillståndskonfiguration (DSC) klickar du på fliken Noder. Här kan du se översikten över konfigurationstillståndet och informationen för varje nod.

    Screenshot of Node page

  5. På fliken Noder klickar du på nodposten för att öppna rapporteringen. Klicka på den rapport som du vill visa ytterligare rapporteringsinformation för.

    Screenshot of the Report blade

På bladet för en enskild rapport kan du se följande statusinformation för motsvarande konsekvenskontroll:

  • Rapportstatus. Möjliga värden är:
    • Kompatibel – noden är kompatibel med kontrollen.
    • Misslyckades – konfigurationen misslyckades med kontrollen.
    • Inte kompatibel – noden är i ApplyandMonitor läge och datorn är inte i önskat tillstånd.
  • Starttiden för konsekvenskontrollen.
  • Den totala körningen för konsekvenskontrollen.
  • Typ av konsekvenskontroll.
  • Eventuella fel, inklusive felkoden och felmeddelandet.
  • Alla DSC-resurser som används i konfigurationen och tillståndet för varje resurs (om noden är i önskat tillstånd för den resursen). Du kan klicka på varje resurs för att få mer detaljerad information om resursen.
  • Nodens namn, IP-adress och konfigurationsläge.

Du kan också klicka på Visa rådatarapport för att se de faktiska data som noden skickar till servern. Mer information om hur du använder dessa data finns i Använda en DSC-rapportserver.

Det kan ta lite tid efter att en nod har aktiverats innan den första rapporten är tillgänglig. Du kan behöva vänta upp till 30 minuter på den första rapporten när du har aktiverat en nod.

Tilldela om en nod till en annan nodkonfiguration

Du kan tilldela en nod för att använda en annan nodkonfiguration än den som du ursprungligen tilldelade.

  1. Logga in på Azure-portalen.

  2. Till vänster klickar du på Alla resurser och sedan på namnet på ditt Automation-konto.

  3. På sidan Automation-konto klickar du på Tillståndskonfiguration (DSC) under Konfigurationshantering.

  4. På sidan Tillståndskonfiguration (DSC) klickar du på fliken Noder.

  5. På fliken Noder klickar du på namnet på den nod som du vill tilldela om.

  6. På sidan för noden klickar du på Tilldela nodkonfiguration.

    Screenshot of the Node details page highlighting the Assign node configuration button

  7. På sidan Tilldela nodkonfiguration väljer du den nodkonfiguration som du vill tilldela noden till och klickar sedan på OK.

    Screenshot of the Assign Node Configuration page

Avregistrera en nod

Om du inte längre vill att en nod ska hanteras av Tillståndskonfiguration kan du avregistrera den. Se Så här tar du bort en konfiguration och nod från Automation State Configuration.

Nästa steg