![\"\"](\"https:\/\/artem.services\/wp-content\/uploads\/2018\/10\/terraform.png\")
<\/p>\n<\/p>\n
In this example, we will create a Terraform<\/strong> module for the AWS<\/strong> provider, which will be launched for 3 different environments using Terragrunt<\/strong>.<\/p>\n <\/p>\n Requirements:<\/p>\n <\/p>\n <\/p>\n Create the required files for Terragrunt<\/strong>:<\/p>\n <\/p>\n Set the S3<\/strong> bucket name that will store Terragrunt<\/strong>\u2019s state, you don\u2019t need to create it first, Terragrunt<\/strong> will create it yourself. We also set the region.<\/p>\n Create a file to store Terraform<\/strong> and Terragrunt<\/strong> variables:<\/p>\n <\/p>\n We will write the first module that will create the VPC<\/strong> and Internet Gateway<\/strong> for it.<\/p>\n We create a directory for modules and for VPC in<\/strong> particular:<\/p>\n <\/p>\n Modules work on the principle of a function; when accessing them, we pass a number of variables.<\/p>\n To create a VPC<\/strong>, we need to know the following:<\/p>\n <\/p>\n Create a separate file for the variables "modules\/vpc\/variables.tf<\/strong>" and add the following:<\/p>\n <\/p>\n We create the module itself, for this we create the file "modules\/vpc\/main.tf<\/strong>" with the following contents:<\/p>\n <\/p>\n We will create a template for three different environments:<\/p>\n <\/p>\n Fill out the variable file for Terragrunt<\/strong>:<\/p>\n <\/p>\n Now fill in the Terraform<\/strong> variables file:<\/p>\n <\/p>\n We are ready to create the first environment, we will begin with the development<\/strong> of the environment<\/p>\n Create the structure:<\/p>\n <\/p>\n Let’s go to the created directory:<\/p>\n <\/p>\n Create the required file "terragrunt.hcl<\/strong>" and paste the following into it:<\/p>\n <\/p>\n And create symbolic links to variable files located in the root:<\/p>\n <\/p>\n Create the file "main.tf<\/strong>" with the following contents:<\/p>\n <\/p>\n That’s it, now you can create a Terraform<\/strong> file to call the module to create a VPC<\/strong>.<\/p>\n <\/p>\n Run:<\/p>\n <\/p>\n At the first start, Terragrunt<\/strong> will say that the bucket for storing states does not exist, and will offer to create it, we agree.<\/p>\n After init<\/strong>, we look at the version of Terraform<\/strong> and the AWS<\/strong> provider, it is better to specify these versions in the "main.tf<\/strong>" file, if you plan to start from another computer (since we create a basket to store the state, we mean launch from any computer keeping current state)<\/p>\n <\/p>\n <\/p>\n Now, following the example of a development<\/strong> environment, we will create staging<\/strong> and production<\/strong>. Go back to the root of the project, delete the ".terraform<\/strong>" directory in "envarinments\/development<\/strong>" and copy the development<\/strong> environment:<\/p>\n <\/p>\n Change the variables for staging<\/strong>:<\/p>\n <\/p>\n Change the variables for production<\/strong>:<\/p>\n <\/p>\n Now, being at the root of the project, we can start planning for all environments with one command:<\/p>\n <\/p>\n You can apply this template for each environment in particular, being in the directory of the necessary environment, run:<\/p>\n <\/p>\n Or for all at once, being at the root of the project, run:<\/p>\n <\/p>\n Our final structure is as follows:<\/p>\n <\/p>\n In order to store our template in the repository, add the following to the ".gitignore<\/strong>" file:<\/p>\n <\/p>\n This example can be downloaded from the Git<\/strong> repository:<\/p>\n In this example, we will create a Terraform module for the AWS provider, which will be launched for 3 different environments using Terragrunt. Requirements: Installed AWS CLI Installed Terraform (version above 12.0) Installed Terragrunt <\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":[],"categories":[541],"tags":[543,1253,555,1255],"_links":{"self":[{"href":"https:\/\/artem.services\/index.php?rest_route=\/wp\/v2\/posts\/1428"}],"collection":[{"href":"https:\/\/artem.services\/index.php?rest_route=\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/artem.services\/index.php?rest_route=\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/artem.services\/index.php?rest_route=\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/artem.services\/index.php?rest_route=%2Fwp%2Fv2%2Fcomments&post=1428"}],"version-history":[{"count":7,"href":"https:\/\/artem.services\/index.php?rest_route=\/wp\/v2\/posts\/1428\/revisions"}],"predecessor-version":[{"id":2116,"href":"https:\/\/artem.services\/index.php?rest_route=\/wp\/v2\/posts\/1428\/revisions\/2116"}],"wp:attachment":[{"href":"https:\/\/artem.services\/index.php?rest_route=%2Fwp%2Fv2%2Fmedia&parent=1428"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/artem.services\/index.php?rest_route=%2Fwp%2Fv2%2Fcategories&post=1428"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/artem.services\/index.php?rest_route=%2Fwp%2Fv2%2Ftags&post=1428"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}\n
terragrunt.hcl<\/h3>\n
\r\nterraform {\r\n extra_arguments "custom_vars" {\r\n commands = get_terraform_commands_that_need_vars()\r\n arguments = [\r\n "-var-file=${get_terragrunt_dir()}\/common.tfvars",\r\n ]\r\n }\r\n}\r\n\r\nremote_state {\r\n backend = "s3"\r\n config = {\r\n bucket = "tfstate.eu-west-2.artem"\r\n key = "${path_relative_to_include()}\/terraform.tfstate"\r\n region = "eu-west-2"\r\n encrypt = true\r\n dynamodb_table = "my-lock-table"\r\n }\r\n}\r\n<\/pre>\n\r\ntouch common.tfvars variables.tf\r\n<\/pre>\n
\r\nmkdir -p modules\/vpc\r\n<\/pre>\n
\n
\r\nvariable "vpc_name" {}\r\nvariable "vpc_cidr" {}\r\n<\/pre>\n\r\n#################### CREATE VPC ####################\r\n\r\nresource "aws_vpc" "vpc" {\r\n cidr_block = var.vpc_cidr\r\n enable_dns_hostnames = "true"\r\n enable_dns_support = "true"\r\n\r\n tags = {\r\n Name = var.vpc_name\r\n }\r\n}\r\n \r\n############# CREATE INTERNET GATEWAY ##############\r\n\r\nresource "aws_internet_gateway" "igw" {\r\n vpc_id = aws_vpc.vpc.id\r\n \r\n tags = {\r\n Name = "${var.vpc_name}-IGW"\r\n }\r\n}\r\n<\/pre>\n\n
common.tfvars<\/h3>\n
\r\n### DEVELOPMENT ENVIRONMENT ####\r\n\r\ndevelopment_aws_region = "us-east-1"\r\ndevelopment_vpc_name = "ARTEM-DEVELOPMENT-USE1"\r\ndevelopment_vpc_cidr = "192.168.0.0\/16"\r\n\r\n######### END OF BLOCK #########\r\n\r\n##### STAGING ENVIRONMENT ######\r\n\r\nstaging_aws_region = "us-east-1"\r\nstaging_vpc_name = "ARTEM-STAGING-USE1"\r\nstaging_vpc_cidr = "192.168.0.0\/16"\r\n\r\n######### END OF BLOCK #########\r\n\r\n#### PRODUCTION ENVIRONMENT ####\r\n\r\nproduction_aws_region = "eu-central-1"\r\nproduction_vpc_name = "ARTEM-PRODUCTION-EUC1"\r\nproduction_vpc_cidr = "192.168.0.0\/16"\r\n\r\n######### END OF BLOCK #########\r\n<\/pre>\n
variables.tf<\/h3>\n
\r\n### DEVELOPMENT ENVIRONMENT ####\r\n\r\nvariable "development_aws_region" {}\r\nvariable "development_vpc_name" {}\r\nvariable "development_vpc_cidr" {}\r\n\r\n######### END OF BLOCK #########\r\n\r\n##### STAGING ENVIRONMENT ######\r\n\r\nvariable "staging_aws_region" {}\r\nvariable "staging_vpc_name" {}\r\nvariable "staging_vpc_cidr" {}\r\n\r\n######### END OF BLOCK #########\r\n\r\n#### PRODUCTION ENVIRONMENT ####\r\n\r\nvariable "production_aws_region" {}\r\nvariable "production_vpc_name" {}\r\nvariable "production_vpc_cidr" {}\r\n\r\n######### END OF BLOCK #########\r\n<\/pre>\n\r\nmkdir -p environments\/development\r\n<\/pre>\n
\r\ncd environments\/development\r\n<\/pre>\n
\r\ninclude {\r\n path = find_in_parent_folders()\r\n}\r\n<\/pre>\n\r\nln -s ..\/..\/variables.tf variables.tf\r\nln -s ..\/..\/common.tfvars common.tfvars\r\n<\/pre>\n
\r\nterraform {\r\n backend "s3" {}\r\n}\r\n\r\nprovider "aws" {\r\n region = var.development_aws_region\r\n}\r\n<\/pre>\nvpc.tf<\/h3>\n
\r\nmodule "vpc" {\r\n source = "..\/..\/modules\/vpc"\r\n vpc_name = var.development_vpc_name\r\n vpc_cidr = var.development_vpc_cidr\r\n}\r\n<\/pre>\n\r\nterragrunt init\r\n<\/pre>\n
\r\nterraform --version\r\nTerraform v0.12.9\r\n+ provider.aws v2.30.0\r\n<\/pre>\n
main.tf<\/h3>\n
\r\nterraform {\r\n backend "s3" {}\r\n required_version = "~> 0.12.9"\r\n}\r\n\r\nprovider "aws" {\r\n region = var.development_aws_region\r\n version = "~> 2.30"\r\n}\r\n<\/pre>\n\r\nrm -rf environments\/development\/.terraform\/\r\ncp -aR environments\/development environments\/staging\r\ncp -aR environments\/development environments\/production\r\n<\/pre>\n
\r\nsed -i 's\/development\/staging\/g' environments\/staging\/{main.tf,vpc.tf}\r\n<\/pre>\n\r\nsed -i 's\/development\/production\/g' environments\/production\/{main.tf,vpc.tf}\r\n<\/pre>\n\r\nterragrunt plan-all\r\n<\/pre>\n
\r\nterragrunt apply\r\n<\/pre>\n
\r\nterragrunt apply-all\r\n<\/pre>\n
\r\n.\r\n\u251c\u2500\u2500 common.tfvars\r\n\u251c\u2500\u2500 environments\r\n\u2502 \u251c\u2500\u2500 development\r\n\u2502 \u2502 \u251c\u2500\u2500 common.tfvars -> ..\/..\/common.tfvars\r\n\u2502 \u2502 \u251c\u2500\u2500 main.tf\r\n\u2502 \u2502 \u251c\u2500\u2500 terragrunt.hcl\r\n\u2502 \u2502 \u251c\u2500\u2500 variables.tf -> ..\/..\/variables.tf\r\n\u2502 \u2502 \u2514\u2500\u2500 vpc.tf\r\n\u2502 \u251c\u2500\u2500 production\r\n\u2502 \u2502 \u251c\u2500\u2500 common.tfvars -> ..\/..\/common.tfvars\r\n\u2502 \u2502 \u251c\u2500\u2500 main.tf\r\n\u2502 \u2502 \u251c\u2500\u2500 terragrunt.hcl\r\n\u2502 \u2502 \u251c\u2500\u2500 variables.tf -> ..\/..\/variables.tf\r\n\u2502 \u2502 \u2514\u2500\u2500 vpc.tf\r\n\u2502 \u2514\u2500\u2500 staging\r\n\u2502 \u251c\u2500\u2500 common.tfvars -> ..\/..\/common.tfvars\r\n\u2502 \u251c\u2500\u2500 main.tf\r\n\u2502 \u251c\u2500\u2500 terragrunt.hcl\r\n\u2502 \u251c\u2500\u2500 variables.tf -> ..\/..\/variables.tf\r\n\u2502 \u2514\u2500\u2500 vpc.tf\r\n\u251c\u2500\u2500 modules\r\n\u2502 \u2514\u2500\u2500 vpc\r\n\u2502 \u251c\u2500\u2500 main.tf\r\n\u2502 \u2514\u2500\u2500 variables.tf\r\n\u251c\u2500\u2500 terragrunt.hcl\r\n\u2514\u2500\u2500 variables.tf\r\n\r\n6 directories, 20 files\r\n<\/pre>\n
\r\n.terraform\/\r\nterraform.*\r\n<\/pre>\n
https:\/\/bitbucket.org\/artem-gatchenko\/example-terraform-module-part1<\/pre>\n","protected":false},"excerpt":{"rendered":"