Skip to content

Automation resources for working with PowerShell Desired State Configuration (DSC).

License

Notifications You must be signed in to change notification settings

BernieWhite/DevOpsKitDsc

Repository files navigation

DevOps Kit for Dsc

This DevOps Kit for Desired State Configuration (DOKD) aims to provide IT Pros with tools and documentation to easily adopt a DevOps model for deploying and managing Desired State Configuration (DSC).

DSC already provides the tools for IT Pros to automate the configuration of Windows or Linux to stand-up a fully running workload. Application Lifecycle Management (ALM) tools such as Visual Studio Team Services (VSTS) also provide features such as requirements tracking, version control and release management.

AppVeyor (Windows) Codecov (Windows)
av-image cc-image

Disclaimer

This project is to be considered a proof-of-concept and not a supported Microsoft product.

Modules

The following modules are included in this repository.

Module Description Latest version
DevOpsKitDsc Automate releases of Desired State Configuration configurations psg-dokdsc-version-badge psg-dokdsc-installs-badge

Features

  • DevOps
  • Collections
    • Group configuration and nodes into collections that can be built together.
  • Build
    • Restore module dependencies.
    • Build only changed nodes with incremental build.
    • Build documentation together with DSC configurations.
  • Node configuration data
    • Use flat configuration data structure for a single node.
    • Use your choice of PSD1 or JSON files for storing node data.
  • Release
    • Package configurations and resource modules ready for a local pull server or Azure Automation Service.

Getting started

Getting the module

# Install the module
Install-Module -Name 'DevOpsKitDsc';
  • Save for offline use from PowerShell Gallery
# Save the DevOpsKitDsc module, in the .\modules directory
Save-Module -Name 'DevOpsKitDsc' -Path '.\modules';

Getting Visual Studio Code integration

# Install the extension
code --install-extension bewhite.dokd-vscode-preview

Building a cloned git repository

Get a sample configuration repository and build the configurations.

# Use git to clone the repository
git clone https://github.com/BernieWhite/DevOpsKitDsc-samples.git;

cd .\DevOpsKitDsc-samples

# Restore dependency modules to the workspace
Restore-DOKDscModule;

# Build all collections
Invoke-DOKDscBuild;

Detailed instructions

For detailed instructions please see getting started documentation here.

Commands

Related projects

Project name Description
DevOpsKitDsc-vscode A Visual Studio Code extension for DOKD
DevOpsKitDsc-samples A sample DOKD repository
PSDocs A PowerShell module to generate markdown from pipeline objects

Maintainers

License

This project is licensed under the MIT License.