Skip to content

Gardenctl Rc Zsh ​

gardenctl rc zsh ​

Generate a gardenctl startup script for zsh

Synopsis ​

Generate a gardenctl startup script for zsh that contains various tweaks, such as setting environment variables, loading completions and adding some helpful aliases or functions.

If shell completion is not already enabled in your environment you need to add at least this command to your zsh configuration file:

autoload -Uz compinit && compinit

To load gardenctl startup script for each zsh session add the following line at the end of the ~/.zshrc file:

source <(gardenctl rc zsh)

You will need to start a new shell for this setup to take effect.

Zshell frameworks or plugin manager ​

If you use a framework for managing your zsh configuration you may need to load this code as a custom plugin in your framework.

oh-my-zsh: ​

Create a file ~/.oh-my-zsh/custom/plugins/gardenctl/gardenctl.plugin.zsh with the following content:

if (( $+commands[gardenctl] )); then
  source <(gardenctl rc zsh)
fi

To use it, add gardenctl to the plugins array in your ~/.zshrc file:

plugins=(... gardenctl)

For more information about oh-my-zsh custom plugins please refer to https://github.com/ohmyzsh/ohmyzsh#custom-plugins-and-themes.

zgen: ​

Create an oh-my-zsh plugin for gardenctl like described above and load it in the .zshrc file:

zgen load /path/to/custom/plugins/gardenctl

For more information about loading plugins with zgen please refer to https://github.com/tarjoilija/zgen#load-plugins-and-completions

zinit: ​

Create an oh-my-zsh plugin for gardenctl like described above and load it in the .zshrc file:

zinit snippet /path/to/custom/plugins/gardenctl/gardenctl.plugin.zsh

For more information about loading plugins and snippets with zinit please refer to https://github.com/zdharma-continuum/zinit#plugins-and-snippets.

gardenctl rc zsh [flags]

Options ​

  -h, --help            help for zsh
      --no-completion   The startup script should not setup completion
      --no-kubeconfig   The startup script should not modify the KUBECONFIG environment variable
  -p, --prefix string   The prefix used for aliases and functions (default "g")

Options inherited from parent commands ​

      --add-dir-header                      If true, adds the file directory to the header of the log messages
      --alsologtostderr                     log to standard error as well as files (no effect when -logtostderr=true)
      --alsologtostderrthreshold severity   logs at or above this threshold go to stderr when -alsologtostderr=true (no effect when -logtostderr=true)
      --config string                       config file (default is ~/.garden/gardenctl-v2.yaml)
      --legacy-stderr-threshold-behavior    If true, stderrthreshold is ignored when logtostderr=true (legacy behavior). If false, stderrthreshold is honored even when logtostderr=true (default true)
      --log-backtrace-at traceLocation      when logging hits line file:N, emit a stack trace (default :0)
      --log-dir string                      If non-empty, write log files in this directory (no effect when -logtostderr=true)
      --log-file string                     If non-empty, use this log file (no effect when -logtostderr=true)
      --log-file-max-size uint              Defines the maximum size a log file can grow to (no effect when -logtostderr=true). Unit is megabytes. If the value is 0, the maximum file size is unlimited. (default 1800)
      --logtostderr                         log to standard error instead of files (default true)
      --one-output                          If true, only write logs to their native severity level (vs also writing to each lower severity level; no effect when -logtostderr=true)
      --skip-headers                        If true, avoid header prefixes in the log messages
      --skip-log-headers                    If true, avoid headers when opening log files (no effect when -logtostderr=true)
      --stderrthreshold severity            logs at or above this threshold go to stderr when writing to files and stderr (no effect when -logtostderr=true or -alsologtostderr=true unless -legacy_stderr_threshold_behavior=false) (default 2)
  -v, --v Level                             number for the log level verbosity
      --vmodule moduleSpec                  comma-separated list of pattern=N settings for file-filtered logging

SEE ALSO ​

  • gardenctl rc - Generate a gardenctl startup script for the specified shell