Skip to content
Chef knife plug-in for Microsoft Azure
Ruby Shell
Branch: master
Clone or download
tas50 Simplify the gemfile for dependabot
Use dependabot to manage our version deps

Signed-off-by: Tim Smith <>
Latest commit 1a3db0c Oct 14, 2019
Type Name Latest commit message Commit time
Failed to load latest commit information.
.expeditor Add github templates Apr 6, 2019
.github Add github templates Apr 6, 2019
docs Minor changes as per the review comments Jul 9, 2019
lib Bump version to 2.0.2 by Chef Expeditor Sep 10, 2019
spec Minor Fixes while displaying Error Messages Aug 30, 2019
.gitignore Issue 205: Allowing TCP and UDP endpoint param string to also specify… Mar 17, 2015
.rspec Test on modern ruby and use doc formatter for rspec Sep 23, 2016
.travis.yml Initial commit to support Chef-15. May 27, 2019 Update to reflect the promotion of 2.0.2 Sep 10, 2019 Add a code of conduct file Dec 7, 2018 Require Ruby 2.3+ and fix Chefstyle offenses (#494) Dec 18, 2018
Gemfile Simplify the gemfile for dependabot Oct 14, 2019
Guardfile Require Ruby 2.3+ and fix Chefstyle offenses (#494) Dec 18, 2018
LICENSE Releasing under Apache 2.0 license Jun 6, 2012 DOC updates for OSS Best Practices Aug 12, 2019 Updated release doc for version 1.8.0 release (#452) Sep 28, 2017
Rakefile Updated License and ensured chefstyle Jun 27, 2019
VERSION Bump version to 2.0.2 by Chef Expeditor Sep 10, 2019
knife-azure.gemspec Minor changes as per the review comments Jul 9, 2019

Knife Azure

Gem Version Build Status

Umbrella Project: Knife

Project State: Active

Issues Response Time Maximum: 14 days

Pull Request Response Time Maximum: 14 days


A knife plugin to create, delete, and enumerate Microsoft Azure resources to be managed by Chef.

NOTE: You may also want to consider using the Azure CLI, this application is written by the Azure team and has many other integrations with Azure. If click here you'll see deeper examples of using the Chef extension and Azure.


Be sure you are running the latest version of Chef DK, which can be installed via:

This plugin is distributed as a Ruby Gem. To install it, run:

chef gem install knife-azure

Depending on your system's configuration, you may need to run this command with root/administrator privileges.


knife-azure 1.6.0 onwards supports Azure Resource Manager (preferred). You can easily switch between:

  • Resource manager: commands using the Azure Resource Manager API
  • Service management: commands using the Azure service management API

They are not designed to work together. Commands starting with knife azurerm use ARM mode, while commands starting with knife azure use ASM mode.


  1. ARM Configuration
  2. ASM Configuration

Detailed Usage

  1. ARM Mode
  2. ASM Mode

Bootstrap existing VM to install the chef-client using chef-extension

We have added a utility in ARM and ASM to bootstrap existing VM. This will install the chef-client using chef extension on your VM.

  1. Bootstrap Doc for ARM Mode
  2. Bootstrap Doc for ASM Mode


For information on contributing to this project see


Copyright:: Copyright 2010-2019, Chef Software, Inc.

License:: Apache License, Version 2.0

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
See the License for the specific language governing permissions and
limitations under the License.
You can’t perform that action at this time.