├── .gitignore ├── .terraform.lock.hcl ├── LICENSE ├── README.md ├── main.tf ├── outputs.tf ├── terraform.tf └── variables.tf /.gitignore: -------------------------------------------------------------------------------- 1 | # Local .terraform directories 2 | **/.terraform/* 3 | 4 | # .tfstate files 5 | *.tfstate 6 | *.tfstate.* 7 | 8 | # Crash log files 9 | crash.log 10 | 11 | # Ignore any .tfvars files that are generated automatically for each Terraform run. Most 12 | # .tfvars files are managed as part of configuration and so should be included in 13 | # version control. 14 | # 15 | # example.tfvars 16 | 17 | # Ignore override files as they are usually used to override resources locally and so 18 | # are not checked in 19 | override.tf 20 | override.tf.json 21 | *_override.tf 22 | *_override.tf.json 23 | 24 | # Include override files you do wish to add to version control using negated pattern 25 | # 26 | # !example_override.tf 27 | 28 | # Include tfplan files to ignore the plan output of command: terraform plan -out=tfplan 29 | # example: *tfplan* 30 | -------------------------------------------------------------------------------- /.terraform.lock.hcl: -------------------------------------------------------------------------------- 1 | # This file is maintained automatically by "terraform init". 2 | # Manual edits may be lost in future updates. 3 | 4 | provider "registry.terraform.io/hashicorp/aws" { 5 | version = "4.49.0" 6 | constraints = ">= 3.73.0, >= 4.20.0, ~> 4.49.0" 7 | hashes = [ 8 | "h1:1vbzsJ8TBjjotPQKWZQUrX2AII8+te1ih4bYJYD2VS4=", 9 | "zh:09803937f00fdf2873eccf685eec7854408925cbf183c9b683df7c5825be463f", 10 | "zh:2af1575e538fb0b669266f8d1385b17bfdaf17c521b6b6329baa1f2971fc4a4d", 11 | "zh:3f71882b438cde3108fe68cfe2637839d3eed08157a9721bd97babf3912247a8", 12 | "zh:577af1b38f5da8a9f29eebe5eebec9279d26e757cd03b0c8c59311f9ce8a859b", 13 | "zh:60160d39094973beefb9b10cfd6aaa5b63a2e68c32445ecffcd1b101356e6f9b", 14 | "zh:762656454722548baeccf35cbaa23b887976337e1ed321682df7390419fdf22d", 15 | "zh:7f6d7887821659bf3bef815949077dc91ffcdb0d911644a887b6683b264a5ca6", 16 | "zh:8f16a352cc903f8951fa4619c36233b3e66e27d724817b131f2035dd8896f524", 17 | "zh:8f768f65e370366c8b91c00d01c9a6264fe26ea9ae1819f14bdcd12c066272bc", 18 | "zh:95ad78c689a83c08ef7c3e544c3c9aca93ed528054aa77cc968ddd9efa3a1023", 19 | "zh:9b12af85486a96aedd8d7984b0ff811a4b42e3d88dad1a3fb4c0b580d04fa425", 20 | "zh:a47097ab6a4ca8302da82964303ffdd2310ed65e8f8524bfe4058816cf1addb7", 21 | "zh:b66d820c70cd5fd628ffe882d2b97e76b969dca4e6827ac2ba0f8d3bc5d6e9c6", 22 | "zh:b80f713a4f3e1355c3dd1600e9d08b9f15ed2370054ec792ad2c01f2541abe02", 23 | "zh:ce065bc3962cb71fa7652562226b9d486f3d7fcb88285c1020ebe2f550e28641", 24 | ] 25 | } 26 | -------------------------------------------------------------------------------- /LICENSE: -------------------------------------------------------------------------------- 1 | Copyright (c) 2021 HashiCorp, Inc. 2 | 3 | Mozilla Public License Version 2.0 4 | ================================== 5 | 6 | 1. Definitions 7 | 8 | -------------- 9 | 10 | 1.1. "Contributor" 11 | means each individual or legal entity that creates, contributes to 12 | the creation of, or owns Covered Software. 13 | 14 | 1.2. "Contributor Version" 15 | means the combination of the Contributions of others (if any) used 16 | by a Contributor and that particular Contributor's Contribution. 17 | 18 | 1.3. "Contribution" 19 | means Covered Software of a particular Contributor. 20 | 21 | 1.4. "Covered Software" 22 | means Source Code Form to which the initial Contributor has attached 23 | the notice in Exhibit A, the Executable Form of such Source Code 24 | Form, and Modifications of such Source Code Form, in each case 25 | including portions thereof. 26 | 27 | 1.5. "Incompatible With Secondary Licenses" 28 | means 29 | 30 | (a) that the initial Contributor has attached the notice described 31 | in Exhibit B to the Covered Software; or 32 | 33 | (b) that the Covered Software was made available under the terms of 34 | version 1.1 or earlier of the License, but not also under the 35 | terms of a Secondary License. 36 | 37 | 1.6. "Executable Form" 38 | means any form of the work other than Source Code Form. 39 | 40 | 1.7. "Larger Work" 41 | means a work that combines Covered Software with other material, in 42 | a separate file or files, that is not Covered Software. 43 | 44 | 1.8. "License" 45 | means this document. 46 | 47 | 1.9. "Licensable" 48 | means having the right to grant, to the maximum extent possible, 49 | whether at the time of the initial grant or subsequently, any and 50 | all of the rights conveyed by this License. 51 | 52 | 1.10. "Modifications" 53 | means any of the following: 54 | 55 | (a) any file in Source Code Form that results from an addition to, 56 | deletion from, or modification of the contents of Covered 57 | Software; or 58 | 59 | (b) any new file in Source Code Form that contains any Covered 60 | Software. 61 | 62 | 1.11. "Patent Claims" of a Contributor 63 | means any patent claim(s), including without limitation, method, 64 | process, and apparatus claims, in any patent Licensable by such 65 | Contributor that would be infringed, but for the grant of the 66 | License, by the making, using, selling, offering for sale, having 67 | made, import, or transfer of either its Contributions or its 68 | Contributor Version. 69 | 70 | 1.12. "Secondary License" 71 | means either the GNU General Public License, Version 2.0, the GNU 72 | Lesser General Public License, Version 2.1, the GNU Affero General 73 | Public License, Version 3.0, or any later versions of those 74 | licenses. 75 | 76 | 1.13. "Source Code Form" 77 | means the form of the work preferred for making modifications. 78 | 79 | 1.14. "You" (or "Your") 80 | means an individual or a legal entity exercising rights under this 81 | License. For legal entities, "You" includes any entity that 82 | controls, is controlled by, or is under common control with You. For 83 | purposes of this definition, "control" means (a) the power, direct 84 | or indirect, to cause the direction or management of such entity, 85 | whether by contract or otherwise, or (b) ownership of more than 86 | fifty percent (50%) of the outstanding shares or beneficial 87 | ownership of such entity. 88 | 89 | 2. License Grants and Conditions 90 | 91 | -------------------------------- 92 | 93 | 2.1. Grants 94 | 95 | Each Contributor hereby grants You a world-wide, royalty-free, 96 | non-exclusive license: 97 | 98 | (a) under intellectual property rights (other than patent or trademark) 99 | Licensable by such Contributor to use, reproduce, make available, 100 | modify, display, perform, distribute, and otherwise exploit its 101 | Contributions, either on an unmodified basis, with Modifications, or 102 | as part of a Larger Work; and 103 | 104 | (b) under Patent Claims of such Contributor to make, use, sell, offer 105 | for sale, have made, import, and otherwise transfer either its 106 | Contributions or its Contributor Version. 107 | 108 | 2.2. Effective Date 109 | 110 | The licenses granted in Section 2.1 with respect to any Contribution 111 | become effective for each Contribution on the date the Contributor first 112 | distributes such Contribution. 113 | 114 | 2.3. Limitations on Grant Scope 115 | 116 | The licenses granted in this Section 2 are the only rights granted under 117 | this License. No additional rights or licenses will be implied from the 118 | distribution or licensing of Covered Software under this License. 119 | Notwithstanding Section 2.1(b) above, no patent license is granted by a 120 | Contributor: 121 | 122 | (a) for any code that a Contributor has removed from Covered Software; 123 | or 124 | 125 | (b) for infringements caused by: (i) Your and any other third party's 126 | modifications of Covered Software, or (ii) the combination of its 127 | Contributions with other software (except as part of its Contributor 128 | Version); or 129 | 130 | (c) under Patent Claims infringed by Covered Software in the absence of 131 | its Contributions. 132 | 133 | This License does not grant any rights in the trademarks, service marks, 134 | or logos of any Contributor (except as may be necessary to comply with 135 | the notice requirements in Section 3.4). 136 | 137 | 2.4. Subsequent Licenses 138 | 139 | No Contributor makes additional grants as a result of Your choice to 140 | distribute the Covered Software under a subsequent version of this 141 | License (see Section 10.2) or under the terms of a Secondary License (if 142 | permitted under the terms of Section 3.3). 143 | 144 | 2.5. Representation 145 | 146 | Each Contributor represents that the Contributor believes its 147 | Contributions are its original creation(s) or it has sufficient rights 148 | to grant the rights to its Contributions conveyed by this License. 149 | 150 | 2.6. Fair Use 151 | 152 | This License is not intended to limit any rights You have under 153 | applicable copyright doctrines of fair use, fair dealing, or other 154 | equivalents. 155 | 156 | 2.7. Conditions 157 | 158 | Sections 3.1, 3.2, 3.3, and 3.4 are conditions of the licenses granted 159 | in Section 2.1. 160 | 161 | 3. Responsibilities 162 | 163 | ------------------- 164 | 165 | 3.1. Distribution of Source Form 166 | 167 | All distribution of Covered Software in Source Code Form, including any 168 | Modifications that You create or to which You contribute, must be under 169 | the terms of this License. You must inform recipients that the Source 170 | Code Form of the Covered Software is governed by the terms of this 171 | License, and how they can obtain a copy of this License. You may not 172 | attempt to alter or restrict the recipients' rights in the Source Code 173 | Form. 174 | 175 | 3.2. Distribution of Executable Form 176 | 177 | If You distribute Covered Software in Executable Form then: 178 | 179 | (a) such Covered Software must also be made available in Source Code 180 | Form, as described in Section 3.1, and You must inform recipients of 181 | the Executable Form how they can obtain a copy of such Source Code 182 | Form by reasonable means in a timely manner, at a charge no more 183 | than the cost of distribution to the recipient; and 184 | 185 | (b) You may distribute such Executable Form under the terms of this 186 | License, or sublicense it under different terms, provided that the 187 | license for the Executable Form does not attempt to limit or alter 188 | the recipients' rights in the Source Code Form under this License. 189 | 190 | 3.3. Distribution of a Larger Work 191 | 192 | You may create and distribute a Larger Work under terms of Your choice, 193 | provided that You also comply with the requirements of this License for 194 | the Covered Software. If the Larger Work is a combination of Covered 195 | Software with a work governed by one or more Secondary Licenses, and the 196 | Covered Software is not Incompatible With Secondary Licenses, this 197 | License permits You to additionally distribute such Covered Software 198 | under the terms of such Secondary License(s), so that the recipient of 199 | the Larger Work may, at their option, further distribute the Covered 200 | Software under the terms of either this License or such Secondary 201 | License(s). 202 | 203 | 3.4. Notices 204 | 205 | You may not remove or alter the substance of any license notices 206 | (including copyright notices, patent notices, disclaimers of warranty, 207 | or limitations of liability) contained within the Source Code Form of 208 | the Covered Software, except that You may alter any license notices to 209 | the extent required to remedy known factual inaccuracies. 210 | 211 | 3.5. Application of Additional Terms 212 | 213 | You may choose to offer, and to charge a fee for, warranty, support, 214 | indemnity or liability obligations to one or more recipients of Covered 215 | Software. However, You may do so only on Your own behalf, and not on 216 | behalf of any Contributor. You must make it absolutely clear that any 217 | such warranty, support, indemnity, or liability obligation is offered by 218 | You alone, and You hereby agree to indemnify every Contributor for any 219 | liability incurred by such Contributor as a result of warranty, support, 220 | indemnity or liability terms You offer. You may include additional 221 | disclaimers of warranty and limitations of liability specific to any 222 | jurisdiction. 223 | 224 | 4. Inability to Comply Due to Statute or Regulation 225 | 226 | --------------------------------------------------- 227 | 228 | If it is impossible for You to comply with any of the terms of this 229 | License with respect to some or all of the Covered Software due to 230 | statute, judicial order, or regulation then You must: (a) comply with 231 | the terms of this License to the maximum extent possible; and (b) 232 | describe the limitations and the code they affect. Such description must 233 | be placed in a text file included with all distributions of the Covered 234 | Software under this License. Except to the extent prohibited by statute 235 | or regulation, such description must be sufficiently detailed for a 236 | recipient of ordinary skill to be able to understand it. 237 | 238 | 5. Termination 239 | 240 | -------------- 241 | 242 | 5.1. The rights granted under this License will terminate automatically 243 | if You fail to comply with any of its terms. However, if You become 244 | compliant, then the rights granted under this License from a particular 245 | Contributor are reinstated (a) provisionally, unless and until such 246 | Contributor explicitly and finally terminates Your grants, and (b) on an 247 | ongoing basis, if such Contributor fails to notify You of the 248 | non-compliance by some reasonable means prior to 60 days after You have 249 | come back into compliance. Moreover, Your grants from a particular 250 | Contributor are reinstated on an ongoing basis if such Contributor 251 | notifies You of the non-compliance by some reasonable means, this is the 252 | first time You have received notice of non-compliance with this License 253 | from such Contributor, and You become compliant prior to 30 days after 254 | Your receipt of the notice. 255 | 256 | 5.2. If You initiate litigation against any entity by asserting a patent 257 | infringement claim (excluding declaratory judgment actions, 258 | counter-claims, and cross-claims) alleging that a Contributor Version 259 | directly or indirectly infringes any patent, then the rights granted to 260 | You by any and all Contributors for the Covered Software under Section 261 | 2.1 of this License shall terminate. 262 | 263 | 5.3. In the event of termination under Sections 5.1 or 5.2 above, all 264 | end user license agreements (excluding distributors and resellers) which 265 | have been validly granted by You or Your distributors under this License 266 | prior to termination shall survive termination. 267 | 268 | ************************************************************************ 269 | 270 | * * 271 | * 6. Disclaimer of Warranty * 272 | * ------------------------- * 273 | * * 274 | * Covered Software is provided under this License on an "as is" * 275 | * basis, without warranty of any kind, either expressed, implied, or * 276 | * statutory, including, without limitation, warranties that the * 277 | * Covered Software is free of defects, merchantable, fit for a * 278 | * particular purpose or non-infringing. The entire risk as to the * 279 | * quality and performance of the Covered Software is with You. * 280 | * Should any Covered Software prove defective in any respect, You * 281 | * (not any Contributor) assume the cost of any necessary servicing, * 282 | * repair, or correction. This disclaimer of warranty constitutes an * 283 | * essential part of this License. No use of any Covered Software is * 284 | * authorized under this License except under this disclaimer. * 285 | * * 286 | 287 | ************************************************************************ 288 | 289 | ************************************************************************ 290 | 291 | * * 292 | * 7. Limitation of Liability * 293 | * -------------------------- * 294 | * * 295 | * Under no circumstances and under no legal theory, whether tort * 296 | * (including negligence), contract, or otherwise, shall any * 297 | * Contributor, or anyone who distributes Covered Software as * 298 | * permitted above, be liable to You for any direct, indirect, * 299 | * special, incidental, or consequential damages of any character * 300 | * including, without limitation, damages for lost profits, loss of * 301 | * goodwill, work stoppage, computer failure or malfunction, or any * 302 | * and all other commercial damages or losses, even if such party * 303 | * shall have been informed of the possibility of such damages. This * 304 | * limitation of liability shall not apply to liability for death or * 305 | * personal injury resulting from such party's negligence to the * 306 | * extent applicable law prohibits such limitation. Some * 307 | * jurisdictions do not allow the exclusion or limitation of * 308 | * incidental or consequential damages, so this exclusion and * 309 | * limitation may not apply to You. * 310 | * * 311 | 312 | ************************************************************************ 313 | 314 | 8. Litigation 315 | 316 | ------------- 317 | 318 | Any litigation relating to this License may be brought only in the 319 | courts of a jurisdiction where the defendant maintains its principal 320 | place of business and such litigation shall be governed by laws of that 321 | jurisdiction, without reference to its conflict-of-law provisions. 322 | Nothing in this Section shall prevent a party's ability to bring 323 | cross-claims or counter-claims. 324 | 325 | 9. Miscellaneous 326 | 327 | ---------------- 328 | 329 | This License represents the complete agreement concerning the subject 330 | matter hereof. If any provision of this License is held to be 331 | unenforceable, such provision shall be reformed only to the extent 332 | necessary to make it enforceable. Any law or regulation which provides 333 | that the language of a contract shall be construed against the drafter 334 | shall not be used to construe this License against a Contributor. 335 | 336 | 10. Versions of the License 337 | 338 | --------------------------- 339 | 340 | 10.1. New Versions 341 | 342 | Mozilla Foundation is the license steward. Except as provided in Section 343 | 10.3, no one other than the license steward has the right to modify or 344 | publish new versions of this License. Each version will be given a 345 | distinguishing version number. 346 | 347 | 10.2. Effect of New Versions 348 | 349 | You may distribute the Covered Software under the terms of the version 350 | of the License under which You originally received the Covered Software, 351 | or under the terms of any subsequent version published by the license 352 | steward. 353 | 354 | 10.3. Modified Versions 355 | 356 | If you create software not governed by this License, and you want to 357 | create a new license for such software, you may create and use a 358 | modified version of this License if you rename the license and remove 359 | any references to the name of the license steward (except to note that 360 | such modified license differs from this License). 361 | 362 | 10.4. Distributing Source Code Form that is Incompatible With Secondary 363 | Licenses 364 | 365 | If You choose to distribute Source Code Form that is Incompatible With 366 | Secondary Licenses under the terms of this version of the License, the 367 | notice described in Exhibit B of this License must be attached. 368 | 369 | Exhibit A - Source Code Form License Notice 370 | ------------------------------------------- 371 | 372 | This Source Code Form is subject to the terms of the Mozilla Public 373 | License, v. 2.0. If a copy of the MPL was not distributed with this 374 | file, You can obtain one at . 375 | 376 | If it is not possible or desirable to put the notice in a particular 377 | file, then You may include the notice in a location (such as a LICENSE 378 | file in a relevant directory) where a recipient would be likely to look 379 | for such a notice. 380 | 381 | You may add additional accurate notices of copyright ownership. 382 | 383 | Exhibit B - "Incompatible With Secondary Licenses" Notice 384 | --------------------------------------------------------- 385 | 386 | This Source Code Form is "Incompatible With Secondary Licenses", as 387 | defined by the Mozilla Public License, v. 2.0. 388 | -------------------------------------------------------------------------------- /README.md: -------------------------------------------------------------------------------- 1 | # Learn Terraform Modules Create 2 | 3 | Learn what Terraform modules are and when to create them. 4 | 5 | This repo is a companion repo to the [Use Modules from the Registry tutorial](https://developer.hashicorp.com/terraform/tutorials/modules/module-use), containing Terraform configuration files to provision infrastructure using the `vpc` and `ec2-instances` modules. 6 | -------------------------------------------------------------------------------- /main.tf: -------------------------------------------------------------------------------- 1 | # Copyright (c) HashiCorp, Inc. 2 | # SPDX-License-Identifier: MPL-2.0 3 | 4 | provider "aws" { 5 | region = "us-west-2" 6 | 7 | default_tags { 8 | tags = { 9 | hashicorp-learn = "module-use" 10 | } 11 | } 12 | } 13 | 14 | module "vpc" { 15 | source = "terraform-aws-modules/vpc/aws" 16 | version = "3.18.1" 17 | 18 | name = var.vpc_name 19 | cidr = var.vpc_cidr 20 | 21 | azs = var.vpc_azs 22 | private_subnets = var.vpc_private_subnets 23 | public_subnets = var.vpc_public_subnets 24 | 25 | enable_nat_gateway = var.vpc_enable_nat_gateway 26 | 27 | tags = var.vpc_tags 28 | } 29 | 30 | module "ec2_instances" { 31 | source = "terraform-aws-modules/ec2-instance/aws" 32 | version = "4.3.0" 33 | count = 2 34 | 35 | name = "my-ec2-cluster" 36 | 37 | ami = "ami-0c5204531f799e0c6" 38 | instance_type = "t2.micro" 39 | vpc_security_group_ids = [module.vpc.default_security_group_id] 40 | subnet_id = module.vpc.public_subnets[0] 41 | 42 | tags = { 43 | Terraform = "true" 44 | Environment = "dev" 45 | } 46 | } 47 | -------------------------------------------------------------------------------- /outputs.tf: -------------------------------------------------------------------------------- 1 | # Copyright (c) HashiCorp, Inc. 2 | # SPDX-License-Identifier: MPL-2.0 3 | 4 | output "vpc_public_subnets" { 5 | description = "IDs of the VPC's public subnets" 6 | value = module.vpc.public_subnets 7 | } 8 | 9 | output "ec2_instance_public_ips" { 10 | description = "Public IP addresses of EC2 instances" 11 | value = module.ec2_instances[*].public_ip 12 | } 13 | -------------------------------------------------------------------------------- /terraform.tf: -------------------------------------------------------------------------------- 1 | # Copyright (c) HashiCorp, Inc. 2 | # SPDX-License-Identifier: MPL-2.0 3 | 4 | terraform { 5 | /* Uncomment this block to use Terraform Cloud for this tutorial 6 | cloud { 7 | organization = "organization-name" 8 | workspaces { 9 | name = "learn-terraform-module-use" 10 | } 11 | } 12 | */ 13 | 14 | required_providers { 15 | aws = { 16 | source = "hashicorp/aws" 17 | version = "~> 4.49.0" 18 | } 19 | } 20 | required_version = ">= 1.1.0" 21 | } 22 | -------------------------------------------------------------------------------- /variables.tf: -------------------------------------------------------------------------------- 1 | # Copyright (c) HashiCorp, Inc. 2 | # SPDX-License-Identifier: MPL-2.0 3 | 4 | variable "vpc_name" { 5 | description = "Name of VPC" 6 | type = string 7 | default = "example-vpc" 8 | } 9 | 10 | variable "vpc_cidr" { 11 | description = "CIDR block for VPC" 12 | type = string 13 | default = "10.0.0.0/16" 14 | } 15 | 16 | variable "vpc_azs" { 17 | description = "Availability zones for VPC" 18 | type = list(string) 19 | default = ["us-west-2a", "us-west-2b", "us-west-2c"] 20 | } 21 | 22 | variable "vpc_private_subnets" { 23 | description = "Private subnets for VPC" 24 | type = list(string) 25 | default = ["10.0.1.0/24", "10.0.2.0/24"] 26 | } 27 | 28 | variable "vpc_public_subnets" { 29 | description = "Public subnets for VPC" 30 | type = list(string) 31 | default = ["10.0.101.0/24", "10.0.102.0/24"] 32 | } 33 | 34 | variable "vpc_enable_nat_gateway" { 35 | description = "Enable NAT gateway for VPC" 36 | type = bool 37 | default = true 38 | } 39 | 40 | variable "vpc_tags" { 41 | description = "Tags to apply to resources created by VPC module" 42 | type = map(string) 43 | default = { 44 | Terraform = "true" 45 | Environment = "dev" 46 | } 47 | } 48 | --------------------------------------------------------------------------------