Sign-in to your GitHub accout. Then navigate to https:\/\/registry.terraform.io<\/a><\/p>\n\n\n\n On top right side, click on Publish <\/strong>-> Module<\/strong><\/p>\n\n\n\n Click on Sign in with GitHub<\/strong><\/p>\n\n\n\n Click on the green Authorize hashicorp<\/mark><\/strong> button<\/p>\n\n\n\n The screen returns to registry.terraform.io, but note on top right side, you have been signed in as your GitHub account.<\/p>\n\n\n\n Switch to github.com Let’s create a test respository:<\/p>\n\n\n\n This creates an initial repository contains two files:<\/p>\n\n\n\n Note<\/strong>: You may want to spend a bit more time to decide type of license<\/a> you want to apply to your code.<\/p>\n\n\n\n Switch back to registry.terraform.io, on top right side, click on Publish <\/strong>-> Module<\/strong>. Only public github repo with naming format of terraform-<PROVIDER>-<NAME> will be listed here, select the repo just created. Check on I agree to the Term of Use<\/strong>, then click on Publish module<\/strong><\/p>\n\n\n\n You should get an error, basically terraform registry is expecting you to provide a version\/release tag that’s in the format of v1.2.3<\/strong><\/p>\n\n\n\n Version number format MAJOR.MINOR.PATCH, increment the:<\/p>\n\n\n\n Let’s head back to GitHub.com and give our test repo a version number<\/p>\n\n\n\n Click on the 0 tags<\/p>\n\n\n\n A tag requires a release, Create a new release<\/strong><\/p>\n\n\n\n Click on Choose a tag<\/strong>, enter v1.0.0<\/strong> as the version number, then click on Create new tag: v1.0.0 on publish<\/p>\n\n\n\n Note v1.0.0<\/strong> now shows up as the tag, enter description and detail, then click on Publish release<\/strong><\/p>\n\n\n\n You have now created a release v1.0.0<\/p>\n\n\n\n Head back to registry.terraform.io, you should still be in the screen of publishing, click Publish module<\/strong> again<\/p>\n\n\n\n You have published your github repo to terraform registry!<\/p>\n\n\n\n Note the name of the test repository was: terraform-jye-test, you can see JYE is marked as provider, and test has been marked as name of the registry<\/p>\n\n\n\n Also note the URL is: Note the version is marked as Version 1.0.0, which is the current latest version<\/p>\n\n\n\n Note the content of README.md is displayed in the bottom.<\/p>\n\n\n\n Also note that we have no terraform file created in the root directory, hence it has a yellow warning above README.<\/p>\n\n\n\n The minimum recommended module would need following files:<\/p>\n\n\n\n README.md If you want submodules or examples, consider spending a bit more time read this article<\/a> about how to structure your code.<\/p>\n\n\n\n For this example, lets create the three .tf files.<\/p>\n\n\n\n variables.tf<\/p>\n\n\n\n main.tf<\/p>\n\n\n\n outputs.tf<\/p>\n\n\n\n Pretty straightforward, getting the sum of input variables x and y, then write the local variable sum to output.<\/p>\n\n\n\n In your repo on github.com, click on Add file<\/strong> -> Create new file<\/strong><\/p>\n\n\n\n Provide file name and content of the file, as following example. Scroll down and click on Commit new file<\/strong> (by default directly to main branch)<\/p>\n\n\n\n Repeat for all three files:<\/p>\n\n\n\n Let’s create a new release\/tag v1.0.1 Switch to Releases <\/strong>tab, then click on Draft a new release<\/strong><\/p>\n\n\n\n This part now is similar to what accomplished earlier, click on Choose a tag<\/strong>, then enter v1.0.1<\/strong>, then click Create new tag: v1.0.1 on publish<\/strong><\/p>\n\n\n\n Add description and details, then click on Publish release<\/strong><\/p>\n\n\n\n Now switch back to registry.terraform.io, you can quickly search your module by providing your github handle and module name<\/p>\n\n\n\n You will see the latest version gets updated to 1.0.1 automatically, and instruction automatically tells you to insert 2 required variables. In the bottom it lists the 2 inputs and 1 output. Nice!<\/p>\n\n\n\n I’m going to use Visual Studio Code for this part for easier demonstration<\/p>\n\n\n\n First create a folder called test<\/strong>, and populate it with main.tf<\/strong><\/p>\n\n\n\n Copy the Provision instructions code from registry.terraform.io to VS Code<\/p>\n\n\n\n Look at inputs section, and enter the two inputs in VS Code<\/p>\n\n\n\n Your code would look like this:<\/p>\n\n\n\n Add outputs.tf<\/strong>, it references the output sum <\/strong>from the module<\/p>\n\n\n\n Run: terraform init<\/strong> Then run: terraform apply –auto-approve<\/strong> Why? git repository is distributed in nature, also there are tons of repositories not using terraform. You have just created a killer terraform solution and cannot wait to share with world, instead of trying to send people the git repo … Continue reading ![\"\"](\"https:\/\/cloudlearning365.com\/wp-content\/uploads\/2022\/07\/image-31-1024x224.png\")
<\/figure>\n\n\n\n![\"\"](\"https:\/\/cloudlearning365.com\/wp-content\/uploads\/2022\/07\/image-32.png\")
<\/figure>\n\n\n\n![\"\"](\"https:\/\/cloudlearning365.com\/wp-content\/uploads\/2022\/07\/image-33-867x1024.png\")
<\/figure>\n\n\n\n![\"\"](\"https:\/\/cloudlearning365.com\/wp-content\/uploads\/2022\/07\/image-34-1024x317.png\")
<\/figure>\n\n\n\nCreate a test repository in GitHub<\/h2>\n\n\n\n
![\"\"](\"https:\/\/cloudlearning365.com\/wp-content\/uploads\/2022\/07\/image-35-842x1024.png\")
<\/figure>\n\n\n\n![\"\"](\"https:\/\/cloudlearning365.com\/wp-content\/uploads\/2022\/07\/image-36-1024x591.png\")
<\/figure>\n\n\n\nPublish GitHub repository to registry.terraform.io<\/h2>\n\n\n\n
![\"\"](\"https:\/\/cloudlearning365.com\/wp-content\/uploads\/2022\/07\/image-37.png\")
<\/figure>\n\n\n\n![\"\"](\"https:\/\/cloudlearning365.com\/wp-content\/uploads\/2022\/07\/image-38.png\")
<\/figure>\n\n\n\n![\"\"](\"https:\/\/cloudlearning365.com\/wp-content\/uploads\/2022\/07\/image-39-1024x461.png\")
<\/figure>\n\n\n\n![\"\"](\"https:\/\/cloudlearning365.com\/wp-content\/uploads\/2022\/07\/image-40-1024x379.png\")
<\/figure>\n\n\n\n![\"\"](\"https:\/\/cloudlearning365.com\/wp-content\/uploads\/2022\/07\/image-42-1024x816.png\")
<\/figure>\n\n\n\n![\"\"](\"https:\/\/cloudlearning365.com\/wp-content\/uploads\/2022\/07\/image-43-1024x810.png\")
<\/figure>\n\n\n\n![\"\"](\"https:\/\/cloudlearning365.com\/wp-content\/uploads\/2022\/07\/image-44-1024x394.png\")
<\/figure>\n\n\n\n![\"\"](\"https:\/\/cloudlearning365.com\/wp-content\/uploads\/2022\/07\/image-45.png\")
<\/figure>\n\n\n\n
https:\/\/registry.terraform.io\/modules\/jye-aviatrix\/test\/jye\/1.0.0
Which in the format of:
https:\/\/registry.terraform.io\/modules\/<github-handle>\/<registry-name>\/<provider-name>\/<version><\/p>\n\n\n\n![\"\"](\"https:\/\/cloudlearning365.com\/wp-content\/uploads\/2022\/07\/image-46-1024x995.png\")
<\/figure>\n\n\n\nLet’s add some real code<\/h2>\n\n\n\n
main.tf
variables.tf
outputs.tf<\/p>\n\n\n\nvariable \"x\" {\n type = number\n}\n\nvariable \"y\" {\n type = number\n}<\/code><\/pre>\n\n\n\nlocals {\n sum = var.x + var.y\n}<\/code><\/pre>\n\n\n\noutput \"sum\" {\n value = local.sum\n}<\/code><\/pre>\n\n\n\n![\"\"](\"https:\/\/cloudlearning365.com\/wp-content\/uploads\/2022\/07\/image-47-1024x462.png\")
<\/figure>\n\n\n\n![\"\"](\"https:\/\/cloudlearning365.com\/wp-content\/uploads\/2022\/07\/image-48.png\")
<\/figure>\n\n\n\n![\"\"](\"https:\/\/cloudlearning365.com\/wp-content\/uploads\/2022\/07\/image-49-1024x340.png\")
<\/figure>\n\n\n\n
Click on 1 tag<\/strong><\/p>\n\n\n\n![\"\"](\"https:\/\/cloudlearning365.com\/wp-content\/uploads\/2022\/07\/image-50-1024x343.png\")
<\/figure>\n\n\n\n![\"\"](\"https:\/\/cloudlearning365.com\/wp-content\/uploads\/2022\/07\/image-51-1024x387.png\")
<\/figure>\n\n\n\n![\"\"](\"https:\/\/cloudlearning365.com\/wp-content\/uploads\/2022\/07\/image-52-1024x590.png\")
<\/figure>\n\n\n\n![\"\"](\"https:\/\/cloudlearning365.com\/wp-content\/uploads\/2022\/07\/image-53-1024x802.png\")
<\/figure>\n\n\n\n![\"\"](\"https:\/\/cloudlearning365.com\/wp-content\/uploads\/2022\/07\/image-54-1024x203.png\")
<\/figure>\n\n\n\n![\"\"](\"https:\/\/cloudlearning365.com\/wp-content\/uploads\/2022\/07\/image-55-1024x623.png\")
<\/figure>\n\n\n\nLet’s give your new module a spin!<\/h2>\n\n\n\n
![\"\"](\"https:\/\/cloudlearning365.com\/wp-content\/uploads\/2022\/07\/image-56-1024x623.png\")
<\/figure>\n\n\n\n![\"\"](\"https:\/\/cloudlearning365.com\/wp-content\/uploads\/2022\/07\/image-58.png\")
<\/figure>\n\n\n\n![\"\"](\"https:\/\/cloudlearning365.com\/wp-content\/uploads\/2022\/07\/image-57.png\")
<\/figure>\n\n\n\n![\"\"](\"https:\/\/cloudlearning365.com\/wp-content\/uploads\/2022\/07\/image-59-1024x174.png\")
<\/figure>\n\n\n\nmodule \"test\" {\n source = \"jye-aviatrix\/test\/jye\"\n version = \"1.0.1\"\n # insert the 2 required variables here\n x = 20\n y = 6\n}<\/code><\/pre>\n\n\n\noutput \"sum\" {\n value = module.test.sum\n}<\/code><\/pre>\n\n\n\n
Since we didn’t specify any version constrain, it automatically downloaded latest version<\/p>\n\n\n\n![\"\"](\"https:\/\/cloudlearning365.com\/wp-content\/uploads\/2022\/07\/image-60.png\")
<\/figure>\n\n\n\n
Looking great!<\/p>\n\n\n\n![\"\"](\"https:\/\/cloudlearning365.com\/wp-content\/uploads\/2022\/07\/image-61-1024x204.png\")
<\/figure>\n","protected":false},"excerpt":{"rendered":"