History

Chris Griggs e111c103b8 [Website]Terraform Integration Program (#29763 ) * add new guide doc * update word doc * assign imange files * add fmting changes * formatting * some more changes * Fix Title * Update website/guides/terraform-integration-program.html.md We can remove, I was hoping to have "Currently, pre-apply..." be in Bbold, but it looks like it doesnt render that way. So we can exclude the asterisk Co-authored-by: Jeff Escalante <jescalan@users.noreply.github.com> Fix spacing and remove unused html paragraph * Update website/guides/terraform-integration-program.html.md Good changes, thanks for simplifying it. Co-authored-by: Laura Pacilio <83350965+laurapacilio@users.noreply.github.com> * Update website/guides/terraform-integration-program.html.md Approved Co-authored-by: Laura Pacilio <83350965+laurapacilio@users.noreply.github.com> * Update website/guides/terraform-integration-program.html.md Approved Co-authored-by: Laura Pacilio <83350965+laurapacilio@users.noreply.github.com> * Update website/guides/terraform-integration-program.html.md Approved Co-authored-by: Laura Pacilio <83350965+laurapacilio@users.noreply.github.com> * Update website/guides/terraform-integration-program.html.md Approved Co-authored-by: Laura Pacilio <83350965+laurapacilio@users.noreply.github.com> * Update website/guides/terraform-integration-program.html.md Approved Co-authored-by: Laura Pacilio <83350965+laurapacilio@users.noreply.github.com> * Update website/guides/terraform-integration-program.html.md Approved Co-authored-by: Laura Pacilio <83350965+laurapacilio@users.noreply.github.com> * Update website/guides/terraform-integration-program.html.md approved Co-authored-by: Laura Pacilio <83350965+laurapacilio@users.noreply.github.com> * Update website/guides/terraform-integration-program.html.md Approved Co-authored-by: Laura Pacilio <83350965+laurapacilio@users.noreply.github.com> * Update website/guides/terraform-integration-program.html.md Approved Co-authored-by: Laura Pacilio <83350965+laurapacilio@users.noreply.github.com> * Update website/guides/terraform-integration-program.html.md Approved Co-authored-by: Laura Pacilio <83350965+laurapacilio@users.noreply.github.com> * Update website/guides/terraform-integration-program.html.md Approved Co-authored-by: Laura Pacilio <83350965+laurapacilio@users.noreply.github.com> * Update website/guides/terraform-integration-program.html.md Agreed Co-authored-by: Laura Pacilio <83350965+laurapacilio@users.noreply.github.com> * Update website/guides/terraform-integration-program.html.md Agreed Co-authored-by: Laura Pacilio <83350965+laurapacilio@users.noreply.github.com> * Update website/guides/terraform-integration-program.html.md Approved Co-authored-by: Laura Pacilio <83350965+laurapacilio@users.noreply.github.com> * Update website/guides/terraform-integration-program.html.md Approved Co-authored-by: Laura Pacilio <83350965+laurapacilio@users.noreply.github.com> * Update website/guides/terraform-integration-program.html.md Approved Co-authored-by: Laura Pacilio <83350965+laurapacilio@users.noreply.github.com> * Update website/guides/terraform-integration-program.html.md Approved Co-authored-by: Laura Pacilio <83350965+laurapacilio@users.noreply.github.com> * Update website/guides/terraform-integration-program.html.md Agreed Co-authored-by: Laura Pacilio <83350965+laurapacilio@users.noreply.github.com> * Update website/guides/terraform-integration-program.html.md Approved Co-authored-by: Laura Pacilio <83350965+laurapacilio@users.noreply.github.com> * Update website/guides/terraform-integration-program.html.md Approved Co-authored-by: Laura Pacilio <83350965+laurapacilio@users.noreply.github.com> * Update website/guides/terraform-integration-program.html.md Approved Co-authored-by: Laura Pacilio <83350965+laurapacilio@users.noreply.github.com> * Update website/guides/terraform-integration-program.html.md Approved Co-authored-by: Laura Pacilio <83350965+laurapacilio@users.noreply.github.com> * Update website/guides/terraform-integration-program.html.md Approved Co-authored-by: Laura Pacilio <83350965+laurapacilio@users.noreply.github.com> * Update website/guides/terraform-integration-program.html.md Approved Co-authored-by: Laura Pacilio <83350965+laurapacilio@users.noreply.github.com> * Update website/guides/terraform-integration-program.html.md Approved Co-authored-by: Laura Pacilio <83350965+laurapacilio@users.noreply.github.com> * Adding suggested changes from PR. Removing example sentence. (Internal request) * Move note section above badge * Add spacing * Update website/guides/terraform-integration-program.html.md Approved Co-authored-by: Jeff Escalante <jescalan@users.noreply.github.com> Co-authored-by: Jeff Escalante <jescalan@users.noreply.github.com> Co-authored-by: Laura Pacilio <83350965+laurapacilio@users.noreply.github.com>		2021-10-15 10:55:07 -07:00
..
docs	json-output: Release format version 1.0	2021-10-06 11:13:06 -04:00
guides	[Website]Terraform Integration Program (#29763 )	2021-10-15 10:55:07 -07:00
intro	move multi-cloud to top of use-cases page	2021-08-13 16:38:26 -04:00
layouts	Fix alphabetical order of sidebar	2021-09-16 17:11:31 -04:00
upgrade-guides	Update 0-15.html.markdown	2021-06-09 11:08:45 -07:00
README.md	Active voice and link fix	2021-07-12 09:22:16 -04:00

README.md

Terraform Documentation

This directory contains the portions of the Terraform website that pertain to the core functionality, excluding providers and the overall configuration.

The files in this directory are intended to be used in conjunction with the terraform-website repository, which brings all of the different documentation sources together and contains the scripts for testing and building the site as a whole.

Previewing Changes

You should preview all of your changes locally before creating a pull request. The build includes content from this repository and the terraform-website repository, allowing you to preview the entire Terraform documentation site. If terraform-website isn't in your GOPATH, the preview command will clone it to your machine.

Set Up Local Environment

Install Docker.
Create a ~/go directory manually or by installing Go.
Open terminal and set GOPATH as an environment variable:

Bash: export $GOPATH=~/go(bash)

Zsh: echo -n 'export GOPATH=~/go' >> ~/.zshrc
Restart your terminal or command line session.

Launch Site Locally

Navigate into your local terraform top-level directory and run make website.
Open http://localhost:4567 in your web browser. While the preview is running, you can edit pages and Middleman will automatically rebuild them.
When you're done with the preview, press ctrl-C in your terminal to stop the server.

Deploying Changes

Merge the PR to main. The changes will appear in the next major Terraform release.

If you need your changes to be deployed sooner, cherry-pick them to:

the current release branch (e.g. v1.0) and push. They will be deployed in the next minor version release (once every two weeks).
the stable-website branch and push. They will be included in the next site deploy (see below). Note that the release process resets stable-website to match the release tag, removing any additional commits. So, we recommend always cherry-picking to the version branch first and then to stable-website when needed.

Deployment

Currently, HashiCorp uses a CircleCI job to deploy the terraform.io site. This job can be run manually by many people within HashiCorp, and also runs automatically whenever a user in the HashiCorp GitHub org merges changes to master in the terraform-website repository.

New commits in this repository don't automatically deploy the [terraform.io][] site, but an unrelated site deploy will usually happen within a day. If you can't wait that long, you can do a manual CircleCI build or ask someone in the #proj-terraform-docs channel to do so:

Log in to circleci.com, and make sure you're viewing the HashiCorp organization.
Go to the terraform-website project's list of workflows.
Find the most recent "website-deploy" workflow, and click the "Rerun workflow from start" button (which looks like a refresh button with a numeral "1" inside).