This project contains the original source code of the intellij-hcl plugin. The code in this repository is kept static and can be used for historical reference only: no pull requests will be accepted.
Please create new issues (feature requests and bug reports) in IntelliJ IDEA tracker.
New sources can be found in JetBrains/intellij-plugins repository under terraform
directory.
You can still download the new versions of the free plugin from JetBrains from the JetBrains plugin repository.
Provides HCL language and Terraform configuration files (.tf
) support for IntelliJ Platform-based IDEs
The HCL format is used for Nomad(.nomad
files).
Plugin page in IntelliJ platform plugin repository.
I'd been developing this plugin for four years in my free time before last year, when it became obvious that due to lack of free time I could not keep up with the newest Terraform features.
Meanwhile, IaaC and especially Terraform is becoming more and more popular, so I decided to transfer the plugin ownership to JetBrains. I believe that JetBrains has the resources to improve the plugin over time and provide efficient user support.
I'd like to thank all users, contributors, people who spotted and reported bugs, and everyone who promoted the plugin all those years.
As part of the transition, the source code was moved to the main IntelliJ repository which is private. The JetBrains plugin is free. The main plugin features will be compatible with JetBrains' free IDEs ([IntelliJ IDEA, PyCharm]x[Community, Education] Editions) as well as Google's Android Studio. Note that the main features include but are not limited to the features below.
- Syntax highlighting
- Structure outline in the 'Structure' tool window
- Code formatter with the 'Reformat code' action available
- Code folding
- Comment/Uncomment action
- Interpolations syntax highlighting
- (WIP) Properties validation (according to the properties required for resource/provider, type checking)
- (WIP) Go to definition from resource to provider
- Syntax highlighting
- Autocompletion for predefined methods
- (WIP) Go to declaration on resources, providers, properties, etc.
- Find usages for resources, providers, variables
Starting from version 0.6.14 it's possible to use external source of Terraform model. Previously plugins updates were necessary once something was updated in Terraform itself or providers.
Plugin reads metadata from specially-formatted json files located at (in order):
TERRAFORM_GLOBAL_DIR/schemas
(intended for schemas for your custom providers/provisioners) andTERRAFORM_GLOBAL_DIR/metadata-repo/terraform/model
(semi-automatically updated schemas) and- Plugin itself
Here TERRAFORM_GLOBAL_DIR
stands for $HOME/.terraform.d
on Linux/macOS and %APPDATA%/terraform.d
on Windows.
ℹ️ Recommended approach is to clone special repo as TERRAFORM_GLOBAL_DIR/metadata-repo
and later update it from time to time.
Linux/macOS user may use commands like:
# To initial clone
mkdir -p "$HOME/.terraform.d/"
git clone https://github.com/VladRassokhin/terraform-metadata "$HOME/.terraform.d/metadata-repo"
# To update metadata
git -C "$HOME/.terraform.d/metadata-repo" pull
# Don't forget to restart IntelliJ after that