Adoptable Cookbooks List

Looking for a cookbook to adopt? You can now see a list of cookbooks available for adoption!
List of Adoptable Cookbooks

Supermarket Belongs to the Community

Supermarket belongs to the community. While Chef has the responsibility to keep it running and be stewards of its functionality, what it does and how it works is driven by the community. The chef/supermarket repository will continue to be where development of the Supermarket application takes place. Come be part of shaping the direction of Supermarket by opening issues and pull requests or by joining us on the Chef Mailing List.

Select Badges

Select Supported Platforms


azure_pipelines_agent_macos (6) Versions 3.0.0

A dedicated cookbook for configuring an Azure DevOps build or release agent on macOS.

cookbook 'azure_pipelines_agent_macos', '= 3.0.0'
cookbook 'azure_pipelines_agent_macos', '= 3.0.0', :supermarket
knife supermarket install azure_pipelines_agent_macos
knife supermarket download azure_pipelines_agent_macos
Quality 50%

Azure DevOps Build and Release Agent Cookbook for macOS

Build status

Visual Studio Team Services is now Azure DevOps Services We're working on the best way to rename the cookbook and recipes while maintaining backwards compatibility.



Usage: azure_piplines_agent_macos::bootstrap

Add the node to the agent pool or deployment group.


Usage: azure_piplines_agent_macos::teardown

Remove an existing agent from the build pool or deployment group.


Agent Name

The name of the agent.

Default value: node['hostname']


Agent Version

The version of the agent to install.

Default value: '2.150.3'


Agent Pool

The name of the agent pool you wish to add the agent to.

Default value: American Hanko's Agents


Organization Name

The name of your Azure DevOps organization. (e.g. 'americanhanko' in

Default value: americanhanko


Admin User

The username of an adminstrator on the macOS system.

Default value: 'vagrant'


Agent Home Directory

The location that contains all builds, source, release, etc.

Default value: '/Users/#{node['azure_piplines_agent']['admin_user']}/azure-piplines-agent'


Additional Environment Variables

An optional hash may be set to pass environment variables to the agent. The agent will then be configured with these environment variables which it will then report back to the servers.

Default value: {}


Deployment Group

This cookbook supports adding agents to Azure DevOps deployment groups. To use this feature, simply set the default['azure_piplines_agent']['deployment_group'] attribute. In addition, make sure you have the appropriate values set for the following attributes shown below. By default, we assume that if the default['azure_piplines_agent']['deployment_group'] attribute is nil, we are bootstrapping a build agent and not a deployment agent. This means if you set this attribute, it will override the default functionality. You may optionally specifiy deployment group tags using default['azure_piplines_agent']['deployment_group_tags'].

default['azure_piplines_agent']['deployment_group'] = nil
default['azure_piplines_agent']['project'] = nil
default['azure_piplines_agent']['work'] = nil
default['azure_piplines_agent']['deployment_group_tags'] = nil


This cookbook uses a personal access token to authenticate to your organization on the Azure DevOps servers. The cookbook allows access to the token via either an attribute, within a data bag or using a chef vault item.

Plaintext Attribute


default['azure_piplines_agent']['pat'] = '0fbdebc988934add98179ddaae019a01711'

Data Bag or Chef Vault Item

Name your vault or bag and corresponding item whatever you like and make sure to set the corresponding attributes to reference it accordingly:


default['azure_piplines_agent']['data_bag'] = 'tea_bag'
default['azure_piplines_agent']['data_bag_item'] = 'green_tea'

However, it must contain a personal_access_token key with the token itself as the value. The token must have rights to read and modify build agents. The permissions are selected at the time of the PAT creation, which you can read more about here.


  "id": "azure_piplines_build_agent",
  "personal_access_token": "iu8tfaxxrhce7yeu434yo9zfjtxif3jygzk24wegi855er2moobs"

Dependent cookbooks

tar ~> 2.0.0
homebrew ~> 5.0.0
chef-vault ~> 3.0.0

Contingent cookbooks

There are no cookbooks that are contingent upon this one.

Collaborator Number Metric

3.0.0 failed this metric

Failure: Cookbook has 0 collaborators. A cookbook must have at least 2 collaborators to pass this metric.

Contributing File Metric

3.0.0 failed this metric

Failure: To pass this metric, your cookbook metadata must include a source url, the source url must be in the form of, and your repo must contain a file

Foodcritic Metric

3.0.0 passed this metric

No Binaries Metric

3.0.0 passed this metric

Publish Metric

3.0.0 passed this metric

Supported Platforms Metric

3.0.0 passed this metric

Testing File Metric

3.0.0 failed this metric

Failure: To pass this metric, your cookbook metadata must include a source url, the source url must be in the form of, and your repo must contain a file

Version Tag Metric

3.0.0 failed this metric

Failure: To pass this metric, your cookbook metadata must include a source url, the source url must be in the form of, and your repo must include a tag that matches this cookbook version number