Skip to content

Commit b083055

Browse files
max-lenmumoshu
andauthored
Update README with actual usage output (databus23#426)
Co-authored-by: Yusuke Kuoka <[email protected]>
1 parent 609de73 commit b083055

File tree

2 files changed

+43
-28
lines changed

2 files changed

+43
-28
lines changed

README.md

Lines changed: 39 additions & 24 deletions
Original file line numberDiff line numberDiff line change
@@ -57,18 +57,18 @@ The Helm Diff Plugin
5757
5858
* Shows a diff explaining what a helm upgrade would change:
5959
This fetches the currently deployed version of a release
60-
and compares it to a local chart plus values. This can be
60+
and compares it to a local chart plus values. This can be
6161
used visualize what changes a helm upgrade will perform.
6262
6363
* Shows a diff explaining what had changed between two revisions:
6464
This fetches previously deployed versions of a release
65-
and compares them. This can be used visualize what changes
65+
and compares them. This can be used visualize what changes
6666
were made during revision change.
6767
6868
* Shows a diff explaining what a helm rollback would change:
6969
This fetches the currently deployed version of a release
70-
and compares it to the previously deployed version of the release, that you
71-
want to rollback. This can be used visualize what changes a
70+
and compares it to the previously deployed version of the release, that you
71+
want to rollback. This can be used visualize what changes a
7272
helm rollback will perform.
7373
7474
Usage:
@@ -120,7 +120,7 @@ Flags:
120120
--version string specify the exact chart version to use. If this is not specified, the latest version is used
121121
122122
Additional help topics:
123-
diff
123+
diff
124124
125125
Use "diff [command] --help" for more information about a command.
126126
```
@@ -152,24 +152,24 @@ Examples:
152152
# Set HELM_DIFF_USE_UPGRADE_DRY_RUN=true to
153153
# use `helm upgrade --dry-run` instead of `helm template` to render manifests from the chart.
154154
# See https://github.com/databus23/helm-diff/issues/253 for more information.
155-
HELM_DIFF_USE_UPGRADE_DRY_RUN=true helm diff upgrade my-release datadog/datadog
155+
HELM_DIFF_USE_UPGRADE_DRY_RUN=true helm diff upgarde my-release datadog/datadog
156156
157157
# Set HELM_DIFF_THREE_WAY_MERGE=true to
158158
# enable the three-way-merge on diff.
159159
# This is equivalent to specifying the --three-way-merge flag.
160160
# Read the flag usage below for more information on --three-way-merge.
161-
HELM_DIFF_THREE_WAY_MERGE=true helm diff upgrade my-release datadog/datadog
161+
HELM_DIFF_THREE_WAY_MERGE=true helm diff upgarde my-release datadog/datadog
162162
163163
# Set HELM_DIFF_NORMALIZE_MANIFESTS=true to
164164
# normalize the yaml file content when using helm diff.
165165
# This is equivalent to specifying the --normalize-manifests flag.
166166
# Read the flag usage below for more information on --normalize-manifests.
167167
HELM_DIFF_NORMALIZE_MANIFESTS=true helm diff upgrade my-release datadog/datadog
168168
169-
# Set HELM_DIFF_OUTPUT_CONTEXT=n to configure the output context to n lines.
170-
# This is equivalent to specifying the --context flag.
171-
# Read the flag usage below for more information on --context.
172-
HELM_DIFF_OUTPUT_CONTEXT=5 helm diff upgrade my-release datadog/datadog
169+
# Set HELM_DIFF_OUTPUT_CONTEXT=n to configure the output context to n lines.
170+
# This is equivalent to specifying the --context flag.
171+
# Read the flag usage below for more information on --context.
172+
HELM_DIFF_OUTPUT_CONTEXT=5 helm diff upgrade my-release datadog/datadog
173173
174174
Flags:
175175
--allow-unreleased enables diffing of releases that are not yet deployed via Helm
@@ -215,7 +215,7 @@ Global Flags:
215215
```
216216
$ helm diff release -h
217217
218-
This command compares the manifests details of a different release created from the same chart
218+
This command compares the manifests details of a different releases created from the same chart
219219
220220
It can be used to compare the manifests of
221221
@@ -229,33 +229,32 @@ Usage:
229229
230230
Flags:
231231
-C, --context int output NUM lines of context around changes (default -1)
232+
--detailed-exitcode return a non-zero exit code when there are changes
233+
-D, --find-renames float32 Enable rename detection if set to any value greater than 0. If specified, the value denotes the maximum fraction of changed content as lines added + removed compared to total lines in a diff for considering it a rename. Only objects of the same Kind are attempted to be matched
232234
-h, --help help for release
233-
--home string location of your Helm config. Overrides $HELM_HOME (default "/home/aananth/.helm")
234235
--include-tests enable the diffing of the helm test hooks
236+
--normalize-manifests normalize manifests before running diff to exclude style differences from the output
237+
--output string Possible values: diff, simple, template. When set to "template", use the env var HELM_DIFF_TPL to specify the template. (default "diff")
238+
--show-secrets do not redact secret values in the output
235239
--strip-trailing-cr strip trailing carriage return on input
236240
--suppress stringArray allows suppression of the values listed in the diff output
237241
-q, --suppress-secrets suppress secrets in the output
238-
--tls enable TLS for request
239-
--tls-ca-cert string path to TLS CA certificate file (default "$HELM_HOME/ca.pem")
240-
--tls-cert string path to TLS certificate file (default "$HELM_HOME/cert.pem")
241-
--tls-hostname string the server name used to verify the hostname on the returned certificates from the server
242-
--tls-key string path to TLS key file (default "$HELM_HOME/key.pem")
243-
--tls-verify enable TLS for request and verify remote
244242
245243
Global Flags:
246-
--no-color remove colors from the output
244+
--color color output. You can control the value for this flag via HELM_DIFF_COLOR=[true|false]. If both --no-color and --color are unspecified, coloring enabled only when the stdout is a term and TERM is not "dumb"
245+
--no-color remove colors from the output. If both --no-color and --color are unspecified, coloring enabled only when the stdout is a term and TERM is not "dumb"
247246
```
248247

249248
### revision:
250249

251250
```
252251
$ helm diff revision -h
253252
254-
This command compares the manifest details of a named release.
253+
This command compares the manifests details of a named release.
255254
256255
It can be used to compare the manifests of
257256
258-
- latest REVISION with specified REVISION
257+
- lastest REVISION with specified REVISION
259258
$ helm diff revision [flags] RELEASE REVISION1
260259
Example:
261260
$ helm diff revision my-release 2
@@ -269,13 +268,21 @@ Usage:
269268
diff revision [flags] RELEASE REVISION1 [REVISION2]
270269
271270
Flags:
271+
-C, --context int output NUM lines of context around changes (default -1)
272+
--detailed-exitcode return a non-zero exit code when there are changes
273+
-D, --find-renames float32 Enable rename detection if set to any value greater than 0. If specified, the value denotes the maximum fraction of changed content as lines added + removed compared to total lines in a diff for considering it a rename. Only objects of the same Kind are attempted to be matched
272274
-h, --help help for revision
275+
--include-tests enable the diffing of the helm test hooks
276+
--normalize-manifests normalize manifests before running diff to exclude style differences from the output
277+
--output string Possible values: diff, simple, template. When set to "template", use the env var HELM_DIFF_TPL to specify the template. (default "diff")
278+
--show-secrets do not redact secret values in the output
273279
--strip-trailing-cr strip trailing carriage return on input
274280
--suppress stringArray allows suppression of the values listed in the diff output
275281
-q, --suppress-secrets suppress secrets in the output
276282
277283
Global Flags:
278-
--no-color remove colors from the output
284+
--color color output. You can control the value for this flag via HELM_DIFF_COLOR=[true|false]. If both --no-color and --color are unspecified, coloring enabled only when the stdout is a term and TERM is not "dumb"
285+
--no-color remove colors from the output. If both --no-color and --color are unspecified, coloring enabled only when the stdout is a term and TERM is not "dumb"
279286
```
280287

281288
### rollback:
@@ -295,13 +302,21 @@ Examples:
295302
helm diff rollback my-release 2
296303
297304
Flags:
305+
-C, --context int output NUM lines of context around changes (default -1)
306+
--detailed-exitcode return a non-zero exit code when there are changes
307+
-D, --find-renames float32 Enable rename detection if set to any value greater than 0. If specified, the value denotes the maximum fraction of changed content as lines added + removed compared to total lines in a diff for considering it a rename. Only objects of the same Kind are attempted to be matched
298308
-h, --help help for rollback
309+
--include-tests enable the diffing of the helm test hooks
310+
--normalize-manifests normalize manifests before running diff to exclude style differences from the output
311+
--output string Possible values: diff, simple, template. When set to "template", use the env var HELM_DIFF_TPL to specify the template. (default "diff")
312+
--show-secrets do not redact secret values in the output
299313
--strip-trailing-cr strip trailing carriage return on input
300314
--suppress stringArray allows suppression of the values listed in the diff output
301315
-q, --suppress-secrets suppress secrets in the output
302316
303317
Global Flags:
304-
--no-color remove colors from the output
318+
--color color output. You can control the value for this flag via HELM_DIFF_COLOR=[true|false]. If both --no-color and --color are unspecified, coloring enabled only when the stdout is a term and TERM is not "dumb"
319+
--no-color remove colors from the output. If both --no-color and --color are unspecified, coloring enabled only when the stdout is a term and TERM is not "dumb"
305320
```
306321

307322
## Build

cmd/root.go

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -15,18 +15,18 @@ The Helm Diff Plugin
1515
1616
* Shows a diff explaining what a helm upgrade would change:
1717
This fetches the currently deployed version of a release
18-
and compares it to a local chart plus values. This can be
18+
and compares it to a local chart plus values. This can be
1919
used visualize what changes a helm upgrade will perform.
2020
2121
* Shows a diff explaining what had changed between two revisions:
2222
This fetches previously deployed versions of a release
23-
and compares them. This can be used visualize what changes
23+
and compares them. This can be used visualize what changes
2424
were made during revision change.
2525
2626
* Shows a diff explaining what a helm rollback would change:
2727
This fetches the currently deployed version of a release
28-
and compares it to the previously deployed version of the release, that you
29-
want to rollback. This can be used visualize what changes a
28+
and compares it to the previously deployed version of the release, that you
29+
want to rollback. This can be used visualize what changes a
3030
helm rollback will perform.
3131
`
3232

0 commit comments

Comments
 (0)