terraform/website/source/docs/configuration/modules.html.md

layout	page_title	sidebar_current
docs	Configuring Modules	docs-config-modules

Module Configuration

Modules are used in Terraform to modularize and encapsulate groups of resources in your infrastructure. For more information on modules, see the dedicated modules section.

This page assumes you're familiar with the configuration syntax already.

Example

Module configuration looks like the following:

module "consul" {
	source = "github.com/hashicorp/consul/terraform/aws"
	servers = 5
}

Description

The module block configures a module and tells Terraform to build its resources. Multiple module blocks may be used to configure and use multiple modules.

The NAME of the module is logical: it is used only to reference the module in other places in the configuration. It has no effect on the source of the module. Therefore, you may name modules whatever you'd like.

Within the block (the { }) is configuration for the module. The only required key is source, which tells Terraform where this module can be downloaded from. Valid source values are covered in more detail in the module section.

Other configuration within the module are dependent on the module itself. Because module configuration maps directly to variables within the module, they are always simple key and string values. Complex structures are not used for modules.

Syntax

The full syntax is:

module NAME {
	source = SOURCE_URL

	CONFIG ...
}

where CONFIG is:

KEY = VALUE