Skip to content

Commit 55b30d1

Browse files
committed
Generate docs
1 parent cb4f5fc commit 55b30d1

File tree

4 files changed

+40
-7
lines changed

4 files changed

+40
-7
lines changed

docs/index.md

Lines changed: 37 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -26,7 +26,9 @@ The following methods are supported:
2626

2727
### Static credentials
2828

29-
Default static credentials can be provided by adding the `username`, `password` and `endpoints` in `elasticsearch` block:
29+
#### Elasticsearch
30+
31+
Default static credentials can be provided by adding the `username`, `password` and `endpoints` in the `elasticsearch` block:
3032

3133
```terraform
3234
provider "elasticstack" {
@@ -49,16 +51,47 @@ provider "elasticstack" {
4951
}
5052
```
5153

54+
#### Kibana
55+
56+
Default static credentials can be provided by adding the `username`, `password` and `endpoints` in the `kibana` block:
57+
58+
```terraform
59+
provider "elasticstack" {
60+
kibana {
61+
username = "elastic"
62+
password = "changeme"
63+
endpoints = ["http://localhost:5601"]
64+
}
65+
}
66+
```
67+
68+
If no credentials are supplied the provider will fall back to using those provided in the `elasticsearch` block.
69+
5270
### Environment Variables
5371

54-
You can provide your credentials for the default connection via the `ELASTICSEARCH_USERNAME`, `ELASTICSEARCH_PASSWORD` and comma-separated list `ELASTICSEARCH_ENDPOINTS`,
55-
environment variables, representing your user, password and Elasticsearch API endpoints respectively.
72+
The provider configuration can be specified through environment variables.
73+
74+
For Elasticsearch resources, you can use the following variables:
75+
- `ELASTICSEARCH_USERNAME` - The username to use for Elasticsearch authentication
76+
- `ELASTICSEARCH_PASSWORD` - The password to use for Elasticsearch authentication
77+
- `ELASTICSEARCH_ENDPOINTS` - A comma separated list of Elasticsearch hosts to connect to
78+
- `ELASTICSEARCH_API_KEY` - An Elasticsearch API key to use instead of `ELASTICSEARCH_USERNAME` and `ELASTICSEARCH_PASSWORD`
79+
80+
Kibana resources will re-use any Elasticsearch credentials specified, these may be overridden with the following variables:
81+
- `KIBANA_USERNAME` - The username to use for Kibana authentication
82+
- `KIBANA_PASSWORD` - The password to use for Kibana authentication
83+
- `KIBANA_ENDPOINT` - The Kibana host to connect to
5684

57-
Alternatively the `ELASTICSEARCH_API_KEY` variable can be specified instead of `ELASTICSEARCH_USERNAME` and `ELASTICSEARCH_PASSWORD`.
85+
Fleet resources will re-use any Kibana or Elasticsearch credentials specified, these may be overridden with the following variables:
86+
- `FLEET_USERNAME` - The username to use for Kibana authentication
87+
- `FLEET_PASSWORD` - The password to use for Kibana authentication
88+
- `FLEET_ENDPOINT` - The Kibana host to connect to. ** Note the Fleet API is hosted within Kibana. This must be a Kibana HTTP host **
89+
- `FLEET_API_KEY` - API key to use for authentication to Fleet
5890

5991
```terraform
6092
provider "elasticstack" {
6193
elasticsearch {}
94+
kibana {}
6295
}
6396
```
6497

docs/resources/kibana_action_connector.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -14,7 +14,7 @@ Creates or updates a Kibana action connector. See https://www.elastic.co/guide/e
1414

1515
```terraform
1616
provider "elasticstack" {
17-
elasticsearch {}
17+
kibana {}
1818
}
1919
2020
resource "elasticstack_kibana_action_connector" "example" {

docs/resources/kibana_alerting_rule.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -14,7 +14,7 @@ Creates or updates a Kibana alerting rule. See https://www.elastic.co/guide/en/k
1414

1515
```terraform
1616
provider "elasticstack" {
17-
elasticsearch {}
17+
kibana {}
1818
}
1919
2020
resource "elasticstack_kibana_alerting_rule" "example" {

docs/resources/kibana_space.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -14,7 +14,7 @@ Creates or updates a Kibana space. See https://www.elastic.co/guide/en/kibana/ma
1414

1515
```terraform
1616
provider "elasticstack" {
17-
elasticsearch {}
17+
kibana {}
1818
}
1919
2020
resource "elasticstack_kibana_space" "example" {

0 commit comments

Comments
 (0)