github.com/trawler/terraform@v0.10.8-0.20171106022149-4b1c7a1d9b48/website/docs/registry/modules/use.html.md (about)

     1  ---
     2  layout: "registry"
     3  page_title: "Finding and Using Modules from the Terraform Registry"
     4  sidebar_current: "docs-registry-use"
     5  description: |-
     6    The Terraform Registry makes it simple to find and use modules.
     7  ---
     8  
     9  # Finding and Using Modules
    10  
    11  The [Terraform Registry](https://registry.terraform.io) makes it simple to
    12  find and use modules.
    13  
    14  ## Finding Modules
    15  
    16  Every page on the registry has a search field for finding
    17  modules. Enter any type of module you're looking for (examples: "vault",
    18  "vpc", "database") and resulting modules will be listed. The search query
    19  will look at module name, provider, and description to match your search
    20  terms. On the results page, filters can be used further refine search results.
    21  
    22  By default, only [verified modules](/docs/registry/modules/verified.html)
    23  are shown in search results. Verified modules are reviewed by HashiCorp to
    24  ensure stability and compatibility. By using the filters, you may view unverified
    25  modules as well.
    26  
    27  ## Using Modules
    28  
    29  The Terraform Registry is integrated directly into Terraform. This makes
    30  it easy to reference any module in the registry. The syntax for referencing
    31  a registry module is `namespace/name/provider`. For example:
    32  `hashicorp/consul/aws`.
    33  
    34  When viewing a module on the registry on a tablet or desktop, usage instructions
    35  are shown on the right side. The screenshot below shows where to find these.
    36  You can copy and paste this to get started with any module. Some modules may
    37  have required inputs you must set before being able to use the module.
    38  
    39  ```hcl
    40  module "consul" {
    41    source = "hashicorp/consul/aws"
    42  }
    43  ```
    44  
    45  ## Module Versions
    46  
    47  Each module in the registry is versioned. These versions syntactically must
    48  follow [semantic versioning](http://semver.org/). In addition to pure syntax,
    49  we encourge all modules to follow the full guidelines of semantic versioning.
    50  
    51  Terraform currently only downloads the latest version of each module. The
    52  next release of Terraform (0.11) will bring full support for constraining
    53  module versions. The registry has the required semantic versions since launch
    54  to prepare for this transition shortly after.