Chocolatey integrates with several infrastructure automation tools!
With most of these tools, the interface you would interact with Chocolatey would be through the tool or through the interfaces of the tool, like in scripts.
- Summary
- Ansible
- Boxstarter
- Chef
- Octopus Deploy
- Otter
- PowerShell DSC
- PowerShell PackageManagement
- PSDeploy
- Puppet
- Saltstack
- System Center Configuration Manager
For common integrations, it's handy to refer to the table below to know what configuration manager to choose. Most of the implementations below are written and managed by the companies behind the product. These implementations are typically open source and each part could be added by community contributions for those familiar with the code implementations. If you are unable to provide code implementations for adding necessary functionality to the integrations, we find it best if you create issues/tickets with those organizations if you are a customer as you will have more leverage into getting them implemented. NOTE: If you are a configuration manager company identified in the table and you have implemented anything in the below or you find our information is incorrect, please let us know so we can get it fixed.
Configuration Managers | Ansible | Chef | PowerShell DSC | Puppet | Salt | Otter |
---|---|---|---|---|---|---|
Manage Packages | x | x | x | x | x | x |
Install Chocolatey | x | x | x | x | x | x |
Install Chocolatey from internal source | x | x | x | x | x | |
Manage Sources | x | x | x | x | x | x |
Manage Source Type (Admin/Self-Service) | x | x | ||||
Manage Features | x | x | x | x | ||
Manage Config Settings | x | x | x |
NOTE: Each x is linked to the specific feature documentation.
For most of these, those configuration managers have some sort of exec you could use to manage those additional aspects, but it would be best if they supported all aspects of configuration of Chocolatey as part of the provider implementations.
Ansible has the win_chocolatey
module that manages both packages and the installation of Chocolatey itself.
win_chocolatey:
name: git
source: https://my.internal.repository/api/v2/
Boxstarter is a lightweight configuration management utility.
Repeatable, reboot resilient Windows environment installations made easy using Chocolatey packages. When its time to repave either bare metal or virtualized instances, locally or on a remote machine, Boxstarter can automate both trivial and highly complex installations. Compatible with all Windows versions from Windows 7/2008 R2 forward.
Chef 12.7+ has a built-in chocolatey_package
resource to use with Chocolatey.
chocolatey_package 'git' do
action :install
source 'https://my.internal.repository/api/v2'
end
When you need to also install Chocolatey, you would use the community cookbook to do so. The cookbook is maintained by the Chocolatey team. It has a package resource that can be used with older Chef versions.
include_recipe 'chocolatey'
Here's a more in depth example from Nordstrom:
include_recipe 'chocolatey'
home = Dir.home
%W(
#{home}/.chef
#{home}/chef
#{home}/chef/cookbooks
).each do |directory|
directory directory
end
packages = node['chefdk_bootstrap']['package']
packages.each do |pkg, install|
include_recipe "#{cookbook_name}::#{pkg}" if install
end
Another example from Facebook:
node.default['cpe_choco']['sources']['bacon'] =
'source' => 'http://bacon.es.yummy',
}
Octopus is a friendly deployment automation tool for .NET developers. It integrates with lots of utilities, and they have a template for installing Chocolatey packages: https://library.octopusdeploy.com/step-template/actiontemplate-chocolatey-install-package
Otter has an open source Chocolatey extension that allows installing and uninstalling packages, specifying package versions, chocolatey sources, chocolatey features, and installing chocolatey istelf.
Otter also keeps an inventory of Chocolatey packages installed on any or all servers.
Chocolatey::Ensure-Package
(
Name: 7zip.install,
Version: 18.5,
Source: https://proget.local/chocolatey
);
Chocolatey::Ensure-Installed
(
Version: latest,
Source: https://proget.local/chocolatey
);
Chocolatey::Ensure-Source
(
Name: Internal,
Url: https://proget.local/chocolatey,
Credential: DomainCred
);
Chocolatey::Ensure-Feature
(
Feature: checksumFiles,
Enabled: false
);
PowerShell DSC (Desired State Configuration) has a cChoco module that can manage both packages and the installation of Chocolatey itself.
cChocoInstaller installChoco
{
InstallDir = "c:\ProgramData\chocolatey"
}
cChocoPackageInstaller installGit
{
Name = "git"
DependsOn = "[cChocoInstaller]installChoco"
}
NOTE: Chocolatey has a prototype provider for the built-in package manager on Windows 10/Windows Server 2016 that was created by Microsoft awhile back. It is not fully functional and it may have security issues. If you want to use Chocolatey with PackageManagement, we recommend using ChocolateyGet, which is a nice bridge until an official one is implemented. No ETA has been defined.
PowerShell PackageManagement (aka OneGet) is a package manager aggregator that depends on the existence of package managers as providers to work, one of which is Chocolatey. For a pretty comprehensive post about what PackageManagement is and what it is not, see the PackageManagement Blog post on 10 things about OneGet that are completely different than you think.
PSDeploy is a quick and dirty module to simplify PowerShell based deployments.
Deploy SingleChocolateyPackage {
By Chocolatey {
FromSource 'c:\ChocolateyPackages\examplepackage.0.1.1.nupkg'
To "http://your-choco-repo.internal.com/"
WithOptions @{
ApiKey = 'yourAPIkey'
Force = $true
}
}
}
Puppet has a Supported module for Chocolatey puppetlabs/chocolatey
. Note that there is also a chocolatey/chocolatey
module, the supported module is a drop in replacement for the chocolatey/chocolatey
module - please use puppetlabs/chocolatey
as it has full configuration of Chocolatey.
include chocolatey
package { 'git':
ensure => latest,
provider => 'chocolatey',
source => 'https://my.internal.repository/api/v2',
}
Puppet has some great documentation on getting started with Chocolatey. Be sure to check that out at Using Windows modules.
The Chocolatey team is most familiar with Puppet and has written some documentation for using Puppet with Chocolatey. Please see
Note: if anyone would be interested in providing documentation similar to the above for other frameworks, we'd accept it as Pull Requests at https://github.com/chocolatey/choco-wiki.
Salt has a Chocolatey module that manages both packages and the installation of Chocolatey itself.
salt '*' chocolatey.bootstrap
salt '*' chocolatey.install git
Chocolatey integrates with SCCM by handling the software management, and pointing to distribution points as the source for packages. This allows folks to get packages and larger binaries out to their network without constraints and still take advantage of Chocolatey's fantastic abilities!
To direct Chocolatey package installs, you can still write GPOs to ensure this.