2017-03-21 22:24:29 +01:00
|
|
|
---
|
2017-03-27 20:48:57 +02:00
|
|
|
layout: "enterprise"
|
2017-04-07 06:00:26 +02:00
|
|
|
page_title: "Glossary - Terraform Enterprise"
|
2017-04-03 19:53:38 +02:00
|
|
|
sidebar_current: "docs-enterprise-glossary"
|
2017-03-21 22:24:29 +01:00
|
|
|
description: |-
|
|
|
|
Terminology for Terraform Enterprise.
|
|
|
|
---
|
|
|
|
|
|
|
|
# Glossary
|
|
|
|
|
2017-04-07 06:00:26 +02:00
|
|
|
Terraform Enterprise, and this documentation, covers a large set of terminology
|
|
|
|
adopted from tools, industry standards and the community. This glossary seeks to
|
|
|
|
define as many of those terms as possible to help increase understanding in
|
|
|
|
interfacing with the platform and reading documentation.
|
2017-03-21 22:24:29 +01:00
|
|
|
|
2017-04-07 06:00:26 +02:00
|
|
|
## Authentication Tokens
|
2017-03-21 22:24:29 +01:00
|
|
|
|
2017-04-07 06:00:26 +02:00
|
|
|
Authentication tokens are tokens used to authenticate with Terraform Enterprise
|
|
|
|
via APIs or through tools. Authentication tokens can be revoked, expired or
|
|
|
|
created under any user.
|
2017-03-21 22:24:29 +01:00
|
|
|
|
2017-04-07 06:00:26 +02:00
|
|
|
## ACL
|
2017-03-21 22:24:29 +01:00
|
|
|
|
2017-04-07 06:00:26 +02:00
|
|
|
ACL is an acronym for access control list. This defines access to a set of
|
|
|
|
resources. Access to an object in Terraform Enterprise limited to "read" for
|
|
|
|
certain users is an example of an ACL.
|
2017-03-21 22:24:29 +01:00
|
|
|
|
2017-04-07 06:00:26 +02:00
|
|
|
## Alert
|
2017-03-21 22:24:29 +01:00
|
|
|
|
2017-04-07 06:00:26 +02:00
|
|
|
An alert represents a health check status change on a Consul node that is sent
|
|
|
|
to Terraform Enterprise, and then recorded and distributed to various
|
2017-03-21 22:24:29 +01:00
|
|
|
notification methods.
|
|
|
|
|
2017-04-07 06:00:26 +02:00
|
|
|
## Application
|
2017-03-21 22:24:29 +01:00
|
|
|
|
2017-04-07 06:00:26 +02:00
|
|
|
An application is a set of code that represents an application that should be
|
|
|
|
deployed. Applications can be linked to builds to be made available in the
|
|
|
|
Packer environment.
|
2017-03-21 22:24:29 +01:00
|
|
|
|
2017-04-07 06:00:26 +02:00
|
|
|
## Apply
|
2017-03-21 22:24:29 +01:00
|
|
|
|
2017-04-07 06:00:26 +02:00
|
|
|
An apply is the second step of the two steps required for Terraform to make
|
|
|
|
changes to infrastructure. The apply is the process of communicating with
|
|
|
|
external APIs to make the changes.
|
2017-03-21 22:24:29 +01:00
|
|
|
|
2017-04-07 06:00:26 +02:00
|
|
|
## Artifact
|
2017-03-21 22:24:29 +01:00
|
|
|
|
2017-04-07 06:00:26 +02:00
|
|
|
An artifact is an abstract representation of something you wish to store and use
|
|
|
|
again that has undergone configuration, compilation or some other build process.
|
|
|
|
An artifact is typically an image created by Packer that is then deployed by
|
|
|
|
Terraform, or used locally with Vagrant.
|
2017-03-21 22:24:29 +01:00
|
|
|
|
2017-04-07 06:00:26 +02:00
|
|
|
## Box
|
2017-03-21 22:24:29 +01:00
|
|
|
|
2017-04-07 06:00:26 +02:00
|
|
|
Boxes are a Vagrant specific package format. Vagrant can install and uses images
|
|
|
|
in box format.
|
2017-03-21 22:24:29 +01:00
|
|
|
|
2017-04-07 06:00:26 +02:00
|
|
|
## Build
|
2017-03-21 22:24:29 +01:00
|
|
|
|
2017-04-07 06:00:26 +02:00
|
|
|
Builds are resources that represent Packer configurations. A build is a generic
|
|
|
|
name, sometimes called a "Build Configuration" when defined in the Terraform
|
|
|
|
Enterprise UI.
|
2017-03-21 22:24:29 +01:00
|
|
|
|
2017-04-07 06:00:26 +02:00
|
|
|
## Build Configuration
|
2017-03-21 22:24:29 +01:00
|
|
|
|
2017-04-07 06:00:26 +02:00
|
|
|
A build configuration are settings associated with a resource that creates
|
|
|
|
artifacts via builds. A build configuration is the name in `packer push -name
|
|
|
|
acemeinc/web`.
|
2017-03-21 22:24:29 +01:00
|
|
|
|
2017-04-07 06:00:26 +02:00
|
|
|
## Catalog
|
2017-03-21 22:24:29 +01:00
|
|
|
|
2017-04-07 06:00:26 +02:00
|
|
|
The box catalog is a publicly available index of Vagrant Boxes that can be
|
|
|
|
downloaded from Terraform Enterprise and used for development.
|
2017-03-21 22:24:29 +01:00
|
|
|
|
2017-04-07 06:00:26 +02:00
|
|
|
## Consul
|
2017-03-21 22:24:29 +01:00
|
|
|
|
2017-04-07 06:00:26 +02:00
|
|
|
[Consul](https://consul.io) is a HashiCorp tool for service discovery,
|
|
|
|
configuration, and orchestration. Consul enables rapid deployment,
|
|
|
|
configuration, monitoring and maintenance of service-oriented architectures.
|
2017-03-21 22:24:29 +01:00
|
|
|
|
2017-04-07 06:00:26 +02:00
|
|
|
## Datacenter
|
2017-03-21 22:24:29 +01:00
|
|
|
|
2017-04-07 06:00:26 +02:00
|
|
|
A datacenter represents a group of nodes in the same network or datacenter
|
|
|
|
within Consul.
|
2017-03-21 22:24:29 +01:00
|
|
|
|
2017-04-07 06:00:26 +02:00
|
|
|
## Environment
|
2017-03-21 22:24:29 +01:00
|
|
|
|
2017-04-07 06:00:26 +02:00
|
|
|
Environments show the real-time status of your infrastructure, any pending
|
|
|
|
changes, and its change history. Environments can be configured to use any or
|
|
|
|
all of these three components.
|
2017-03-21 22:24:29 +01:00
|
|
|
|
2017-04-07 06:00:26 +02:00
|
|
|
Environments are the namespace of your Terraform Enterprise managed
|
|
|
|
infrastructure. As an example, if you to have a production environment for a
|
|
|
|
company named Acme Inc., your environment may be named
|
|
|
|
`my-username/production`.
|
2017-03-21 22:24:29 +01:00
|
|
|
|
2017-04-07 06:00:26 +02:00
|
|
|
To read more about features provided under environments, read the
|
|
|
|
[Terraform](/docs/enterprise) sections.
|
2017-03-21 22:24:29 +01:00
|
|
|
|
2017-04-07 06:00:26 +02:00
|
|
|
## Environment Variables
|
2017-03-21 22:24:29 +01:00
|
|
|
|
|
|
|
Environment variables injected into the environment of Packer builds or
|
|
|
|
Terraform Runs (plans and applies).
|
|
|
|
|
2017-04-07 06:00:26 +02:00
|
|
|
## Flapping
|
2017-03-21 22:24:29 +01:00
|
|
|
|
2017-04-07 06:00:26 +02:00
|
|
|
Flapping is something entering and leaving a healthy state rapidly. It is
|
|
|
|
typically associated with a health checks that briefly report unhealthy status
|
|
|
|
before recovering.
|
2017-03-21 22:24:29 +01:00
|
|
|
|
2017-04-07 06:00:26 +02:00
|
|
|
## Health Check
|
2017-03-21 22:24:29 +01:00
|
|
|
|
|
|
|
Health checks trigger alerts by changing status on a Consul node. That status
|
2017-04-07 06:00:26 +02:00
|
|
|
change is seen by Terraform Enterprise, when connected, and an associated alert
|
|
|
|
is recorded and sent to any configured notification methods, like email.
|
2017-03-21 22:24:29 +01:00
|
|
|
|
2017-04-07 06:00:26 +02:00
|
|
|
## Infrastructure
|
2017-03-21 22:24:29 +01:00
|
|
|
|
2017-04-07 06:00:26 +02:00
|
|
|
An infrastructure is a stateful representation of a set of Consul datacenters.
|
2017-03-21 22:24:29 +01:00
|
|
|
|
2017-04-07 06:00:26 +02:00
|
|
|
## Operator
|
2017-03-21 22:24:29 +01:00
|
|
|
|
2017-04-07 06:00:26 +02:00
|
|
|
An operator is a person who is making changes to infrastructure or settings.
|
2017-03-21 22:24:29 +01:00
|
|
|
|
2017-04-07 06:00:26 +02:00
|
|
|
## Packer
|
2017-03-21 22:24:29 +01:00
|
|
|
|
2017-04-07 06:00:26 +02:00
|
|
|
[Packer](https://packer.io) is a tool for creating images for platforms such as
|
|
|
|
Amazon AWS, OpenStack, VMware, VirtualBox, Docker, and more — all from a single
|
2017-03-21 22:24:29 +01:00
|
|
|
source configuration.
|
|
|
|
|
2017-04-07 06:00:26 +02:00
|
|
|
## Packer Template
|
2017-03-21 22:24:29 +01:00
|
|
|
|
2017-04-07 06:00:26 +02:00
|
|
|
A Packer template is a JSON file that configure the various components of Packer
|
|
|
|
in order to create one or more machine images.
|
2017-03-21 22:24:29 +01:00
|
|
|
|
2017-04-07 06:00:26 +02:00
|
|
|
## Plan
|
2017-03-21 22:24:29 +01:00
|
|
|
|
2017-04-07 06:00:26 +02:00
|
|
|
A plan is the second step of the two steps required for Terraform to make
|
|
|
|
changes to infrastructure. The plan is the process of determining what changes
|
|
|
|
will be made to.
|
2017-03-21 22:24:29 +01:00
|
|
|
|
2017-04-07 06:00:26 +02:00
|
|
|
## Providers
|
2017-03-21 22:24:29 +01:00
|
|
|
|
2017-04-07 06:00:26 +02:00
|
|
|
Providers are often referenced when discussing Packer or Terraform. Terraform
|
|
|
|
providers manage resources in Terraform.
|
2017-03-21 22:24:29 +01:00
|
|
|
[Read more](https://terraform.io/docs/providers/index.html).
|
|
|
|
|
2017-04-07 06:00:26 +02:00
|
|
|
## Post-Processors
|
2017-03-21 22:24:29 +01:00
|
|
|
|
2017-04-07 06:00:26 +02:00
|
|
|
The post-processor section within a Packer template configures any
|
|
|
|
post-processing that will be done to images built by the builders. Examples of
|
|
|
|
post-processing would be compressing files, uploading artifacts, etc..
|
2017-03-21 22:24:29 +01:00
|
|
|
|
2017-04-07 06:00:26 +02:00
|
|
|
## Registry
|
2017-03-21 22:24:29 +01:00
|
|
|
|
2017-04-07 06:00:26 +02:00
|
|
|
Often referred to as the "Artifact Registry", the registry stores artifacts, be
|
|
|
|
it images or IDs for cloud provider images.
|
2017-03-21 22:24:29 +01:00
|
|
|
|
2017-04-07 06:00:26 +02:00
|
|
|
## Run
|
2017-03-21 22:24:29 +01:00
|
|
|
|
2017-03-23 19:03:36 +01:00
|
|
|
A run represents a two step Terraform plan and a subsequent apply.
|
2017-03-21 22:24:29 +01:00
|
|
|
|
2017-04-07 06:00:26 +02:00
|
|
|
## Service
|
2017-03-21 22:24:29 +01:00
|
|
|
|
2017-04-07 06:00:26 +02:00
|
|
|
A service in Consul represents an application or service, which could be active
|
|
|
|
on any number of nodes.
|
2017-03-21 22:24:29 +01:00
|
|
|
|
2017-04-07 06:00:26 +02:00
|
|
|
## Share
|
2017-03-21 22:24:29 +01:00
|
|
|
|
2017-04-07 06:00:26 +02:00
|
|
|
Shares are let you instantly share public access to your running Vagrant
|
|
|
|
environment (virtual machine).
|
2017-03-21 22:24:29 +01:00
|
|
|
|
2017-04-07 06:00:26 +02:00
|
|
|
## State
|
2017-03-21 22:24:29 +01:00
|
|
|
|
2017-04-07 06:00:26 +02:00
|
|
|
Terraform state is the state of your managed infrastructure from the last time
|
|
|
|
Terraform was run. By default this state is stored in a local file named
|
|
|
|
`terraform.tfstate`, but it can also be stored in Terraform Enterprise and is
|
|
|
|
then called "Remote state".
|
2017-03-21 22:24:29 +01:00
|
|
|
|
2017-04-07 06:00:26 +02:00
|
|
|
## Terraform
|
2017-03-21 22:24:29 +01:00
|
|
|
|
2017-04-07 06:00:26 +02:00
|
|
|
[Terraform](https://terraform.io) is a tool for safely and efficiently changing
|
|
|
|
infrastructure across providers.
|
2017-03-21 22:24:29 +01:00
|
|
|
|
2017-04-07 06:00:26 +02:00
|
|
|
## Terraform Configuration
|
2017-03-21 22:24:29 +01:00
|
|
|
|
2017-04-07 06:00:26 +02:00
|
|
|
Terraform configuration is the configuration files and any files that may be
|
|
|
|
used in provisioners like `remote-exec`.
|
2017-03-21 22:24:29 +01:00
|
|
|
|
2017-04-07 06:00:26 +02:00
|
|
|
## Terraform Variables
|
2017-03-21 22:24:29 +01:00
|
|
|
|
2017-04-07 06:00:26 +02:00
|
|
|
Variables in Terraform, uploaded with `terraform push` or set in the UI. These
|
|
|
|
differ from environment variables as they are a first class Terraform variable
|
|
|
|
used in interpolation.
|