Chocolatey Community Coffee Break

Join the Chocolatey Team on our regular monthly stream where we discuss all things Community, what we do, how you can get involved and answer your Chocolatey questions.

Learn More

Chocolatey Product Spotlight

Join the Chocolatey Team on our regular monthly stream where we put a spotlight on the most recent Chocolatey product releases. You'll have a chance to have your questions answered in a live Ask Me Anything format.

Learn More

Announcing Chocolatey Central Management 0.10.0

Livestream from
Thursday, 06 October 2022

We recently released our largest update to Chocolatey Central Management so far. Join Gary and Steph to find out more about Chocolatey Central Management and the new features and fixes we've added to this release.

Watch On-Demand
Chocolatey and Intune Overview

Webinar Replay from
Wednesday, 30 March 2022

At Chocolatey Software we strive for simple, and teaching others. Let us teach you just how simple it could be to keep your 3rd party applications updated across your devices, all with Intune!

Watch On-Demand
Chocolatey For Business. In Azure. In One Click.

Livestream from
Thursday, 9 June 2022

Join James and Josh to show you how you can get the Chocolatey For Business recommended infrastructure and workflow, created, in Azure, in around 20 minutes.

Watch On-Demand
The Future of Chocolatey CLI

Livestream from
Thursday, 04 August 2022

Join Paul and Gary to hear more about the plans for the Chocolatey CLI in the not so distant future. We'll talk about some cool new features, long term asks from Customers and Community and how you can get involved!

Watch On-Demand
Hacktoberfest Tuesdays 2022

Livestreams from
October 2022

For Hacktoberfest, Chocolatey ran a livestream every Tuesday! Re-watch Cory, James, Gary, and Rain as they share knowledge on how to contribute to open-source projects such as Chocolatey CLI.

Watch On-Demand
Chocolatey Product Spotlight: Chocolatey 1.2.0 and Chocolatey Licensed Extension 5.0.0

Livestream from
Thursday, 03 November 2022

Join Paul and Gary for this months Chocolatey product livestream where we look at the latest release of Chocolatey 1.2.0, Chocolatey Licensed Extension 5.0.0 and shine a spotlight on the new hook scripts functionality. This opens up so many possibilities for Chocolatey CLI users!

Watch On-Demand
Chocolatey Coding Livestream

Livestream from
Tuesday, 29 November 2022

Join Josh as he adds the ability to manage Chocolatey GUI config and features with the Chocolatey Ansible Collection.

Watch On-Demand
Introduction into Chocolatey with Veeam

Webinar from
Tuesday, 13 December 2022

Join Gary, Paul, and Maurice as they introduce and demonstrate how to use Chocolatey! Questions will be answered live in an Ask Me Anything format.

Watch On-Demand

Downloads:

1,009,927

Downloads of v 0.12.0-alpha1:

412

Last Update:

23 Oct 2018

Package Maintainer(s):

Software Author(s):

  • Mitchell Hashimoto
  • HashiCorp

Tags:

terraform hashicorp

Terraform

This is a prerelease version of Terraform.

  • 1
  • 2
  • 3

0.12.0-alpha1 | Updated: 23 Oct 2018

Downloads:

1,009,927

Downloads of v 0.12.0-alpha1:

412

Maintainer(s):

Software Author(s):

  • Mitchell Hashimoto
  • HashiCorp

Terraform 0.12.0-alpha1

This is a prerelease version of Terraform.

  • 1
  • 2
  • 3

This Package Contains an Exempted Check

Not All Tests Have Passed


Validation Testing Passed


Verification Testing Passed

Details

Scan Testing Exemption for this package version only:

Details
Learn More

Deployment Method: Individual Install, Upgrade, & Uninstall

To install Terraform, run the following command from the command line or from PowerShell:

>

To upgrade Terraform, run the following command from the command line or from PowerShell:

>

To uninstall Terraform, run the following command from the command line or from PowerShell:

>

Deployment Method:

NOTE

This applies to both open source and commercial editions of Chocolatey.

1. Enter Your Internal Repository Url

