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

43 lines
1.7 KiB
Markdown
Executable File

---
layout: "enterprise"
page_title: "Runs: Scheduling Runs"
sidebar_current: "docs-enterprise-runs-schedule"
description: |-
Schedule periodic plan runs in Terraform.
---
# Schedule Periodic Plan Runs
<div class="alert-infos">
<div class="alert-info">
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.
</div>
</div>
Terraform can automatically run a plan against
your infrastructure on a specified schedule. This option is disabled by default and can be enabled by an
organization owner on a per-environment basis.
On the specified interval, a plan can be run that
for you, determining any changes and sending the appropriate
notifications.
When used with [automatic applies](/docs/enterprise/runs/automatic-applies.html), this feature can help converge
changes to infrastructure without human input.
Runs will not be queued while another plan or apply is in progress, or if
the environment has been manually locked. See [Environment
Locking](/docs/enterprise/runs#environment-locking) for more information.
## Enabling Periodic Plans
To enable periodic plans for an environment, visit the environment settings page and select the desired interval and click the save button to
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.
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.