Skip to content

Commit 11c63a0

Browse files
authored
Add 'Defaults to .' to descriptions for each attribute (#1394)
1 parent 8ca4a35 commit 11c63a0

File tree

7 files changed

+90
-88
lines changed

7 files changed

+90
-88
lines changed

docs/data-sources/template.md

Lines changed: 17 additions & 17 deletions
Original file line numberDiff line numberDiff line change
@@ -25,47 +25,47 @@ For further details on the `helm template` command, refer to the [Helm documenta
2525
### Optional
2626

2727
- `api_versions` (List of String) Kubernetes api versions used for Capabilities.APIVersions
28-
- `atomic` (Boolean) If set, installation process purges chart on fail. The wait flag will be set automatically if atomic is used
28+
- `atomic` (Boolean) If set, installation process purges chart on fail. The wait flag will be set automatically if atomic is used. Defaults to `false`.
2929
- `crds` (List of String) List of rendered CRDs from the chart.
30-
- `create_namespace` (Boolean) Create the namespace if it does not exist
31-
- `dependency_update` (Boolean) Run helm dependency update before installing the chart
30+
- `create_namespace` (Boolean) Create the namespace if it does not exist. Defaults to `false`.
31+
- `dependency_update` (Boolean) Run helm dependency update before installing the chart. Defaults to `false`.
3232
- `description` (String) Add a custom description
3333
- `devel` (Boolean) Use chart development versions, too. Equivalent to version '>0.0.0-0'. If `version` is set, this is ignored
34-
- `disable_openapi_validation` (Boolean) If set, the installation process will not validate rendered templates against the Kubernetes OpenAPI Schema
35-
- `disable_webhooks` (Boolean) Prevent hooks from running.
34+
- `disable_openapi_validation` (Boolean) If set, the installation process will not validate rendered templates against the Kubernetes OpenAPI Schema.Defaults to `false`.
35+
- `disable_webhooks` (Boolean) Prevent hooks from running.Defaults to `300` seconds.
3636
- `include_crds` (Boolean) Include CRDs in the templated output
3737
- `is_upgrade` (Boolean) Set .Release.IsUpgrade instead of .Release.IsInstall
38-
- `keyring` (String) Location of public keys used for verification. Used only if `verify` is true
38+
- `keyring` (String) Location of public keys used for verification. Used only if `verify` is true. Defaults to `/.gnupg/pubring.gpg` in the location set by `home`.
3939
- `kube_version` (String) Kubernetes version used for Capabilities.KubeVersion
4040
- `manifest` (String) Concatenated rendered chart templates. This corresponds to the output of the `helm template` command.
4141
- `manifests` (Map of String) Map of rendered chart templates indexed by the template name.
42-
- `namespace` (String) Namespace to install the release into.
42+
- `namespace` (String) Namespace to install the release into. Defaults to `default`.
4343
- `notes` (String) Rendered notes if the chart contains a `NOTES.txt`.
44-
- `pass_credentials` (Boolean) Pass credentials to all domains
44+
- `pass_credentials` (Boolean) Pass credentials to all domains. Defaults to `false`.
4545
- `postrender` (Block List, Max: 1) Postrender command configuration. (see [below for nested schema](#nestedblock--postrender))
46-
- `render_subchart_notes` (Boolean) If set, render subchart notes along with the parent
47-
- `replace` (Boolean) Re-use the given name, even if that name is already used. This is unsafe in production
46+
- `render_subchart_notes` (Boolean) If set, render subchart notes along with the parent. Defaults to `true`.
47+
- `replace` (Boolean) Re-use the given name, even if that name is already used. This is unsafe in production. Defaults to `false`.
4848
- `repository` (String) Repository where to locate the requested chart. If is a URL the chart is installed without installing the repository.
4949
- `repository_ca_file` (String) The Repositories CA File
5050
- `repository_cert_file` (String) The repositories cert file
5151
- `repository_key_file` (String) The repositories cert key file
5252
- `repository_password` (String, Sensitive) Password for HTTP basic authentication
5353
- `repository_username` (String) Username for HTTP basic authentication
54-
- `reset_values` (Boolean) When upgrading, reset the values to the ones built into the chart
55-
- `reuse_values` (Boolean) When upgrading, reuse the last release's values and merge in any overrides. If 'reset_values' is specified, this is ignored
54+
- `reset_values` (Boolean) When upgrading, reset the values to the ones built into the chart.Defaults to `false`.
55+
- `reuse_values` (Boolean) When upgrading, reuse the last release's values and merge in any overrides. If 'reset_values' is specified, this is ignored. Defaults to `false`.
5656
- `set` (Block Set) Custom values to be merged with the values. (see [below for nested schema](#nestedblock--set))
5757
- `set_list` (Block List) Custom sensitive values to be merged with the values. (see [below for nested schema](#nestedblock--set_list))
5858
- `set_sensitive` (Block Set) Custom sensitive values to be merged with the values. (see [below for nested schema](#nestedblock--set_sensitive))
5959
- `set_string` (Block Set, Deprecated) Custom string values to be merged with the values. (see [below for nested schema](#nestedblock--set_string))
6060
- `show_only` (List of String) Only show manifests rendered from the given templates
61-
- `skip_crds` (Boolean) If set, no CRDs will be installed. By default, CRDs are installed if not already present
62-
- `skip_tests` (Boolean) If set, tests will not be rendered. By default, tests are rendered
63-
- `timeout` (Number) Time in seconds to wait for any individual kubernetes operation.
61+
- `skip_crds` (Boolean) If set, no CRDs will be installed. By default, CRDs are installed if not already present. Defaults to `false`.
62+
- `skip_tests` (Boolean) If set, tests will not be rendered. By default, tests are rendered. Defaults to `false`.
63+
- `timeout` (Number) Time in seconds to wait for any individual kubernetes operation. Defaults to `300` seconds.
6464
- `validate` (Boolean) Validate your manifests against the Kubernetes cluster you are currently pointing at. This is the same validation performed on an install
6565
- `values` (List of String) List of values in raw yaml format to pass to helm.
66-
- `verify` (Boolean) Verify the package before installing it.
66+
- `verify` (Boolean) Verify the package before installing it.Defaults to `false`.
6767
- `version` (String) Specify the exact chart version to install. If this is not specified, the latest version is installed.
68-
- `wait` (Boolean) Will wait until all resources are in a ready state before marking the release as successful.
68+
- `wait` (Boolean) Will wait until all resources are in a ready state before marking the release as successful.Defaults to `true`.
6969

7070
### Read-Only
7171

docs/guides/v2-upgrade-guide.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
---
2-
layout : "helm"
2+
layout: "helm"
33
page_title: "Helm: Upgrade Guide for Helm Provider v2.0.0"
44
description: |-
55
This guide covers the changes introduced in v2.0.0 of the Helm provider and what you may need to do to upgrade your configuration.

docs/index.md

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -17,7 +17,7 @@ Try the [hands-on tutorial](https://learn.hashicorp.com/tutorials/terraform/helm
1717

1818
## Data Sources
1919

20-
* [Data Source: helm_template](d/template.md)
20+
* [Data Source: helm_template](d/template.html)
2121

2222
## Example Usage
2323

@@ -186,10 +186,10 @@ The `kubernetes` block supports:
186186
* `config_context` - (Optional) Context to choose from the config file. Can be sourced from `KUBE_CTX`.
187187
* `proxy_url` - (Optional) URL to the proxy to be used for all API requests. URLs with "http", "https", and "socks5" schemes are supported. Can be sourced from `KUBE_PROXY_URL`.
188188
* `exec` - (Optional) Configuration block to use an [exec-based credential plugin](https://kubernetes.io/docs/reference/access-authn-authz/authentication/#client-go-credential-plugins), e.g. call an external command to receive user credentials.
189-
* `api_version` - (Required) API version to use when decoding the ExecCredentials resource, e.g. `client.authentication.k8s.io/v1beta1`.
190-
* `command` - (Required) Command to execute.
191-
* `args` - (Optional) List of arguments to pass when executing the plugin.
192-
* `env` - (Optional) Map of environment variables to set when executing the plugin.
189+
* `api_version` - (Required) API version to use when decoding the ExecCredentials resource, e.g. `client.authentication.k8s.io/v1beta1`.
190+
* `command` - (Required) Command to execute.
191+
* `args` - (Optional) List of arguments to pass when executing the plugin.
192+
* `env` - (Optional) Map of environment variables to set when executing the plugin.
193193

194194
The `registry` block has options:
195195

docs/resources/release.md

Lines changed: 27 additions & 26 deletions
Original file line numberDiff line numberDiff line change
@@ -22,43 +22,43 @@ A Chart is a Helm package. It contains all of the resource definitions necessary
2222

2323
### Optional
2424

25-
- `atomic` (Boolean) If set, installation process purges chart on fail. The wait flag will be set automatically if atomic is used
26-
- `cleanup_on_fail` (Boolean) Allow deletion of new resources created in this upgrade when upgrade fails
27-
- `create_namespace` (Boolean) Create the namespace if it does not exist
28-
- `dependency_update` (Boolean) Run helm dependency update before installing the chart
25+
- `atomic` (Boolean) If set, installation process purges chart on fail. The wait flag will be set automatically if atomic is used. Defaults to `false`.
26+
- `cleanup_on_fail` (Boolean) Allow deletion of new resources created in this upgrade when upgrade fails. Defaults to `false`.
27+
- `create_namespace` (Boolean) Create the namespace if it does not exist. Defaults to `false`.
28+
- `dependency_update` (Boolean) Run helm dependency update before installing the chart. Defaults to `false`.
2929
- `description` (String) Add a custom description
3030
- `devel` (Boolean) Use chart development versions, too. Equivalent to version '>0.0.0-0'. If `version` is set, this is ignored
3131
- `disable_crd_hooks` (Boolean) Prevent CRD hooks from, running, but run other hooks. See helm install --no-crd-hook
32-
- `disable_openapi_validation` (Boolean) If set, the installation process will not validate rendered templates against the Kubernetes OpenAPI Schema
33-
- `disable_webhooks` (Boolean) Prevent hooks from running.
34-
- `force_update` (Boolean) Force resource update through delete/recreate if needed.
35-
- `keyring` (String) Location of public keys used for verification. Used only if `verify` is true
36-
- `lint` (Boolean) Run helm lint when planning
37-
- `max_history` (Number) Limit the maximum number of revisions saved per release. Use 0 for no limit
38-
- `namespace` (String) Namespace to install the release into.
39-
- `pass_credentials` (Boolean) Pass credentials to all domains
32+
- `disable_openapi_validation` (Boolean) If set, the installation process will not validate rendered templates against the Kubernetes OpenAPI Schema. Defaults to `false`.
33+
- `disable_webhooks` (Boolean) Prevent hooks from running.Defaults to `false`.
34+
- `force_update` (Boolean) Force resource update through delete/recreate if needed. Defaults to `false`.
35+
- `keyring` (String) Location of public keys used for verification. Used only if `verify` is true. Defaults to `/.gnupg/pubring.gpg` in the location set by `home`.
36+
- `lint` (Boolean) Run helm lint when planning. Defaults to `false`.
37+
- `max_history` (Number) Limit the maximum number of revisions saved per release. Use 0 for no limit. Defaults to 0 (no limit).
38+
- `namespace` (String) Namespace to install the release into. Defaults to `default`.
39+
- `pass_credentials` (Boolean) Pass credentials to all domains. Defaults to `false`.
4040
- `postrender` (Block List, Max: 1) Postrender command configuration. (see [below for nested schema](#nestedblock--postrender))
41-
- `recreate_pods` (Boolean) Perform pods restart during upgrade/rollback
42-
- `render_subchart_notes` (Boolean) If set, render subchart notes along with the parent
43-
- `replace` (Boolean) Re-use the given name, even if that name is already used. This is unsafe in production
41+
- `recreate_pods` (Boolean) Perform pods restart during upgrade/rollback. Defaults to `false`.
42+
- `render_subchart_notes` (Boolean) If set, render subchart notes along with the parent. Defaults to `true`.
43+
- `replace` (Boolean) Re-use the given name, even if that name is already used. This is unsafe in production. Defaults to `false`.
4444
- `repository` (String) Repository where to locate the requested chart. If is a URL the chart is installed without installing the repository.
4545
- `repository_ca_file` (String) The Repositories CA File
4646
- `repository_cert_file` (String) The repositories cert file
4747
- `repository_key_file` (String) The repositories cert key file
4848
- `repository_password` (String, Sensitive) Password for HTTP basic authentication
4949
- `repository_username` (String) Username for HTTP basic authentication
50-
- `reset_values` (Boolean) When upgrading, reset the values to the ones built into the chart
51-
- `reuse_values` (Boolean) When upgrading, reuse the last release's values and merge in any overrides. If 'reset_values' is specified, this is ignored
50+
- `reset_values` (Boolean) When upgrading, reset the values to the ones built into the chart. Defaults to `false`.
51+
- `reuse_values` (Boolean) When upgrading, reuse the last release's values and merge in any overrides. If 'reset_values' is specified, this is ignored. Defaults to `false`.
5252
- `set` (Block Set) Custom values to be merged with the values. (see [below for nested schema](#nestedblock--set))
5353
- `set_list` (Block List) Custom sensitive values to be merged with the values. (see [below for nested schema](#nestedblock--set_list))
5454
- `set_sensitive` (Block Set) Custom sensitive values to be merged with the values. (see [below for nested schema](#nestedblock--set_sensitive))
55-
- `skip_crds` (Boolean) If set, no CRDs will be installed. By default, CRDs are installed if not already present
56-
- `timeout` (Number) Time in seconds to wait for any individual kubernetes operation.
55+
- `skip_crds` (Boolean) If set, no CRDs will be installed. By default, CRDs are installed if not already present. Defaults to `false`.
56+
- `timeout` (Number) Time in seconds to wait for any individual kubernetes operation. Defaults to 300 seconds.
5757
- `values` (List of String) List of values in raw yaml format to pass to helm.
58-
- `verify` (Boolean) Verify the package before installing it.
58+
- `verify` (Boolean) Verify the package before installing it.Defaults to `false`.
5959
- `version` (String) Specify the exact chart version to install. If this is not specified, the latest version is installed.
60-
- `wait` (Boolean) Will wait until all resources are in a ready state before marking the release as successful.
61-
- `wait_for_jobs` (Boolean) If wait is enabled, will wait until all Jobs have been completed before marking the release as successful.
60+
- `wait` (Boolean) Will wait until all resources are in a ready state before marking the release as successful. Defaults to `true`.
61+
- `wait_for_jobs` (Boolean) If wait is enabled, will wait until all Jobs have been completed before marking the release as successful. Defaults to `false``.
6262

6363
### Read-Only
6464

@@ -121,18 +121,19 @@ Read-Only:
121121

122122
- `app_version` (String)
123123
- `chart` (String)
124+
- `first_deployed` (Number)
125+
- `last_deployed` (Number)
124126
- `name` (String)
125127
- `namespace` (String)
126-
- `first_deployed` (Number) timestamp when the release was first deployed
127-
- `last_deployed` (Number) timestamp when the release was last deployed
128-
- `revision` (Number) version of the release last deployed
129-
- `notes` (String) rendered templates/NOTES.txt if available
128+
- `notes` (String)
129+
- `revision` (Number)
130130
- `values` (String)
131131
- `version` (String)
132132

133133

134134

135135

136+
136137
## Example Usage - Chart Repository
137138

138139
```terraform

0 commit comments

Comments
 (0)