Chocolatey Quick Deployment Environment (QDE)
This is an overview on the Chocolatey Quick Deployment Environment (QDE). It provides a single virtual machine appliance to be imported into your hypervisor-of-choice, which contains most of the various components of a Chocolatey organizational solution.
- QDE Components
- Getting QDE
- Related Articles
The QDE appliance provides a unified architecture containing the following components:
- Sonatype Nexus Repository OSS (pre-configured with repositories) - This is your repository, where you'll be storing your Chocolatey packages (nupkg files).
- Jenkins (pre-configured with internalizer jobs) - This is your automation engine, that lets you run tasks on-demand and on a schedule. It will host the PowerShell scripts to help you auto-internalize packages from the Chocolatey Community Repository
- Chocolatey Central Management - This is your web dashboard for Chocolatey, that will allow you to track and monitor Chocolatey packages on your endpoint clients. You can see what packages are installed where, and whether or not they are out-of-date.
- Scripts for Internal Deployment - Various scripts to help you configure this solution are included, for your convenience.
This solution targets environments up to about 1000 nodes.
If you need a solution for a larger environment, QDE would still be suitable as a proof-of-concept, however, best practices would recommend a distributed infrastructure, separating each component into its own discrete node.
If you find yourself in need of a more scalable solution, please contact Support and we'll be more than happy to provide guidance for larger solutions.
To get QDE into your environment, please reach out to us and we can work to get you set up.
📝 NOTE: A QDE environment is a fully functional Chocolatey for Business (C4B) environment, as such it will require a business or trial license.
- QDE Setup
- QDE Desktop ReadMe File (included here for convenience)
- QDE SSL/TLS Setup
- QDE Firewall Changes
- QDE Client Setup (setting up your client machines)
- Upgrading? See How do I upgrade QDE?.
A lot of what is done in QDE compresses the work or completely removes the work found in these related articles.
- Organizational Deployment Guide
- Chocolatey Installation
- Chocolatey Commercial Installation
- Automate Package Internalization
📝 NOTE: If you find that QDE is only good for a proof-of-concept in your environment due to having thousands of endpoints, you will want to understand how to scale out that infrastructure. The above articles address how that is done.
What does the QDE (Quick Deployment Environment) include?
- Repository Server - Nexus (pre-configured with repositories)
- Automation Pipelines - Jenkins (pre-configured with internalizer jobs)
- Chocolatey Central Management
- Package Builder / Package Internalizer
- All the goodness of that sweet, sweet automation in Chocolatey.
- Scripts for Internal Deployment
How much time does this save?
Typically, setting up a proper Chocolatey Central Management server and any accompanying infrastructure takes somewhere between 1-5 days, even when you have everything you need to get started. Setting up a new piece of infrastructure can be pretty cumbersome, we know. The QDE contains pretty much everything you need to get started in a single image, all ready to go. At most, it should only take a couple of hours to get everything ready to go from there.
How do we take advantage of QDE?
You must have a Business edition of Chocolatey or be on an active trial license. Fill out the quick deployment request form and we will reach out with all the necessary information to get you started.
We're already a C4B customer?
Fill out the quick deployment request form and we will reach out with all the necessary information to get you started. Be sure to mention you are already a C4B customer.
How do we upgrade QDE?
While we will continue to make improvements to the QDE, there is no upgrade path for the Virtual Machine itself. You can choose to start over with a newer version, but that feels like the wrong way to go.
It is simple to upgrade the components and that it how we recommend upgrading aspects of QDE. Should you want to upgrade say Central Management, you can follow the Central Management steps for upgrade at Upgrade Central Management.
What if we have a larger environment? (> 1k nodes)
While this solution will be great to get a glimpse of what Chocolatey can really do for you, by its nature it isn't the silver bullet for every environment.
If you have a larger environment, we would strongly recommend taking the time to set up the various services on separate hosts to make them easier to manage and ensure they have the necessary resources to handle heavier loads.
Can we brag about how fast we were able to get configured?
Please do! 🙂