2017-03-21 23:01:58 +01:00
|
|
|
---
|
2017-04-03 19:53:38 +02:00
|
|
|
layout: "enterprise"
|
2017-04-07 06:00:42 +02:00
|
|
|
page_title: "Schedule Periodic Builds - Packer Builds - Terraform Enterprise"
|
2017-04-03 19:53:38 +02:00
|
|
|
sidebar_current: "docs-enterprise-packerbuilds-scheduling"
|
2017-03-22 18:31:44 +01:00
|
|
|
description: |-
|
2017-04-07 06:00:42 +02:00
|
|
|
Terraform Enterprise can automatically run a Packer build and create artifacts on a specified schedule.
|
2017-03-21 23:01:58 +01:00
|
|
|
---
|
|
|
|
|
2017-03-22 18:31:44 +01:00
|
|
|
# Schedule Periodic Builds in Terraform Enterprise
|
2017-03-21 23:01:58 +01:00
|
|
|
|
2017-03-22 18:31:44 +01:00
|
|
|
Terraform Enterprise can automatically run a Packer build and
|
2017-03-21 23:01:58 +01:00
|
|
|
create artifacts on a specified schedule. This option is disabled by default and can be enabled by an
|
2017-03-22 18:31:44 +01:00
|
|
|
organization owner on a per-[environment](/docs/enterprise/glossary#environment) basis.
|
2017-03-21 23:01:58 +01:00
|
|
|
|
2017-04-07 06:00:42 +02:00
|
|
|
On the specified interval, builds will be automatically queued that run Packer
|
|
|
|
for you, creating any artifacts and sending the appropriate notifications.
|
2017-03-21 23:01:58 +01:00
|
|
|
|
2017-04-07 06:00:42 +02:00
|
|
|
If your artifacts are used in any other environments and you have activated the
|
|
|
|
plan on artifact upload feature, this may also queue Terraform plans.
|
2017-03-21 23:01:58 +01:00
|
|
|
|
2017-04-07 06:00:42 +02:00
|
|
|
This feature is useful for maintenance of images and automatic updates, or to
|
|
|
|
build nightly style images for staging or development environments.
|
2017-03-21 23:01:58 +01:00
|
|
|
|
|
|
|
## Enabling Periodic Builds
|
|
|
|
|
2017-04-07 06:00:42 +02:00
|
|
|
To enable periodic builds for a build, visit the build settings page and select
|
|
|
|
the desired interval and click the save button to persist the changes. An
|
|
|
|
initial build may immediately run, depending on the history, and then will
|
|
|
|
automatically build at the specified interval.
|
2017-03-21 23:01:58 +01:00
|
|
|
|
2017-04-07 06:00:42 +02:00
|
|
|
If you have run a build separately, either manually or triggered from GitHub or
|
|
|
|
Packer configuration version uploads, Terraform Enterprise will not queue a new
|
|
|
|
build until the allowed time after the manual build ran. This ensures that a
|
|
|
|
build has been executed at the specified schedule.
|