@@ -71,10 +71,63 @@ removed from Terraform configuration. Instead `count` meta-parameter should be u
71
71
> Terraform automatically discovers the Providers when it parses configuration files.
72
72
> This only occurs when the init command is executed.
73
73
74
- Currently Terraform is able to automatically download only
75
- [ official plugins distributed by HashiCorp] ( https://github.com/terraform-providers ) .
74
+ Currently Terraform is able to automatically download only [ official plugins distributed by HashiCorp] ( https://github.com/terraform-providers ) .
76
75
77
- [ All other plugins] ( https://www.terraform.io/docs/providers/type/community-index.html ) should be installed manually.
76
+ The provider plugin can be installed automatically via [ Para - 3rd-party plugin manager for Terraform] ( https://github.com/paraterraform/para )
77
+ or it can be downloaded and installed manually.
78
+
79
+ ### Para
80
+
81
+ This plugin is available via [ default index] ( https://github.com/paraterraform/index ) for [ Para] ( https://github.com/paraterraform/para ) .
82
+ If you use Para or Para Launcher you can just skip to the [ Usage] ( #usage ) section below assuming you'd wrap all calls to Terraform with Para:
83
+ ``` bash
84
+ $ ./para terraform init
85
+ Para Launcher Activated!
86
+ - Checking para.cfg.yaml in current directory for ' version: X.Y.Z'
87
+ - Desired version: latest (latest is used when no version specified)
88
+ - Executing ' $TMPDIR/para-501/para/latest/para_v0.3.1_darwin-amd64'
89
+
90
+ ------------------------------------------------------------------------
91
+
92
+ Para is being initialized...
93
+ - Cache Dir: $TMPDIR /para-501
94
+ - Terraform: downloading to $TMPDIR /para-501/terraform/0.12.2/darwin_amd64
95
+ - Plugin Dir: terraform.d/plugins
96
+ - Primary Index: https://raw.githubusercontent.com/paraterraform/index/master/para.idx.yaml as of 2019-06-22T00:59:24-04:00 (providers: 16)
97
+ - Index Extensions: para.idx.d (0/0), ~ /.para/para.idx.d (0/0), /etc/para/para.idx.d (0/0)
98
+ - Command: terraform init
99
+
100
+ ------------------------------------------------------------------------
101
+
102
+
103
+ Initializing the backend...
104
+
105
+ Initializing provider plugins...
106
+ - Para provides 3rd-party Terraform provider plugin ' stateful' version ' v1.1.0' for ' darwin_amd64' (downloading)
107
+
108
+
109
+ The following providers do not have any version constraints in configuration,
110
+ so the latest version was installed.
111
+
112
+ To prevent automatic upgrades to new major versions that may contain breaking
113
+ changes, it is recommended to add version = " ..." constraints to the
114
+ corresponding provider blocks in configuration, with the constraint strings
115
+ suggested below.
116
+
117
+ * provider.stateful: version = " ~> 1.1"
118
+
119
+ Terraform has been successfully initialized!
120
+ ```
121
+
122
+ If you use Para but don't use the [ default index] ( https://github.com/paraterraform/index ) you can make the plugin available
123
+ by including index extension for this plugin: either add [ ` provider.stateful.yaml ` ] ( ./provider.stateful.yaml ) from this
124
+ repo to your [ Para index extensions dir] ( https://github.com/paraterraform/para#extensions ) to fix currently available versions
125
+ or create ` provider.stateful.yaml ` as an empty file and put the URL to the aforementioned file inside to automatically get updates:
126
+ ``` yaml
127
+ https://raw.githubusercontent.com/ashald/terraform-provider-stateful/master/go.mod
128
+ ```
129
+
130
+ ### Manual
78
131
79
132
> Terraform will search for matching Providers via a
80
133
> [ Discovery] ( https://www.terraform.io/docs/extend/how-terraform-works.html#discovery ) process, ** including the current
0 commit comments