This document is for an unreleased version of Crossplane.

This document applies to the Crossplane master branch and not to the latest release v1.19.

The Crossplane CLI helps simplify some development and administration aspects of Crossplane.

The Crossplane CLI includes:

  • tools to build, install, update and push Crossplane Packages
  • standalone Composition Function testing and rendering without the need to access a Kubernetes cluster running Crossplane
  • troubleshoot Crossplane Compositions, Composite Resources and Managed Resources

Installing the CLI

The Crossplane CLI is a single standalone binary with no external dependencies.

Note

Install the Crossplane CLI on a user’s computer.

Most Crossplane CLI commands are independent of Kubernetes and don’t require access to a Crossplane pod.

To download the latest version for your CPU architecture with the Crossplane install script.

1curl -sL "https://raw.githubusercontent.com/crossplane/crossplane/main/install.sh" | sh

The script detects your CPU architecture and downloads the latest stable release.

If you don’t want to run shell script you can manually download a binary from the Crossplane releases repository at https://releases.crossplane.io/stable/current/bin

Important

The CLI is named crank in the release repository. Download this file.

The crossplane binary is the Kubernetes Crossplane pod image.

Move the binary to a location in your $PATH, for example /usr/local/bin.

Download other CLI versions

Download different Crossplane CLI versions or different release branches with the XP_CHANNEL and XP_VERSION environmental variables.

By default the CLI installs from the XP_CHANNEL named stable and the XP_VERSION of current, matching the most recent stable release.

For example, to install CLI version v1.14.0 add XP_VERSION=v1.14.0 to the download script curl command:

curl -sL "https://raw.githubusercontent.com/crossplane/crossplane/main/install.sh" | XP_VERSION=v1.14.0 sh

Installing shell autocompletions

The Crossplane CLI supports shell autocompletions for bash, zsh and fish. You can install the autocompletions with the completions command by adding it to your shell’s configuration file.

1source <(crossplane completions)
Note
The completions command generates the autocompletions for your default shell. It’s not possible to generate autocompletions for a different shell, if you want to install the autocompletions for a different shell, you have to configure the Crossplane CLI as the completer manually.