VS Code extension for developing with Terraform on Azure
Перейти к файлу
microsoft-github-policy-service[bot] d77e057616
Microsoft mandatory file (#247)
Co-authored-by: microsoft-github-policy-service[bot] <77245923+microsoft-github-policy-service[bot]@users.noreply.github.com>
2023-03-29 16:04:36 +08:00
.vscode Adding vs code files 2017-12-08 18:03:43 -08:00
bin Added support for cloudshell 2017-12-11 19:43:54 -08:00
images Update the overview picture (#157) 2018-03-28 10:11:27 +08:00
src upgrade deps "vscode-extension-telemetry-wrapper" (#223) 2020-12-07 12:26:53 +08:00
.gitignore add vscodeignore (#84) 2018-01-31 13:17:40 +08:00
.travis.yml enable npm run test for CI process (#204) 2019-10-18 16:40:38 +08:00
.vscodeignore add eula (#141) 2018-03-14 09:26:53 +08:00
CHANGELOG.md update version and changelog (#224) 2020-12-07 13:28:35 +08:00
EULA.rtf add eula (#141) 2018-03-14 09:26:53 +08:00
LICENSE Initial commit 2017-12-07 14:01:55 -08:00
README.md Remove a useless quote in REAME.md (#190) 2019-02-28 14:03:28 +08:00
SECURITY.md Microsoft mandatory file (#247) 2023-03-29 16:04:36 +08:00
package-lock.json Bump qs from 6.5.2 to 6.5.3 (#237) 2022-12-19 13:13:12 +08:00
package.json Bump lodash from 4.17.19 to 4.17.21 (#228) 2022-04-25 16:06:00 +08:00
thirdpartynotices.txt use the azure account's api to provision cloud shell (#146) 2018-03-24 10:56:14 +08:00
tsconfig.json use the azure account's api to provision cloud shell (#146) 2018-03-24 10:56:14 +08:00
tslint.json extract dialog buttons (#60) 2018-01-29 10:52:43 +08:00

README.md

Azure Terraform

Build Status Release Status

The VSCode Azure Terraform extension is designed to increase developer productivity authoring, testing and using Terraform with Azure. The extension provides terraform command support, resource graph visualization and CloudShell integration inside VSCode.

overview

Requirements

This extension requires:

  • Terraform - If you are executing terraform commands in integrated teminal.
  • Node.js 6.0+ - If you are using Cloud Shell.
  • GraphViz - If you are using the visualize feature.

NOTE: Please make sure these requirements are in your PATH environment variable.

Features

The features in this extension support execution in integrated terminal mode or remotely using Azure Cloud Shell. Some features only run locally at this time and will require some local dependencies.

This extension supports the following features:

  • Terraform commands: init, plan, apply, validate, refresh and destroy.
  • Visualize the terraform module.

Commands

Open the Command Palette (Command+Shift+P on macOS and Ctrl+Shift+P on Windows/Linux) and type in one of the following commands:

Command Description
Basic commands:
  • Azure Terraform: init
  • Azure Terraform: plan
  • Azure Terraform: apply
  • Azure Terraform: validate
  • Azure Terraform: refresh
  • Azure Terraform: destroy
Execute terraform command against the current project workspace. If run with terminal set to Cloud Shell, will run the command in Cloud Shell.
Azure Terraform: visualize Create a visual representation of the components of the module and save it in graph.png.
Azure Terraform: push Push workspace files that meet the filter azureTerraform.files setting in your configuration to Cloud Shell.
Azure Terraform: Execute Test Run one of the following test against the current module using a test container:
  • lint: This command will check the formating of the code of the Terraform module.
  • e2e: This command will deploy the current module with the settings specified in the .tfvars file, verify that the deployment pass the controls and destroy the resources that have been created.

Extension Settings

  • azureTerraform.terminal - Specifies terminal used to run Terraform commands. Valid settings are cloudshell or integrated.
  • azureTerraform.files - Indicates the files that should be synchronized to Azure CloudShell using the glob pattern string. By default **/*.{rb,sh,tf,tfvars,txt,yml}.
  • azureTerraform.test.imageName - Indicates the container to use to run the tests. By default: microsoft/terraform-test.
  • azureTerraform.test.aciName - Indicates the name of the Azure Container Instance to use for testing. By default: tf-test-aci.
  • azureTerraform.test.aciResourceGroup - Indicates the name of the Resource Group to use for the ACI instance. By default: tfTestResourceGroup.
  • azureTerraform.aciContainerGroup - Indicates the name of the Container Group that host the ACI instance. By default: tfTestContainerGroup
  • azureTerraform.test.location - Indicates the location where to deploy the test container instance. By default: westus.

Release Notes

Refer to CHANGELOG

Telemetry

VS Code collects usage data and sends it to Microsoft to help improve our products and services. Read our privacy statement to learn more. If you would like to opt out of sending telemetry data to Microsoft, update the telemetry.enableTelemetry setting to false in the File -> Preferences -> Settings. Read our FAQ to learn more.

License

MIT