Rövid útmutató – Webhely létrehozása Desired State Configuration (DSC) használatával
Érintett kiadások: Windows PowerShell 4.0, Windows PowerShell 5.0
Ez a gyakorlat végigvezeti egy Desired State Configuration (DSC) konfiguráció létrehozásának és alkalmazásának folyamatán az elejétől a végéig. Az általunk használt példa biztosítja, hogy a kiszolgálón engedélyezve legyen az Web-Server
(IIS) funkció, és hogy egy egyszerű ""Helló világ!" alkalmazás" webhely tartalma jelen legyen a inetpub\wwwroot
kiszolgáló könyvtárában.
A DSC működésének áttekintéséért lásd: Desired State Configuration Döntéshozók számára – áttekintés.
Követelmények
A példa futtatásához szüksége lesz egy Windows Server 2012 vagy újabb, valamint a PowerShell 4.0-s vagy újabb verzióját futtató számítógépre.
A index.htm fájl írása és elhelyezése
Először létrehozzuk azt a HTML-fájlt, amelyet webhelytartalomként fogunk használni.
A gyökérmappában hozzon létre egy nevű test
mappát.
Egy szövegszerkesztőben írja be a következő szöveget:
<head></head>
<body>
<p>Hello World!</p>
</body>
Mentse a index.htm
fájlt a test
korábban létrehozott mappába.
A konfiguráció írása
A DSC-konfiguráció egy speciális PowerShell-függvény, amely meghatározza, hogyan szeretné konfigurálni egy vagy több célszámítógépet (csomópontot).
A PowerShell ISE-ben írja be a következőt:
Configuration WebsiteTest {
# Import the module that contains the resources we're using.
Import-DscResource -ModuleName PsDesiredStateConfiguration
# The Node statement specifies which targets this configuration will be applied to.
Node 'localhost' {
# The first resource block ensures that the Web-Server (IIS) feature is enabled.
WindowsFeature WebServer {
Ensure = "Present"
Name = "Web-Server"
}
# The second resource block ensures that the website content copied to the website root folder.
File WebsiteContent {
Ensure = 'Present'
SourcePath = 'c:\test\index.htm'
DestinationPath = 'c:\inetpub\wwwroot'
}
}
}
Mentse a fájlt WebsiteTest.ps1
néven.
Láthatja, hogy powershell-függvénynek tűnik, és a függvény neve előtt a Configuration kulcsszót használja.
A Csomópont blokk határozza meg a konfigurálni kívánt célcsomópontot. Ebben az esetben: localhost
.
A konfiguráció két erőforrást hív meg: WindowsFeature és File. Az erőforrások gondoskodnak arról, hogy a célcsomópont a konfiguráció által meghatározott állapotban legyen.
A konfiguráció fordítása
Ahhoz, hogy egy DSC-konfigurációt egy csomópontra lehessen alkalmazni, először egy MOF-fájlba kell lefordítani. Ehhez a konfigurációt függvényként kell futtatnia. Egy PowerShell-konzolon lépjen arra a mappára, ahová a konfigurációt mentette, és futtassa a következő parancsokat a konfiguráció MOF-fájlba való fordításához:
. .\WebsiteTest.ps1
WebsiteTest
Ez a következő kimenetet hozza létre:
Directory: C:\ConfigurationTest\WebsiteTest
Mode LastWriteTime Length Name
---- ------------- ------ ----
-a---- 3/13/2017 5:20 PM 2746 localhost.mof
Az első sor elérhetővé teszi a konfigurációs függvényt a konzolon. A második sor futtatja a konfigurációt. Az eredmény az, hogy egy nevű WebsiteTest
új mappa jön létre az aktuális mappa almappájaként. A WebsiteTest
mappa egy nevű localhost.mof
fájlt tartalmaz. Ez a fájl alkalmazható a célcsomópontra.
A konfiguráció alkalmazása
Most, hogy létrehozta a lefordított MOF-t, alkalmazhatja a konfigurációt a célcsomópontra (ebben az esetben a helyi számítógépre) a Start-DscConfiguration parancsmag meghívásával.
A Start-DscConfiguration
parancsmag tájékoztatja a Helyi Configuration Manager (LCM) – amely a DSC motorja –, hogy alkalmazza a konfigurációt. Az LCM elvégzi a DSC-erőforrások meghívását a konfiguráció alkalmazásához.
Megjegyzés
A DSC futtatásának engedélyezéséhez a Windowst úgy kell konfigurálni, hogy távoli PowerShell-parancsokat fogadjon, még akkor is, ha ön konfigurációt localhost
futtat. A környezet helyes konfigurálásához egyszerűen futtassa a parancsot Set-WsManQuickConfig -Force
egy emelt szintű PowerShell-terminálban.
Egy PowerShell-konzolon lépjen arra a mappára, ahová a konfigurációt mentette, és futtassa a következő parancsot:
Start-DscConfiguration .\WebsiteTest
A konfiguráció tesztelése
A Get-DscConfigurationStatus parancsmaggal ellenőrizheti, hogy a konfiguráció sikeres volt-e.
Az eredményeket közvetlenül is tesztelheti, ebben az esetben a böngészőben való böngészéssel http://localhost/
. A példában az első lépésként létrehozott ""Helló világ!" alkalmazás" HTML-lapnak kell megjelennie.
Következő lépések
- További információ a DSC-konfigurációkról: DSC-konfigurációk.
- Tekintse meg, hogy mely DSC-erőforrások érhetők el, és hogyan hozhat létre egyéni DSC-erőforrásokat a DSC-erőforrásokban.
- Keresse meg a DSC-konfigurációkat és -erőforrásokat a PowerShell-galéria.