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

Select Status


tfc_agent (2) Versions 0.1.0

Installs and configures a Terraform Cloud agent

cookbook 'tfc_agent', '= 0.1.0', :supermarket
cookbook 'tfc_agent', '= 0.1.0'
knife supermarket install tfc_agent
knife supermarket download tfc_agent
Quality 50%


Chef cookbook to setup and run a Terraform Cloud agent using docker.

Getting Started

Follow the steps to Create a new Agent Token to obtain an agent token, add this recipe to your run list and set the token as the ['tfc_agent']['token'] attribute.



The tfc_agent resource is responsible for fetching and running a Terraform Cloud Agent docker image.


default_action :run

  • :create - Pulls the container image.
  • :start - Starts running the container.
  • :run - The default action. Does both :create and :start in a single in action.
  • :stop - Stops the running container.
  • :remove - Removes the cached image.


The name property is used to set the

  • image - The container image to use. Defaults to hashicorp/tfc-agent.
  • tag - The image tag to use. Defaults to latest.
  • token - The agent token to use.


Minimal usage:

tfc_agent "MyOrgAgent" do
  token 123123123...

Complete example:

tfc_agent "MyCustomAgent" do
  image 'myorg/tfc-agent'
  tag   '2.0'
  token 123123123...


This cookbook uses Semantic Versioning 2.0.0.

Given a version number MAJOR.MINOR.PATCH, increment the:

  • MAJOR version when you make functional cookbook changes,
  • MINOR version when you add functionality in a backwards-compatible manner,
  • PATCH version when you make backwards-compatible bug fixes.


We welcome contributed improvements and bug fixes via the usual work flow:

  1. Fork this repository
  2. Create your feature branch (git checkout -b my-new-feature)
  3. Commit your changes (git commit -am 'Add some feature')
  4. Push to the branch (git push origin my-new-feature)
  5. Create a new pull request

License and Authors

Authors and contributors:

Copyright 2020 Stephen Hoekstra 
Copyright 2020 Schuberg Philis

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.

Dependent cookbooks

docker ~> 7.2

Contingent cookbooks

There are no cookbooks that are contingent upon this one.

tfc_agent CHANGELOG

This file is used to list changes made in each version of the tfc_agent cookbook.

0.1.0 (2020-11-09)

Initial release.

Collaborator Number Metric

0.1.0 failed this metric

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

Contributing File Metric

0.1.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

0.1.0 passed this metric

No Binaries Metric

0.1.0 passed this metric

Testing File Metric

0.1.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

0.1.0 passed this metric