(this should look similar to https://community.chocolatey.org/api/v2/)


2. Setup Your Environment

1. Ensure you are set for organizational deployment

Please see the organizational deployment guide

2. Get the package into your environment

  • Open Source or Commercial:
    • Proxy Repository - Create a proxy nuget repository on Nexus, Artifactory Pro, or a proxy Chocolatey repository on ProGet. Point your upstream to https://community.chocolatey.org/api/v2/. Packages cache on first access automatically. Make sure your choco clients are using your proxy repository as a source and NOT the default community repository. See source command for more information.
    • You can also just download the package and push it to a repository Download

3. Copy Your Script

choco upgrade terraform -y --source="'INTERNAL REPO URL'" --version="'0.12.0-alpha1'" --prerelease [other options]

See options you can pass to upgrade.

See best practices for scripting.

Add this to a PowerShell script or use a Batch script with tools and in places where you are calling directly to Chocolatey. If you are integrating, keep in mind enhanced exit codes.

If you do use a PowerShell script, use the following to ensure bad exit codes are shown as failures:


choco upgrade terraform -y --source="'INTERNAL REPO URL'" --version="'0.12.0-alpha1'" --prerelease
$exitCode = $LASTEXITCODE

Write-Verbose "Exit code was $exitCode"
$validExitCodes = @(0, 1605, 1614, 1641, 3010)
if ($validExitCodes -contains $exitCode) {
  Exit 0
}

Exit $exitCode

- name: Install terraform
  win_chocolatey:
    name: terraform
    version: '0.12.0-alpha1'
    source: INTERNAL REPO URL
    state: present
    allow_prerelease: yes

See docs at https://docs.ansible.com/ansible/latest/modules/win_chocolatey_module.html.


chocolatey_package 'terraform' do
  action    :install
  source   'INTERNAL REPO URL'
  version  '0.12.0-alpha1'
  options  '--prerelease'
end

See docs at https://docs.chef.io/resource_chocolatey_package.html.


cChocoPackageInstaller terraform
{
    Name        = "terraform"
    Version     = "0.12.0-alpha1"
    Source      = "INTERNAL REPO URL"
    chocoParams = "--prerelease"
}

Requires cChoco DSC Resource. See docs at https://github.com/chocolatey/cChoco.


package { 'terraform':
  ensure          => '0.12.0-alpha1',
  install_options => ['--prerelease'],
  provider        => 'chocolatey',
  source          => 'INTERNAL REPO URL',
}

Requires Puppet Chocolatey Provider module. See docs at https://forge.puppet.com/puppetlabs/chocolatey.


4. If applicable - Chocolatey configuration/installation

See infrastructure management matrix for Chocolatey configuration elements and examples.

Package Approved

This package was approved as a trusted package on 23 Oct 2018.

Description

Terraform is a tool for building, changing, and versioning infrastructure safely and efficiently. Terraform can manage existing and popular service providers as well as custom in-house solutions.

The key features of Terraform are:

  • Infrastructure as Code: Infrastructure is described using a high-level configuration syntax. This allows a blueprint of your datacenter to be versioned and treated as you would any other code. Additionally, infrastructure can be shared and re-used.
  • Execution Plans: Terraform has a "planning" step where it generates an execution plan. The execution plan shows what Terraform will do when you call apply. This lets you avoid any surprises when Terraform manipulates infrastructure.
  • Resource Graph: Terraform builds a graph of all your resources, and parallelizes the creation and modification of any non-dependent resources. Because of this, Terraform builds infrastructure as efficiently as possible, and operators get insight into dependencies in their infrastructure.
  • Change Automation: Complex changesets can be applied to your infrastructure with minimal human interaction. With the previously mentioned execution plan and resource graph, you know exactly what Terraform will change and in what order, avoiding many possible human errors.

For more information, see the introduction section of the Terraform website.


tools\chocolateyInstall.ps1
$checksum = 'a2a50de9ec4b8fe0ef4a9143007a885ab612703934f11f3fe051fb8832220591'
$checksum64 = '19da49c0983325c91c353e48bdb0beb95ab9d5f35117f47b001648351dd0a01c'
$version = '0.12.0-alpha1'
$url = "https://releases.hashicorp.com/terraform/$($version)/terraform_$($version)_windows_386.zip"
$url64bit = "https://releases.hashicorp.com/terraform/$($version)/terraform_$($version)_windows_amd64.zip"
$unzipLocation = "$(Split-Path -parent $MyInvocation.MyCommand.Definition)"

if ([System.IO.Directory]::Exists("$env:ChocolateyInstall\lib\terraform")) {
  if ([System.IO.Directory]::Exists("$env:ChocolateyInstall\lib\terraform\tools")) {
    # clean old plugins and ignore files
    Write-Host "Removing old terraform plugins"
    Remove-Item "$env:ChocolateyInstall\lib\terraform\tools\terraform-*.*"
  }
} else {
  if ([System.IO.Directory]::Exists("$env:ALLUSERSPROFILE\chocolatey\lib\terraform")) {
    if ([System.IO.Directory]::Exists("$env:ALLUSERSPROFILE\chocolatey\lib\terraform\tools")) {
      # clean old plugins and ignore files
      Write-Host "Removing old terraform plugins"
      Remove-Item "$env:ALLUSERSPROFILE\chocolatey\lib\terraform\tools" -Include "terraform-*.*"
    }
  }
}

Install-ChocolateyZipPackage -PackageName "terraform" -Url "$url" -UnzipLocation "$unzipLocation" -Url64 "$url64bit" -ChecksumType 'sha256' -Checksum "$checksum" -Checksum64 "$checksum64"
tools\chocolateyUninstall.ps1
UnInstall-ChocolateyZipPackage "terraform" "terraformInstall.zip"

Log in or click on link to see number of positives.

In cases where actual malware is found, the packages are subject to removal. Software sometimes has false positives. Moderators do not necessarily validate the safety of the underlying software, only that a package retrieves software from the official distribution point and/or validate embedded software against official distribution point (where distribution rights allow redistribution).

Chocolatey Pro provides runtime protection from possible malware.

Add to Builder Version Downloads Last Updated Status
Terraform 1.3.6 18224 Wednesday, December 14, 2022 Approved
Terraform 1.3.5 19213 Friday, November 18, 2022 Approved
Terraform 1.3.4 10074 Monday, November 7, 2022 Approved
Terraform 1.3.3 8280 Friday, October 28, 2022 Approved
Terraform 1.3.2 16518 Monday, October 10, 2022 Approved
Terraform 1.3.1 9375 Thursday, September 29, 2022 Approved
Terraform 1.3.0 7716 Thursday, September 22, 2022 Approved
Terraform 1.2.9 1920 Wednesday, September 21, 2022 Approved
Terraform 1.2.8 19835 Friday, August 26, 2022 Approved
Terraform 1.2.7 1578 Thursday, August 11, 2022 Approved
Terraform 1.2.6 14746 Monday, August 1, 2022 Approved
Terraform 1.2.5 5937 Friday, July 22, 2022 Approved
Terraform 1.2.4 10266 Tuesday, July 5, 2022 Approved
Terraform 1.2.3 13404 Wednesday, June 15, 2022 Approved
Terraform 1.2.2 13530 Wednesday, June 1, 2022 Approved
Terraform 1.2.1 7062 Tuesday, May 24, 2022 Approved
Terraform 1.2.0 4065 Thursday, May 19, 2022 Approved
Terraform 1.1.9 16683 Wednesday, April 20, 2022 Approved
Terraform 1.1.8 7779 Thursday, April 7, 2022 Approved
Terraform 1.1.7 19317 Sunday, March 6, 2022 Approved
Terraform 1.1.6 10676 Saturday, February 19, 2022 Approved
Terraform 1.1.5 10693 Friday, February 4, 2022 Approved
Terraform 1.1.4 10888 Saturday, January 22, 2022 Approved
Terraform 1.1.3 8939 Monday, January 10, 2022 Approved
Terraform 1.1.2 9107 Saturday, December 18, 2021 Approved
Terraform 1.1.1 132 Saturday, December 18, 2021 Approved
Terraform 1.1.0 6867 Wednesday, December 8, 2021 Approved
Terraform 1.0.11 19766 Saturday, November 13, 2021 Approved
Terraform 1.0.10 3620 Tuesday, November 9, 2021 Approved
Terraform 1.0.9 13331 Tuesday, October 19, 2021 Approved
Terraform 1.0.8 11331 Wednesday, September 29, 2021 Approved
Terraform 1.0.7 8530 Thursday, September 16, 2021 Approved
Terraform 1.0.6 5475 Wednesday, September 8, 2021 Approved
Terraform 1.0.5 652 Monday, August 23, 2021 Approved
Terraform 1.0.4 16504 Sunday, August 8, 2021 Approved
Terraform 1.0.3 6063 Thursday, July 29, 2021 Approved
Terraform 1.0.2 14555 Saturday, July 10, 2021 Approved
Terraform 1.0.1 12151 Monday, June 28, 2021 Approved
Terraform 1.0.0 10773 Tuesday, June 8, 2021 Approved
Terraform 0.15.5 1177 Tuesday, June 8, 2021 Approved
Terraform 0.15.4 3401 Monday, May 31, 2021 Approved
Terraform 0.15.3 12244 Friday, May 7, 2021 Approved
Terraform 0.15.2 14866 Friday, May 7, 2021 Approved
Terraform 0.15.1 4440 Tuesday, April 27, 2021 Approved
Terraform 0.15.0 5629 Wednesday, April 14, 2021 Approved
Terraform 0.14.11 4894 Tuesday, April 27, 2021 Approved
Terraform 0.14.10 10859 Wednesday, April 14, 2021 Approved
Terraform 0.14.9 5477 Tuesday, March 30, 2021 Approved
Terraform 0.14.8 10795 Monday, March 15, 2021 Approved
Terraform 0.14.7 10639 Thursday, February 18, 2021 Approved
Terraform 0.14.6 4565 Wednesday, February 10, 2021 Approved
Terraform 0.14.5 5984 Wednesday, January 27, 2021 Approved
Terraform 0.14.4 10634 Sunday, January 10, 2021 Approved
Terraform 0.14.3 5183 Sunday, December 20, 2020 Approved
Terraform 0.14.2 5526 Wednesday, December 9, 2020 Approved
Terraform 0.14.1 167 Wednesday, December 9, 2020 Approved
Terraform 0.14.0 2697 Tuesday, December 8, 2020 Approved
Terraform 0.13.7 9921 Tuesday, April 27, 2021 Approved
Terraform 0.13.6 1707 Sunday, January 10, 2021 Approved
Terraform 0.13.5 55102 Thursday, November 5, 2020 Approved
Terraform 0.13.4 10747 Wednesday, October 7, 2020 Approved
Terraform 0.13.3 9303 Friday, September 18, 2020 Approved
Terraform 0.13.2 15120 Wednesday, September 2, 2020 Approved
Terraform 0.13.1 431 Wednesday, September 2, 2020 Approved
Terraform 0.13.0 8888 Tuesday, August 11, 2020 Approved
Terraform 0.13.0-rc1 129 Monday, August 10, 2020 Approved
Terraform 0.13.0-beta3 396 Monday, July 13, 2020 Approved
Terraform 0.13.0-beta2 232 Thursday, June 25, 2020 Exempted
Terraform 0.13.0-beta1 299 Saturday, June 6, 2020 Exempted
Terraform 0.12.31 10793 Tuesday, April 27, 2021 Approved
Terraform 0.12.30 725 Sunday, January 10, 2021 Approved
Terraform 0.12.29 24226 Monday, August 10, 2020 Approved
Terraform 0.12.28 17221 Friday, June 26, 2020 Approved
Terraform 0.12.27 883 Thursday, June 25, 2020 Approved
Terraform 0.12.26 10827 Monday, June 1, 2020 Approved
Terraform 0.12.25 5884 Saturday, May 23, 2020 Approved
Terraform 0.12.24 22774 Tuesday, March 24, 2020 Approved
Terraform 0.12.23 1967 Wednesday, March 18, 2020 Approved
Terraform 0.12.21 11661 Friday, February 21, 2020 Approved
Terraform 0.12.20 11433 Friday, January 24, 2020 Approved
Terraform 0.12.19 6424 Friday, January 10, 2020 Approved
Terraform 0.12.18 10495 Friday, December 13, 2019 Approved
Terraform 0.12.17 4883 Tuesday, December 3, 2019 Approved
Terraform 0.12.16 3701 Tuesday, November 26, 2019 Approved
Terraform 0.12.15 214 Tuesday, November 26, 2019 Approved
Terraform 0.12.14 509 Tuesday, November 26, 2019 Approved
Terraform 0.12.13 9107 Monday, November 4, 2019 Approved
Terraform 0.12.12 6904 Monday, October 21, 2019 Approved
Terraform 0.12.11 215 Monday, October 21, 2019 Approved
Terraform 0.12.10 2938 Thursday, October 10, 2019 Approved
Terraform 0.12.9 9118 Wednesday, September 18, 2019 Approved
Terraform 0.12.8 3687 Friday, September 6, 2019 Approved
Terraform 0.12.7 4741 Friday, August 23, 2019 Approved
Terraform 0.12.6 4905 Friday, August 2, 2019 Approved
Terraform 0.12.5 3392 Friday, July 19, 2019 Approved
Terraform 0.12.4 1199 Monday, July 15, 2019 Approved
Terraform 0.12.3 3871 Tuesday, June 25, 2019 Approved
Terraform 0.12.2 2425 Thursday, June 13, 2019 Approved
Terraform 0.12.1 1974 Wednesday, June 5, 2019 Approved
Terraform 0.12.0 3357 Wednesday, May 22, 2019 Approved
Terraform 0.12.0-beta1 318 Tuesday, April 2, 2019 Approved
Terraform 0.12.0-alpha4 455 Friday, December 28, 2018 Approved
Terraform 0.12.0-alpha3 216 Friday, December 28, 2018 Approved
Terraform 0.12.0-alpha2 234 Friday, December 28, 2018 Approved
Terraform 0.12.0-alpha1 412 Tuesday, October 23, 2018 Approved
Terraform 0.11.15 3624 Tuesday, April 27, 2021 Approved
Terraform 0.11.14 27628 Wednesday, May 22, 2019 Approved
Terraform 0.11.13 15543 Tuesday, April 2, 2019 Approved
Terraform 0.11.12 229 Tuesday, April 2, 2019 Approved
Terraform 0.11.11 16060 Friday, December 28, 2018 Approved
Terraform 0.11.10 493 Friday, December 28, 2018 Approved
Terraform 0.11.9 7125 Tuesday, October 23, 2018 Approved
Terraform 0.11.8 23983 Thursday, August 30, 2018 Approved
Terraform 0.11.7 9015 Monday, April 16, 2018 Approved
Terraform 0.11.6 977 Saturday, April 7, 2018 Approved
Terraform 0.11.5 993 Wednesday, March 28, 2018 Approved
Terraform 0.11.4 708 Monday, April 16, 2018 Approved
Terraform 0.11.3 2819 Friday, February 16, 2018 Approved
Terraform 0.11.2 1978 Saturday, January 13, 2018 Approved
Terraform 0.11.1 1882 Thursday, December 7, 2017 Approved
Terraform 0.11.0 1394 Wednesday, November 22, 2017 Approved
Terraform 0.10.8 1883 Tuesday, October 31, 2017 Approved
Terraform 0.10.7 1353 Tuesday, October 3, 2017 Approved
Terraform 0.10.6 1517 Wednesday, September 20, 2017 Approved
Terraform 0.10.5 360 Wednesday, September 20, 2017 Approved
Terraform 0.10.4 366 Wednesday, September 20, 2017 Approved
Terraform 0.10.3 1138 Friday, September 1, 2017 Approved
Terraform 0.10.2 669 Thursday, August 24, 2017 Approved
Terraform 0.10.1 357 Thursday, August 24, 2017 Approved
Terraform 0.10.0 1030 Thursday, August 3, 2017 Approved
Terraform 0.10.0-rc1 428 Wednesday, August 2, 2017 Approved
Terraform 0.10.0-beta2 379 Wednesday, August 2, 2017 Approved
Terraform 0.10.0-beta1 402 Wednesday, July 5, 2017 Approved
Terraform 0.9.11 1722 Wednesday, July 5, 2017 Approved
Terraform 0.9.10 367 Wednesday, July 5, 2017 Approved
Terraform 0.9.9 356 Wednesday, July 5, 2017 Approved
Terraform 0.9.8 1262 Thursday, June 8, 2017 Approved
Terraform 0.9.7 386 Thursday, June 8, 2017 Approved
Terraform 0.9.6 706 Wednesday, May 31, 2017 Approved
Terraform 0.9.5 938 Friday, May 12, 2017 Approved
Terraform 0.9.4 701 Tuesday, May 2, 2017 Approved
Terraform 0.9.3 826 Thursday, April 13, 2017 Approved
Terraform 0.9.2 757 Monday, April 3, 2017 Approved
Terraform 0.9.1 920 Tuesday, March 21, 2017 Approved
Terraform 0.9.0 533 Thursday, March 16, 2017 Approved
Terraform 0.8.8 712 Monday, March 6, 2017 Approved
Terraform 0.8.7 794 Wednesday, February 22, 2017 Approved
Terraform 0.8.6 660 Wednesday, February 8, 2017 Approved
Terraform 0.8.5 582 Saturday, January 28, 2017 Approved
Terraform 0.8.4 581 Monday, January 16, 2017 Approved
Terraform 0.8.2 555 Thursday, December 22, 2016 Approved
Terraform 0.8.1 394 Friday, December 16, 2016 Approved
Terraform 0.8.0 433 Wednesday, December 14, 2016 Approved
Terraform 0.7.13 542 Wednesday, November 30, 2016 Approved
Terraform 0.7.12 374 Wednesday, November 30, 2016 Approved
Terraform 0.7.11 458 Tuesday, November 22, 2016 Approved
Terraform 0.7.10 316 Tuesday, November 22, 2016 Approved
Terraform 0.7.9 355 Tuesday, November 22, 2016 Approved
Terraform 0.7.8 526 Friday, November 4, 2016 Approved
Terraform 0.7.7 470 Sunday, October 23, 2016 Approved
Terraform 0.7.6 475 Sunday, October 16, 2016 Approved
Terraform 0.7.5 407 Sunday, October 16, 2016 Approved
Terraform 0.7.4 653 Thursday, September 22, 2016 Approved
Terraform 0.7.3 428 Thursday, September 22, 2016 Approved
Terraform 0.7.2 575 Tuesday, August 30, 2016 Approved
Terraform 0.7.1 417 Thursday, August 25, 2016 Approved
Terraform 0.7.0 526 Tuesday, August 2, 2016 Approved
Terraform 0.6.16 406 Tuesday, May 17, 2016 Approved
Terraform 0.6.15 408 Wednesday, April 27, 2016 Approved
Terraform 0.6.14 477 Tuesday, March 22, 2016 Approved
Terraform 0.6.13 361 Tuesday, March 22, 2016 Approved
Terraform 0.6.12 471 Monday, February 29, 2016 Approved
Terraform 0.6.11 405 Tuesday, February 2, 2016 Approved
Terraform 0.6.10 361 Tuesday, February 2, 2016 Approved
Terraform 0.6.9 417 Sunday, January 10, 2016 Approved
Terraform 0.6.8 401 Tuesday, December 8, 2015 Approved
Terraform 0.6.7 351 Tuesday, December 8, 2015 Approved
Terraform 0.6.6 392 Thursday, October 29, 2015 Approved
Terraform 0.6.5 375 Thursday, October 29, 2015 Approved
Terraform 0.6.4 386 Thursday, October 29, 2015 Approved
Terraform 0.6.3 335 Wednesday, August 12, 2015 Approved
Terraform 0.6.2 390 Wednesday, August 12, 2015 Approved
Terraform 0.6.1 370 Wednesday, August 12, 2015 Approved
Terraform 0.6.0 389 Thursday, July 9, 2015 Approved
Terraform 0.5.3 587 Wednesday, June 3, 2015 Approved
Terraform 0.5.2 369 Wednesday, June 3, 2015 Approved
Terraform 0.5.0 409 Wednesday, June 3, 2015 Approved
Terraform 0.4.0 407 Thursday, April 9, 2015 Approved
Terraform 0.3.6 459 Thursday, April 2, 2015 Approved

0.12.0-alpha1 (October 19, 2018)

The goal of this release is to give users an early preview of the new language features, and to collect feedback primarily about bugs and usability issues related to the language itself, while the Terraform team addresses the remaining problems. There will be at least one beta and at least one release candidate before final, which should give a more complete impression of how the final v0.12.0 release will behave.

INCOMPATIBILITIES AND NOTES:

The following list contains the most important incompatibillities and notes relative to v0.11.8, but may be incomplete. This alpha release is offered for experimentation purposes only and should not be used to manage real infrastructure. A more complete upgrade guide will be prepared in time for the final v0.12.0 release.

  • This release includes a revamped implementation of the configuration language that aims to address a wide array of feedback and known issues with the configuration language handling in prior versions. In order to resolve some ambiguities in the language, the new parser is stricter in some ways about following what was previously just idiomatic usage, and so some unusual constructs will need to be adjusted to be accepted by the new parser.
    The v0.12.0 final release will include a more complete language upgrade guide and a tool that can recognize and automatically upgrade common patterns for the new parser and new idiomatic forms.
  • This release introduces new wire protocols for provider and provisioner plugins and a new automatic installation method for provider plugins. At the time of release there are no official plugin releases compatible with these new protocols and so automatic provider installation with terraform init is not functional. Instead, the v0.12.0-alpha1 distribution archives contain bundled experimental provider builds for use with the alpha.
  • This release introduces new file formats for persisted Terraform state (both on local disk and in remote backends) and for saved plan files. Third-party tools that attempt to parse these files will need to be updated to work with the formats generated by v0.12 releases. Prior to v0.12.0 we will add a new command to obtain a JSON representation of a saved plan intended for outside consumption, but this command is not yet present in v0.12.0-alpha1.
  • terraform validate now has a smaller scope than before, focusing only on configuration syntax and value type checking. This makes it safe to run e.g. on save in a text editor.

NEW FEATURES:

The overall theme for the v0.12 release is configuration language fixes and improvements. The fixes and improvements are too numerous to list out exhaustively, but the list below covers some highlights:

  • First-class expressions: Prior to v0.12, expressions could be used only via string interpolation, like "${var.foo}". Expressions are now fully integrated into the language, allowing them to be used directly as argument values, like ami = var.ami.
  • for expressions: This new expression construct allows the construction of a list or map by transforming and filtering elements from another list or map. For more information, refer to the for expressions documentation.
  • Dynamic configuration blocks: For nested configuration blocks accepted as part of a resource configuration, it is now possible to dynamically generate zero or more blocks corresponding to items in a list or map using the special new dynamic block construct. This is the official replacement for the common (but buggy) unofficial workaround of treating a block type name as if it were an attribute expecting a list of maps value, which worked occasionally before as a result of some unintended coincidences in the implementation.
  • Generalised "splat" operator: The aws_instance.foo.*.id syntax was previously a special case only for resources with count set. It is now an operator within the expression language that can be applied to any list value. There is also an optional new splat variant that allows both index and attribute access operations on each item in the list. For more information, refer to the Splat Expressions documentation.
  • Nullable argument values: It is now possible to use a conditional expression like var.foo != "" ? var.foo : null to conditionally leave an argument value unset, whereas before Terraform required the configuration author to provide a specific default value in this case. Assigning null to an argument is equivalent to omitting that argument entirely.
  • Rich types in module inputs variables and output values: Terraform v0.7 added support for returning flat lists and maps of strings, but this is now generalized to allow returning arbitrary nested data structures with mixed types. Module authors can specify a precise expected type for each input variable to allow early validation of caller values.
  • Resource and module object values: An entire resource or module can now be treated as an object value within expressions, including passing them through input variables and output values to other modules, using an attribute-less reference syntax, like aws_instance.foo.
  • Extended template syntax: The simple interpolation syntax from prior versions is extended to become a simple template language, with support for conditional interpolations and repeated interpolations through iteration. For more information, see the String Templates documentation.
  • jsondecode and csvdecode interpolation functions: Due to the richer type system in the new configuration language implementation, we can now offer functions for decoding serialization formats. jsondecode is the opposite of jsonencode, while csvdecode provides a way to load in lists of maps from a compact tabular representation.
  • New Function: fileexists [GH-19086]

IMPROVEMENTS:

  • terraform validate now accepts an argument -json which produces machine-readable output. Please refer to the documentation for this command for details on the format and some caveats that consumers must consider when using this interface. [GH-17539]
  • The JSON-based variant of the Terraform language now has a more tightly-specified and reliable mapping to the native syntax variant. In prior versions, certain Terraform configuration features did not function as expected or were not usable via the JSON-based forms. For more information, see the JSON Configuration Syntax documentation.

BUG FIXES:

  • The conditional operator ... ? ... : ... now works with result values of any type and only returns evaluation errors for the chosen result expression, as those familiar with this operator in other languages might expect.

KNOWN ISSUES:

Since v0.12.0-alpha1 is an experimental build, this list is certainly incomplete. Please let us know via GitHub issues if you run into a problem not covered here!

  • As noted above, the alpha1 release is bundled with its own special builds of a subset of providers because there are not yet any official upstream releases of providers that are compatible with the new v0.12 provider plugin protocol. Automatic installation of providers with terraform init is therefore not functional at the time of release of alpha1.
    Provider developers may wish to try building their plugins against the v0.12-alpha1 tag of Terraform Core to use them with this build. We cannot yet promise that all providers will be buildable in this way and that they will work flawlessly after building. Official releases of all HashiCorp-hosted providers compatible with v0.12 will follow at some point before v0.12.0 final.
  • For providers that have required configuration arguments that can be set using environment variables, such as AWS_REGION in the aws provider, the detection of these environment variables is currently happening too "late" and so Terraform will prompt for these to be entered interactively or generate incorrect error messages saying that they are not set. To work around this, set these arguments inline within the configuration block. In most cases this does not apply to arguments related to API credentials, since most providers declare these ones as optional and then handle the environment variables directly in their own code. The environment variable defaults will be restored before final release.
  • There are several error messages in Terraform Core that claim that a problem is caused by a bug in the provider and ask for an issue to be filed against that provider's repository. For this alpha release, we ask that users disregard this advice and report such problems instead within the Terraform Core repository, since they are more likely to be problems with the new protocol version bridge code that is included in the plugin SDK.
  • Some secondary Terraform CLI subcommands are not yet updated for this release and will return errors or produce partial results. Please focus most testing and experimentation with this release on the core workflow commands terraform init, terraform validate, terraform plan, terraform apply, and terraform destroy.

In addition to the high-level known issues above, please refer also to the GitHub issues for this alpha release. This list will be updated with new reports throughout the alpha1 period, including workarounds where possible to allow for continued testing. (Issues shown in that list as closed indicate that the problem has been fixed for a future release; it is probably still present in the alpha1 release.)

Previous Releases

For more information on previous releases, check out the changelog on GitHub.


This package has no dependencies.

Discussion for the Terraform Package

Ground Rules:

  • This discussion is only about Terraform and the Terraform package. If you have feedback for Chocolatey, please contact the Google Group.
  • This discussion will carry over multiple versions. If you have a comment about a particular version, please note that in your comments.
  • The maintainers of this Chocolatey Package will be notified about new comments that are posted to this Disqus thread, however, it is NOT a guarantee that you will get a response. If you do not hear back from the maintainers after posting a message below, please follow up by using the link on the left side of this page or follow this link to contact maintainers. If you still hear nothing back, please follow the package triage process.
  • Tell us what you love about the package or Terraform, or tell us what needs improvement.
  • Share your experiences with the package, or extra configuration or gotchas that you've found.
  • If you use a url, the comment will be flagged for moderation until you've been whitelisted. Disqus moderated comments are approved on a weekly schedule if not sooner. It could take between 1-5 days for your comment to show up.
comments powered by Disqus