Installs Terraform by HashiCorp.
Terraform is an open source tool that allows you to configure entire infrastructure stack as code.
As of v2.1.1, the ownership of this cookbook was transferred to haidangwa. From this point forward, all issues and pull requests should be submitted at https://github.com/haidangwa/chef-terraform.
As of version 2.0.0, this cookbook will require minimum chef-client 13
This cookbook depends on the ark cookbook to unpackage and install terraform.
** GPG ** As of this writing (5/24/18), the community gpg cookbook that is released in Supermarket was transferred to the sous-chef group for ownership. However, the features that this cookbook relies on is not yet published. Therefore, if you run this cookbook, be sure to use berkshelf to ensure that the correct cookbook dependencies are uploaded to your chef org.
If you see the error below, it is a result of using the published 0.3.0 version of gpg from supermarket.chef.io and not the github referenced commit.
================================================================================
Recipe Compile Error in /tmp/kitchen/cache/cookbooks/terraform/recipes/default.rb
================================================================================
NoMethodError
-------------
undefined method `gpg_install' for cookbook: terraform, recipe: gpgme :Chef::Recipe
Cookbook Trace:
---------------
/tmp/kitchen/cache/cookbooks/terraform/recipes/gpgme.rb:34:in `from_file'
/tmp/kitchen/cache/cookbooks/terraform/recipes/default.rb:23:in `from_file'
Relevant File Content:
----------------------
/tmp/kitchen/cache/cookbooks/terraform/recipes/gpgme.rb:
34>> gpg_install 'gnupg2 and haveged'
35:
This cookbook's Berksfile contains this reference to the current version of gpg in github:
cookbook 'gpg', git: 'https://github.com/sous-chefs/gpg',
ref: '2f682a1406047e99351d184fe18fff035a0c856c'
The following platforms are supported and have been tested under Test Kitchen:
- CentOS 6.9
- CentOS 7.4
- Debian 8.6
- Fedora 27
- Ubuntu 16.04
- Ubuntu 18.04
Other versions of these OSs should work. Alternative Debian and RHEL family distributions are also assumed to work. Please report any additional platforms you have tested so they can be added.
** Note for Debian:
dayne has found that this cookbook may not converge on Debian platforms. This can be fixed by doing running apt update, and then it will converge. This workaround has been applied to Test Kitchen by invoking the terraform_test::ubuntu recipe.
Simply include recipe[terraform] in your run_list to have
Terraform installed. If you are using an artifact repository, like Nexus, hosted behind your corporate firewall, you must set the default attribute or override attributes in your roles or environments. The attributes are detailed velow.
Installs Terraform from official pre-compiled binaries and gnupg with the gpgme recipe, below.
Installs gnupg2 and haveged to ensure the checksums file from HashiCorp can be trusted. This recipe is included when the default recipe is added to your node's run list.
If you are using an artifact repository, like Nexus, hosted behind your corporate firewall, you must set the default attribute or override attributes in your roles or environments.
Default: https://releases.hashicorp.com/terraform
The version of Terraform that will be installed (Default: 0.11.7)
As of v0.4.1, checksums are processed dynamically. There is no longer a need to specify the sha256 checksums of each terraform package in a cookbook attribute manually
_As of v1.0.0, the checksum file will have its gpg signature verified. If the gpg signature is rejected, the chef run will fail.
NOTE: All other attributes are considered internal and shouldn't normally need to be changed.
{
"name": "terraform_workstation",
"description": "Role to apply onto a terraform workstation",
"json_class": "Chef::Role",
"default_attributes": {
"terraform": {
"url_base": "https://nexus.internal.com/nexus",
"version": "0.11.7"
}
},
"override_attributes": {},
"run_list": [
"recipe[terraform]"
]
}- Source hosted at GitHub
- Report issues/questions/feature requests on GitHub Issues
This cookbook, especially the checksum stuff in attributes file has been influenced by the Packer cookbook by @sit.
Author:: Ross Timson <[email protected]>
Contributor:: Dang Nguyen <[email protected]>
Copyright 2014, Ross Timson
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.