Skip to content

Commit 8af14a6

Browse files
committed
Add innstallation instructions for Para
1 parent 4fbc79e commit 8af14a6

File tree

2 files changed

+74
-3
lines changed

2 files changed

+74
-3
lines changed

README.md

+56-3
Original file line numberDiff line numberDiff line change
@@ -71,10 +71,63 @@ removed from Terraform configuration. Instead `count` meta-parameter should be u
7171
> Terraform automatically discovers the Providers when it parses configuration files.
7272
> This only occurs when the init command is executed.
7373
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).
7675

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
78131

79132
> Terraform will search for matching Providers via a
80133
> [Discovery](https://www.terraform.io/docs/extend/how-terraform-works.html#discovery) process, **including the current

provider.stateful.yaml

+18
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,18 @@
1+
v1.1.0:
2+
darwin_amd64:
3+
url: https://github.com/ashald/terraform-provider-stateful/releases/download/v1.1.0/terraform-provider-stateful_v1.1.0-darwin-amd64.zip
4+
size: 27599364
5+
digest: sha256:d773f5aec17078b2d57eddc5b0d61feaea6fe122ee1008a3ef3876286494ec68
6+
linux_amd64:
7+
url: https://github.com/ashald/terraform-provider-stateful/releases/download/v1.1.0/terraform-provider-stateful_v1.1.0-linux-amd64.zip
8+
size: 27833249
9+
digest: sha256:79a8b843079e97d31dfc6119365b1c0cc765f7a03ece873e5b971bb4361a82e6
10+
v1.0.0:
11+
darwin_amd64:
12+
url: https://github.com/ashald/terraform-provider-stateful/releases/download/v1.0.0/terraform-provider-stateful_v1.0.0-darwin-amd64.zip
13+
size: 28276500
14+
digest: sha256:9558ab0736d31506d731336968d10c6061b00ff394162eba772710133d077cf4
15+
linux_amd64:
16+
url: https://github.com/ashald/terraform-provider-stateful/releases/download/v1.0.0/terraform-provider-stateful_v1.0.0-linux-amd64.zip
17+
size: 28389643
18+
digest: sha256:1a7fe649f0f9b5a9f17a6914dd81b36256adba16008121db526480bff86d3c69

0 commit comments

Comments
 (0)