terraform/website/source/docs/enterprise/vcs/git.html.md

68 lines
2.2 KiB
Markdown
Raw Normal View History

2017-03-16 20:42:33 +01:00
---
2017-03-17 22:34:04 +01:00
layout: "vcs"
page_title: "Git Integration"
2017-03-20 19:44:03 +01:00
sidebar_current: "docs-enterprise-vcs-git"
2017-03-17 22:34:04 +01:00
description: |-
Git repositories can be integrated with Terraform Enterprise by using push command.
2017-03-16 20:42:33 +01:00
---
# Git Integation
2017-03-17 22:34:04 +01:00
Git repositories can be integrated with Terraform Enterprise by using
2017-03-16 20:42:33 +01:00
[`terraform push`](https://www.terraform.io/docs/commands/push.html) to import
Terraform configuration when changes are committed. When Terraform
2017-03-17 22:34:04 +01:00
configuration is imported using `terraform push` a plan is automatically queued.
2017-03-16 20:42:33 +01:00
_**Note:** This integration is for Git repositories **not** hosted on GitHub.
2017-03-20 19:44:03 +01:00
For repositories on GitHub, there is native [GitHub Integration](/docs/enterprise/vcs/github.html).
2017-03-16 20:42:33 +01:00
## Setup
Terraform configuration can be manually imported by running `terraform push`
like below:
```
$ terraform push -name=$ATLAS_USERNAME/ENV_NAME
```
A better option than having to manually run `terraform push` is to run it
using a git commit hook. A client-side `pre-push` hook is suitable and will
push your Terraform configuration when you push local changes to your Git
server.
### Client-side Commit Hook
The script below will execute `terraform push` when you push local changes to
your Git server. Place the script at `.git/pre-push` in your local Git
repository, set the necessary variables, and ensure the script is executable.
```
#!/bin/bash
#
2017-03-17 22:34:04 +01:00
# An example hook script to push Terraform configuration to Terraform Enterprise.
2017-03-16 20:42:33 +01:00
#
# Set the following variables for your project:
2017-03-20 19:44:03 +01:00
# - ENV_NAME - your environment name (e.g. org/env)
2017-03-16 20:42:33 +01:00
# - TERRAFORM_DIR - the local directory to push
# - DEFAULT_BRANCH - the branch to push. Other branches will be ignored.
ENV_NAME="YOUR_ORG/YOUR_ENV"
TERRAFORM_DIR="terraform"
DEFAULT_BRANCH=""
if [[ -z "$ENV_NAME" || -z "$TERRAFORM_DIR" || -z "$DEFAULT_BRANCH" ]]; then
echo 'pre-push hook: One or more variables are undefined. Canceling push.'
exit 1
fi
current_branch=$(git symbolic-ref HEAD | sed -e 's,.*/\(.*\),\1,')
if [ "$current_branch" == "$DEFAULT_BRANCH" ]; then
2017-03-20 19:44:03 +01:00
echo "pre-push hook: Pushing branch [$current_branch] to environment [$ENV_NAME]."
2017-03-16 20:42:33 +01:00
terraform push -name="$ENV_NAME" $TERRAFORM_DIR
else
2017-03-20 19:44:03 +01:00
echo "pre-push hook: NOT pushing branch [$current_branch] to environment [$ENV_NAME]."
2017-03-16 20:42:33 +01:00
fi
```