terraform/website/source/docs/enterprise/runs/scheduling-runs.html.md

43 lines
1.6 KiB
Markdown
Raw Normal View History

2017-03-16 20:42:33 +01:00
---
2017-03-17 20:24:20 +01:00
layout: "runs"
page_title: "Runs: Scheduling Runs"
sidebar_current: "docs-enterprise-runs-schedule"
description: |-
Schedule periodic plan runs in Terraform.
2017-03-16 20:42:33 +01:00
---
2017-03-17 20:24:20 +01:00
# Schedule Periodic Plan Runs
2017-03-16 20:42:33 +01:00
<div class="alert-infos">
<div class="alert-info">
2017-03-17 20:24:20 +01:00
This is an unreleased beta feature. Please <a href="mailto:support@hashicorp.com">contact support</a> if you are interested in helping us test this feature.
2017-03-16 20:42:33 +01:00
</div>
</div>
2017-03-17 20:24:20 +01:00
Terraform can automatically run a plan against
2017-03-16 20:42:33 +01:00
your infrastructure on a specified schedule. This option is disabled by default and can be enabled by an
2017-03-17 20:24:20 +01:00
organization owner on a per-environment basis.
2017-03-16 20:42:33 +01:00
2017-03-17 20:24:20 +01:00
On the specified interval, a plan can be run that
for you, determining any changes and sending the appropriate
2017-03-16 20:42:33 +01:00
notifications.
2017-03-17 20:24:20 +01:00
When used with [automatic applies](/docs/enterprise/runs/automatic-applies.html), this feature can help converge
2017-03-16 20:42:33 +01:00
changes to infrastructure without human input.
2017-03-17 20:24:20 +01:00
Runs will not be queued while another plan or apply is in progress, or if
2017-03-16 20:42:33 +01:00
the environment has been manually locked. See [Environment
2017-03-17 20:24:20 +01:00
Locking](/docs/enterprise/runs#environment-locking) for more information.
2017-03-16 20:42:33 +01:00
## Enabling Periodic Plans
2017-03-17 20:24:20 +01:00
To enable periodic plans for an environment, visit the environment settings page and select the desired interval and click the save button to
2017-03-16 20:42:33 +01:00
persist the changes. An initial plan may immediately run, depending
on the state of your environment, and then will automatically
plan at the specified interval.
2017-03-20 19:44:03 +01:00
If you have manually run a plan separately, a new
plan will not be queued until the allotted time after the manual plan ran. This means that
the platform simply ensures that a plan has been executed at the specified schedule.