Rundeck CLI Tool

This is the official CLI tool for Rundeck.

Documentation

https://rundeck.github.io/rundeck-cli/

• Changelog
• Install
• Configuration
• SSL Configuration
• Commands
• Scripting
• Java API Library
• Extensions

Bundled Extensions

• rd acl - Test and generate Rundeck ACL policy files

Javadoc

• rd-api-client
• rd-cli-lib

Downloads

Github Releases

For apt and yum repos, see Install

Homebrew installation

brew tap rundeck/rundeck-cli
brew install rundeck-cli

Howto

Build

Build with gradle

Produces packages in: rd-cli-tool/build/distributions:

rd-VERS.zip/.tar rundeck_cli_VERS.rpm rundeck_cli_VERS.deb

Produces Jars in: rd-cli-tool/build/libs: rundeck-cli-VERS-all.jar (shadowed jar)

./gradlew build

Build Lenient

Build with lenient mode dependency verification

./gradlew build --dependency-verification lenient

Write Dependency Verification

Update dependency verification metadata and export any new keys.

./gradlew --write-verification-metadata sha256 --refresh-dependencies help
./gradlew --write-verification-metadata pgp,sha256 --refresh-keys --export-keys --refresh-dependencies help
rm gradle/verification-keyring.gpg
git add gradle/verification-metadata.xml
git add gradle/verification-keyring.keys

Install Locally

Install to local path rd-cli-tool/build/install/rd/bin/rd

./gradlew :rd-cli-tool:installDist

Local Run

Run local installation at path rd-cli-tool/build/install/rd/bin/rd

./rd-cli-tool/build/install/rd/bin/rd "${@}"

Release

Release a new version

Uses axion release plugin.

./gradlew release

Release using Snapshots

If you need to release with any SNAPSHOT dependency Otherwise, axion-release will fail the prerelease check. Only do this for testing.

./gradlew release -Prelease.disableChecks

Next Minor Version

Updates minor version without releasing, e.g. 0.1.x-SNAPSHOT becomes 0.2.0-SNAPSHOT

./gradlew markNextVersion -Prelease.incrementer=incrementMinor

Release Force version

Release and force a particular version

./gradlew release -Prelease.forceVersion=${1:?version argument must be specified}