Compartilhar via

Empacotar e carregar recursos em um servidor de pull

  • Artigo

As seções a seguir pressupõem que você já tenha configurado um servidor de pull. Se ainda não configurou, use os guias a seguir:

Cada nó de destino pode ser configurado para baixar configurações, recursos e até mesmo relatar seu status. Este artigo mostrará como carregar recursos para que fiquem disponíveis para download e como configurar clientes para baixar os recursos automaticamente. Quando o nó recebe uma configuração atribuída, por meio de Pull ou Push (v5), ele baixa automaticamente todos os recursos necessários para a configuração do local especificado no LCM.

Módulos do recurso Package

Cada recurso disponível para um cliente fazer download deve ser armazenado em um arquivo .zip. O exemplo a seguir mostra as etapas necessárias usando o recurso xPSDesiredStateConfiguration.

Observação

Se você tem clientes que usam o PowerShell 4.0, é preciso reduzir a estrutura da pasta de recursos e remover as pastas de versão. Para saber mais, confira Várias versões do recurso.

Você pode compactar o diretório de recursos usando qualquer utilitário, script ou método que preferir. No Windows, clique com o botão direito do mouse no diretório xPSDesiredStateConfiguration e selecione Enviar para e em Pasta compactada.

Clique com o botão direito do mouse – Enviar para – Pasta compactada

Nomear o arquivo de recurso

O arquivo de recurso precisa ser nomeado com o seguinte formato:

{ModuleName}_{Version}.zip

No exemplo acima, xPSDesiredStateConfiguration.zip deve ser renomeado como xPSDesiredStateConfiguration_8.4.4.0.zip.

Criar somas de verificação

Quando o módulo de recurso estiver compactado e renomeado, é preciso criar uma soma de verificação. A soma de verificação é usada pelo LCM no cliente, para determinar se o recurso foi alterado e precisa ser baixado novamente. Você pode criar uma soma de verificação com o cmdlet New-DSCCheckSum, como mostrado no exemplo a seguir.

New-DscChecksum -Path .\xPSDesiredStateConfiguration_8.4.4.0.zip

Nenhuma saída é exibida, mas agora você deve ver "xPSDesiredStateConfiguration_8.4.4.0.zip.checksum". Também pode executar New-DSCCheckSum em um diretório de arquivos usando o parâmetro -Path. Se já existir uma soma de verificação, é possível forçá-la a ser criada novamente com o parâmetro -Force.

Onde armazenar os arquivos de recurso

Em um servidor de pull HTTP de DSC

Ao configurar seu servidor de Pull HTTP, conforme explicado em Configurar um servidor de pull HTTP de DSC, você especifica diretórios para as chaves ModulePath e ConfigurationPath. A chave ConfigurationPath indica onde todos os arquivos ".mof" devem ser armazenados. O ModulePath indica onde os módulos de recursos DSC devem ser armazenados.

    xDscWebService PSDSCPullServer
    {
    ...
        ModulePath              = "$env:PROGRAMFILES\WindowsPowerShell\DscService\Modules"
        ConfigurationPath       = "$env:PROGRAMFILES\WindowsPowerShell\DscService\Configuration"
    ...
    }

Em um compartilhamento SMB

Se você especificou um ResourceRepositoryShare ao configurar o seu cliente de pull, armazene os arquivos e as somas de verificação no diretório SourcePath do bloco ResourceRepositoryShare.

ConfigurationRepositoryShare SMBPullServer
{
    SourcePath = '\\SMBPullServer\Configurations'
}

ResourceRepositoryShare SMBResourceServer
{
    SourcePath = '\\SMBPullServer\Resources'
}

Se você especificou apenas um ConfigurationRepositoryShare ao configurar o seu cliente de pull, armazene os arquivos e as somas de verificação no diretório SourcePath do bloco ConfigurationRepositoryShare.

ConfigurationRepositoryShare SMBPullServer
{
    SourcePath = '\\SMBPullServer\Pull'
}

Atualização de recursos

Você pode forçar um nó a atualizar seus recursos alterando o número de versão no nome de arquivo ou criando uma nova soma de verificação. O cliente de pull verifica se há versões mais recentes dos recursos necessários e somas de verificação atualizadas quando o LCM é atualizado.

Confira também