tencent cloud

Tencent Infrastructure Automation for Terraform

Product Introduction
Overview
Strengths
Scenarios
Purchase Guide
Getting Started
Use Terraform in Local PC
User Guide
Configuration Guide
Syntax Guide
Resource List
Combination with DevOps
Code Management
Continuous Integration and Deployment
Use Cases
Deploying Cloud Native Service
Cross-Region Replication of Resources
Case Studies
Convertlab's IaC Practices Based on Tencent Cloud for Terraform
Provider Contributor Guide
Welcome
Contribute
Developer Reference
FAQs
Signature Error
Init Acceleration
Enabling Log Tracking
Managing Existing Resource
State Lock
DocumentaçãoTencent Infrastructure Automation for TerraformUser GuideConfiguration GuideModules

Modules

PDF
Modo Foco
Tamanho da Fonte
Última atualização: 2024-12-02 16:01:33
A module is a folder containing a set of Terraform code, which is an abstraction and encapsulation of multiple resources.

Calling a Module

Modules are referenced in Terraform code using a module block, which contains the module keyword, module name, and module body (the part within the {}) as shown below:
module "servers" {
  source = "./app-cluster"

  servers = 5
}
A module can be called using the following arguments:
source: Specifies the source of the referenced module.
version: Specifies the version number of the referenced module.
meta-arguments: It is a feature supported since Terraform 0.13. Similar to resource and data, it can be used to manipulate the behaviors of module. For more information, see MetaData.

Parameter Description

Source

The source argument tells Terraform where to find the source code for the desired child module. Terraform uses this during the module installation step of terraform init to download the source code to a directory on local disk so that it can be used by other Terraform commands. The module can be installed from the following source types:
Local paths
Terraform Registry
GitHub
Bitbucket
Generic Git, Mercurial repositories
HTTP URLs
S3 buckets
GCS buckets
Modules in Package Sub-directories
This document describes installation from local path, Terraform Registry, and GitHub.

Local path

Local paths can use child modules from the same project. Unlike other resources, local paths do not require the download of relevant code. For example:
module "consul" {
  source = "./consul"
}

Terraform Registry

Terraform Registry is currently the module repository solution recommended by Terraform. It uses Terraform's custom protocol and supports version management and module use. Terraform Registry hosts and indexes a large number of public modules, allowing quick search for a variety of official and community-supplied quality modules.
Modules in Terraform Registry can be referenced with source addresses in the format of <NAMESPACE>/<NAME>/<PROVIDER>. You can get the exact source address in the module description. For example:
module "consul" {
  source  = "hashicorp/consul/xxx"
  version = "0.1.0"
}
For modules hosted in other repositories, you can add <HOSTNAME>/ to the source address header to specify the server name of the private repository. For example:
module "consul" {
  source = "app.terraform.io/example-corp/k8s-cluster/azurerm"
  version = "1.1.0"
}

GitHub

If Terraform reads a source argument value prefixed with github.com, it will automatically recognize it as a GitHub source. For example, you can clone a repository using the HTTPS protocol: 
module "consul" {
  source = "github.com/hashicorp/example"
}
To use the SSH protocol, use the following address:
module "consul" {
  source = "git@github.com:hashicorp/example.git"
}
Note: The GitHub source is handled in the same way as generic Git repositories, as both of them get Git credentials and reference specific versions through the ref argument in the same way. If you want to access private repositories, you need to configure additional Git credentials.

Version

When a registry is used as a module source, you can use the version meta-argument to constrain the version of the module used. For example:
module "consul" {
  source  = "hashicorp/consul/xxx"
  version = "0.0.5"

  servers = 3
}
The format of the version meta-argument is in line with the provider version constraint. In this case, Terraform will use the latest version of the module instance that has been installed. If no compliant version is currently installed, the latest compliant version will be downloaded.
The version meta-argument can only be used with the registry to support public or private module repositories. Other types of module sources, such as local path, do not necessarily support versioning.
Anterior: ProviderPróximo: MetaData

Ajuda e Suporte

Esta página foi útil?

comentários