Rychlý start – Vytvoření webu pomocí Desired State Configuration (DSC)
Platí pro: Windows PowerShell 4.0, Windows PowerShell 5.0
Toto cvičení vás provede vytvořením a použitím konfigurace Desired State Configuration (DSC) od začátku do konce. Příklad, který použijeme, zajistí, že server má povolenou Web-Server
funkci (IIS) a že obsah jednoduchého Hello World webu je v inetpub\wwwroot
adresáři tohoto serveru.
Přehled toho, co je DSC a jak funguje, najdete v přehledu Desired State Configuration pro osoby s rozhodovací pravomocí.
Požadavky
Ke spuštění tohoto příkladu budete potřebovat počítač s Windows Server 2012 nebo novějším a PowerShellem 4.0 nebo novějším.
Zápis a umístění souboru index.htm
Nejprve vytvoříme soubor HTML, který použijeme jako obsah webu.
V kořenové složce vytvořte složku s názvem test
.
V textovém editoru zadejte následující text:
<head></head>
<body>
<p>Hello World!</p>
</body>
Uložte ho jako index.htm
do složky, test
kterou jste vytvořili dříve.
Zápis konfigurace
Konfigurace DSC je speciální funkce PowerShellu, která definuje, jak chcete nakonfigurovat jeden nebo více cílových počítačů (uzlů).
V prostředí PowerShell ISE zadejte následující příkaz:
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'
}
}
}
Uložte soubor jako WebsiteTest.ps1
.
Uvidíte, že vypadá jako funkce PowerShellu s přidáním klíčového slova Configuration použitého před názvem funkce.
Blok uzlu určuje cílový uzel, který se má nakonfigurovat. V tomto případě . localhost
Konfigurace volá dva prostředky, WindowsFeature a File. Prostředky zajišťují, aby cílový uzel byl ve stavu definovaném konfigurací.
Kompilace konfigurace
Aby se konfigurace DSC použila na uzel, musí být nejprve zkompilována do souboru MOF. Provedete to tak, že konfiguraci spustíte jako funkci. V konzole PowerShellu přejděte do stejné složky, do které jste uložili konfiguraci, a spuštěním následujících příkazů zkompilujte konfiguraci do souboru MOF:
. .\WebsiteTest.ps1
WebsiteTest
Tím se vygeneruje následující výstup:
Directory: C:\ConfigurationTest\WebsiteTest
Mode LastWriteTime Length Name
---- ------------- ------ ----
-a---- 3/13/2017 5:20 PM 2746 localhost.mof
První řádek zpřístupní konfigurační funkci v konzole. Na druhém řádku se spustí konfigurace. Výsledkem je, že se vytvoří nová složka s názvem WebsiteTest
jako podsložka aktuální složky. Složka WebsiteTest
obsahuje soubor s názvem localhost.mof
. Toto je soubor, který se pak dá použít na cílový uzel.
Použití konfigurace
Teď, když máte zkompilovaný MOF, můžete konfiguraci použít na cílový uzel (v tomto případě na místním počítači) voláním rutiny Start-DscConfiguration .
Rutina Start-DscConfiguration
řekne místnímu Configuration Manager (LCM), což je modul DSC, aby použil konfiguraci. LCM provede volání prostředků DSC, aby použil konfiguraci.
Poznámka
Aby bylo možné spustit DSC, musí být systém Windows nakonfigurovaný tak, aby přijímal vzdálené příkazy PowerShellu, a to i v případě, že spouštíte localhost
konfiguraci. Pokud chcete prostředí snadno nakonfigurovat správně, stačí spustit Set-WsManQuickConfig -Force
v terminálu PowerShellu se zvýšenými oprávněními.
V konzole PowerShellu přejděte do stejné složky, do které jste uložili konfiguraci, a spusťte následující příkaz:
Start-DscConfiguration .\WebsiteTest
Otestujte konfiguraci.
Můžete volat rutinu Get-DscConfigurationStatus a zjistit, jestli konfigurace proběhla úspěšně.
Výsledky můžete také otestovat přímo, v tomto případě tak, že přejdete do http://localhost/
webového prohlížeče. Jako první krok v tomto příkladu by se měla zobrazit stránka HTML "Hello World", kterou jste vytvořili.
Další kroky
- Další informace o konfiguracích DSC najdete v tématu Konfigurace DSC.
- Podívejte se, jaké prostředky DSC jsou k dispozici a jak vytvořit vlastní prostředky DSC, najdete v tématu Prostředky DSC.
- Vyhledejte konfigurace A prostředky DSC v Galerie prostředí PowerShell.