terraform/website/source/docs/enterprise/glossary/index.html.md

205 lines
6.5 KiB
Markdown
Raw Normal View History

---
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"
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-04-07 06:00:26 +02:00
## Authentication Tokens
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-04-07 06:00:26 +02:00
## ACL
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-04-07 06:00:26 +02:00
## Alert
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
notification methods.
2017-04-07 06:00:26 +02:00
## Application
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-04-07 06:00:26 +02:00
## Apply
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-04-07 06:00:26 +02:00
## Artifact
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-04-07 06:00:26 +02:00
## Box
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-04-07 06:00:26 +02:00
## Build
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-04-07 06:00:26 +02:00
## Build Configuration
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-04-07 06:00:26 +02:00
## Catalog
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-04-07 06:00:26 +02:00
## Consul
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-04-07 06:00:26 +02:00
## Datacenter
2017-04-07 06:00:26 +02:00
A datacenter represents a group of nodes in the same network or datacenter
within Consul.
2017-04-07 06:00:26 +02:00
## Environment
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-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-04-07 06:00:26 +02:00
To read more about features provided under environments, read the
[Terraform](/docs/enterprise) sections.
2017-04-07 06:00:26 +02:00
## Environment Variables
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-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-04-07 06:00:26 +02:00
## Health Check
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-04-07 06:00:26 +02:00
## Infrastructure
2017-04-07 06:00:26 +02:00
An infrastructure is a stateful representation of a set of Consul datacenters.
2017-04-07 06:00:26 +02:00
## Managed Node
Managed node is the billing metric for Terraform Enterprise. For Consul Enterprise, a node is a host
with a Consul agent on it. For Terraform Enterprise, a node is a compute
resource managed by Terraform. See [Managed Nodes](/docs/enterprise/billing)
for more details about which Terraform resources and resource properties are counted
as compute resources.
All [Terraform Enterprise features](/docs/enterprise) are paid.
2017-04-07 06:00:26 +02:00
## Operator
2017-04-07 06:00:26 +02:00
An operator is a person who is making changes to infrastructure or settings.
2017-04-07 06:00:26 +02:00
## Packer
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
source configuration.
2017-04-07 06:00:26 +02:00
## Packer Template
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-04-07 06:00:26 +02:00
## Plan
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-04-07 06:00:26 +02:00
## Providers
2017-04-07 06:00:26 +02:00
Providers are often referenced when discussing Packer or Terraform. Terraform
providers manage resources in Terraform.
[Read more](https://terraform.io/docs/providers/index.html).
2017-04-07 06:00:26 +02:00
## Post-Processors
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-04-07 06:00:26 +02:00
## Registry
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-04-07 06:00:26 +02:00
## Run
A run represents a two step Terraform plan and a subsequent apply.
2017-04-07 06:00:26 +02:00
## Service
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-04-07 06:00:26 +02:00
## Share
2017-04-07 06:00:26 +02:00
Shares are let you instantly share public access to your running Vagrant
environment (virtual machine).
2017-04-07 06:00:26 +02:00
## State
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-04-07 06:00:26 +02:00
## Terraform
2017-04-07 06:00:26 +02:00
[Terraform](https://terraform.io) is a tool for safely and efficiently changing
infrastructure across providers.
2017-04-07 06:00:26 +02:00
## Terraform Configuration
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-04-07 06:00:26 +02:00
## Terraform Variables
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.