Chef knife plug-in for Microsoft Azure
Ruby
Switch branches/tags
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
docs
lib
spec upgrade vnet and subnet function and related specs Sep 18, 2017
.gitignore
.rspec
.travis.yml Test on the latest rubies and allow for Chef > 12 Jul 21, 2017
CHANGELOG.md
Gemfile removed listen gem conflict Jul 24, 2017
Guardfile initial deliverable from the contractor. Jun 6, 2012
LICENSE
README.md
RELEASE_NOTES.md
Rakefile added bundler/gem_tasks Jun 10, 2016
knife-azure.gemspec Merge pull request #445 from chef/happy/resolve_gem_conflicts Jul 25, 2017

README.md

Knife Azure

Gem Version Build Status

Description

A [knife] (http://docs.chef.io/knife.html) plugin to create, delete, and enumerate [Microsoft Azure] (https://azure.microsoft.com) 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.

Installation

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

https://downloads.chef.io/chef-dk/

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.

Modes

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.

Configuration

  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

Contributing

For information on contributing to this project see https://github.com/chef/chef/blob/master/CONTRIBUTING.md

License

Copyright:: Copyright (c) 2012-2016 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

    http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.