Skip to content

Commit a36d8b6

Browse files
authored
docs: remove copy/pasta of CLI that always gets out of date (#691)
* docs: remove copy/pasta of CLI that always gets out of date * docs: update slack link
1 parent 3770f9f commit a36d8b6

File tree

3 files changed

+2
-155
lines changed

3 files changed

+2
-155
lines changed

README.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@
44
<a href="https://github.com/FairwindsOps/reckoner/releases">
55
<img src="https://img.shields.io/github/v/release/FairwindsOps/reckoner">
66
</a>
7-
<a href="https://join.slack.com/t/fairwindscommunity/shared_invite/zt-e3c6vj4l-3lIH6dvKqzWII5fSSFDi1g">
7+
<a href="https://join.slack.com/t/fairwindscommunity/shared_invite/zt-2na8gtwb4-DGQ4qgmQbczQyB2NlFlYQQ">
88
<img src="https://img.shields.io/static/v1?label=Slack&message=Join+our+Community&color=4a154b&logo=slack">
99
</a>
1010
</div>

docs/README.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@
44
<a href="https://github.com/FairwindsOps/reckoner/releases">
55
<img src="https://img.shields.io/github/v/release/FairwindsOps/reckoner">
66
</a>
7-
<a href="https://join.slack.com/t/fairwindscommunity/shared_invite/zt-e3c6vj4l-3lIH6dvKqzWII5fSSFDi1g">
7+
<a href="https://join.slack.com/t/fairwindscommunity/shared_invite/zt-2na8gtwb4-DGQ4qgmQbczQyB2NlFlYQQ">
88
<img src="https://img.shields.io/static/v1?label=Slack&message=Join+our+Community&color=4a154b&logo=slack">
99
</a>
1010
</div>

docs/usage.md

-153
Original file line numberDiff line numberDiff line change
@@ -315,156 +315,3 @@ gitops:
315315

316316
> Must be used with `reckoner template --output-dir <some_dir>` to produce any files.
317317

318-
## CLI Usage
319-
320-
```text
321-
$ reckoner --help
322-
Usage: reckoner [OPTIONS] COMMAND [ARGS]...
323-
324-
Options:
325-
--version Show the version and exit.
326-
--log-level TEXT Log Level. [INFO | DEBUG | WARN | ERROR]. (default=INFO)
327-
--help Show this message and exit.
328-
329-
Commands:
330-
plot Install charts with given arguments as listed in yaml file argument
331-
template Output the template of the chart or charts as they would be installed or
332-
upgraded
333-
get-manifests Output the manifests of the chart or charts as they are installed
334-
diff Output diff of the templates that would be installed and the manifests as they are installed
335-
update Checks to see if anything will be changed, if so, update the release, if not, does nothing
336-
version Takes no arguments, outputs version info
337-
import Outputs a chart block that can be used to import the specified release
338-
```
339-
340-
You can add `--help` to any `Command` and get output like the one below:
341-
342-
```text
343-
$ reckoner plot --help
344-
Usage: reckoner plot [OPTIONS] COURSE_FILE
345-
346-
Install charts with given arguments as listed in yaml file argument
347-
348-
Options:
349-
--dry-run Pass --dry-run to helm so no action is
350-
taken. Implies --debug and skips hooks.
351-
352-
--debug DEPRECATED - use --log-level=DEBUG as a
353-
parameter to `reckoner` instead. May be used
354-
with or without `--dry-run`. Or, pass
355-
`--debug` to --helm-args
356-
357-
-a, --run-all Run all charts in the course. Mutually
358-
exclusive with 'only'.
359-
360-
-o, --only, --heading <chart> Only run a specific chart by name Mutually
361-
exclusive with 'run_all'.
362-
363-
--helm-args TEXT Passes the following arg on to helm, can be
364-
used more than once. WARNING: Setting this
365-
will completely override any helm_args in
366-
the course. Also cannot be used for
367-
configuring how helm connects to tiller.
368-
369-
--continue-on-error Attempt to install all charts in the course,
370-
even if any charts or hooks fail to run.
371-
372-
--create-namespace / --no-create-namespace
373-
Will create the specified nameaspace if it
374-
does not already exist. Replaces
375-
functionality lost in Helm3
376-
377-
--log-level TEXT Log Level. [INFO | DEBUG | WARN | ERROR].
378-
(default=INFO)
379-
380-
--help Show this message and exit.
381-
```
382-
383-
Or
384-
385-
```
386-
$ reckoner update --help
387-
Usage: reckoner update [OPTIONS] COURSE_FILE
388-
389-
Checks to see if anything will be changed, if so, update the release,
390-
if not, does nothing
391-
392-
Options:
393-
--dry-run Pass --dry-run to helm so no action is
394-
taken. Implies --debug and skips hooks.
395-
396-
--debug DEPRECATED - use --log-level=DEBUG as a
397-
parameter to `reckoner` instead. May be used
398-
with or without `--dry-run`. Or, pass
399-
`--debug` to --helm-args
400-
401-
-a, --run-all Run all charts in the course. Mutually
402-
exclusive with 'only'.
403-
404-
-o, --only, --heading <chart> Only run a specific chart by name Mutually
405-
exclusive with 'run_all'.
406-
407-
--helm-args TEXT Passes the following arg on to helm, can be
408-
used more than once. WARNING: Setting this
409-
will completely override any helm_args in
410-
the course. Also cannot be used for
411-
configuring how helm connects to tiller.
412-
413-
--continue-on-error Attempt to install all charts in the course,
414-
even if any charts or hooks fail to run.
415-
416-
--create-namespace / --no-create-namespace
417-
Will create the specified nameaspace if it
418-
does not already exist. Replaces
419-
functionality lost in Helm3
420-
421-
--log-level TEXT Log Level. [INFO | DEBUG | WARN | ERROR].
422-
(default=INFO)
423-
424-
--help Show this message and exit.
425-
```
426-
427-
Or
428-
429-
```text
430-
$ reckoner template --help
431-
Templates a helm chart for a release or several releases. Automatically sets --create-namespaces=false --dry-run=true
432-
433-
Usage:
434-
reckoner template [flags]
435-
436-
Flags:
437-
-h, --help help for template
438-
--output-dir string path to the base output directory (eg, ~/myproject/manifests)
439-
440-
Global Flags:
441-
--create-namespaces If true, allow reckoner to create namespaces. (default true)
442-
--dry-run Implies helm --dry-run --debug and skips any hooks
443-
--helm-args strings Additional arguments to pass to helm commands. Can
444-
be passed multiple times. used more than once.
445-
WARNING: Setting this will completely override
446-
any helm_args in the course.
447-
--no-color If true, don't colorize output.
448-
-o, --only strings Only install this list of releases. Can be passed
449-
multiple times.
450-
-a, --run-all Install every release in the course file
451-
-v, --v Level number for the log level verbosity
452-
```
453-
454-
Or
455-
456-
```text
457-
$ reckoner import --help
458-
Usage: reckoner import [OPTIONS]
459-
460-
Outputs a chart block that can be used to import the specified release
461-
462-
Options:
463-
--log-level TEXT Log Level. [INFO | DEBUG | WARN | ERROR].
464-
(default=INFO)
465-
466-
--release_name TEXT The release name to import [required]
467-
--namespace TEXT The namespace of the release [required]
468-
--repository TEXT The repository of the chart [required]
469-
--help Show this message and exit.
470-
```

0 commit comments

Comments
 (0)