cmctl
is a command line tool that can help you manage cert-manager and its resources inside your cluster.
Documentation
The documentation for cmctl
can be found on the cert-manager website.
Installation
[!Note]
These instructions are a copy of the official installation instructions.
Homebrew
On Mac or Linux if you have Homebrew installed, you can install cmctl
with:
brew install cmctl
This will also install shell completion.
Go install
If you have Go installed, you can install cmctl
with:
go install github.com/cert-manager/cmctl/v2@latest
Manual Installation
You need the cmctl
file for the platform you're using, these can be found on our cmctl GitHub releases page.
In order to use cmctl
you need its binary to be accessible under the name cmctl
in your $PATH
. Run the following commands to set up the CLI. Replace OS and ARCH with your systems equivalents:
OS=$(uname -s | tr A-Z a-z); ARCH=$(uname -m | sed 's/x86_64/amd64/' | sed 's/aarch64/arm64/'); curl -fsSL -o cmctl https://github.com/cert-manager/cmctl/releases/latest/download/cmctl_${OS}_${ARCH}
chmod +x cmctl
sudo mv cmctl /usr/local/bin
# or `sudo mv cmctl /usr/local/bin/kubectl-cert_manager` to use `kubectl cert-manager` instead.
Shell Completion
cmctl
supports shell completion for most popular shells. To get help on how to enable shell completion, run the following commands:
$ cmctl completion --help
# or `kubectl cert-manager completion --help`
...
Available Commands:
bash Generate cert-manager CLI scripts for a Bash shell
fish Generate cert-manager CLI scripts for a Fish shell
powershell Generate cert-manager CLI scripts for a PowerShell shell
zsh Generation cert-manager CLI scripts for a ZSH shell
$ cmctl completion bash --help
To load completions:
Bash:
$ source <(cmctl completion bash)
# To load completions for each session, execute once:
# Linux:
$ cmctl completion bash > /etc/bash_completion.d/cmctl
# macOS:
$ cmctl completion bash > /usr/local/etc/bash_completion.d/cmctl
...
Versioning
Before v2, cmctl
was located in the cert-manager repository and versioned together with cert-manager.
Starting from v2, cmctl
is versioned seperately from cert-manager itself.
Release Process
The release process is documented in RELEASE.md.