The Configu CLI is an excellent interface for getting started with Configu. With the command-line interface (CLI), you can easily interact with Configu using a terminal or an automated system, providing you with all the functionality you need to retrieve and manage your configuration data and beyond. The CLI code is open-source, and the installation process is quick and easy, with lightweight binaries available for all major operating systems, Docker, and CI/CD platforms.
Install with script:
To install Configu CLI globally, you can use the following command:
1curl https://cli.configu.com/install.sh | sh
This will download and run the installation script, which will check for dependencies, download the latest version of the Configu CLI binary, and install it on your system. The CLI will be installed on your system's $PATH, allowing you to use it from anywhere in your terminal.
Please note that you may need to grant the script the necessary permissions to add the CLI to the $PATH. You can review the contents of the script before running it to ensure that it is safe to execute.
Install on CI/CD:
To make Configu CLI available via a CI/CD pipeline, you can use the pre-made, dedicated installation steps which are based on the installation script and designed to be be easily integrated into your pipeline configuration.
1# source: https://github.com/configu/setup-cli-action 2steps: 3 - uses: configu/setup-cli-action@v1 4 - run: configu [COMMAND]
After you've used the step, subsequent steps in the same job can run arbitrary Configu CLI commands. All of Configu commands work exactly like they do on your local command line.
Install with Docker:
You can also choose to run the CLI as an isolated Docker container instead.
docker run --rm configu/cli [COMMAND]
Manual install with TAR:
Alternatively, you can manually download the Configu CLI binary from the releases page and place it in a location that is included in your
$PATH. This is useful if you want to install a specific version of the CLI, or if you prefer to manually manage your dependencies.
You can also use this table to find the unversioned URLs for the TAR file (.tar.gz) for your operating system. When we release a new version of Configu CLI, we also update these URLs so they point to the most up-to-date version.
|Operating System||Tar Files||Manifest|
To extract the TAR file using tar, you can use the following command:
tar xz ./configu-<os>-<arm>.tar.gz
This will extract the contents of the TAR file into the current directory. You can also extract TAR files using other tools such as 7-Zip or WinZip. Simply right-click on the TAR file and select the option to extract the contents. Alternatively, you can use the GUI tools provided by your operating system to extract TAR files.
To use the Configu CLI from the
bin directory, you can run it directly from there:
To update your
$PATH permanently so that it can be run from any directory, add the appropriate entry to your shell's configuration file. For example, if you use the Bash shell, add this line to your ~/.bashrc or ~/.bash_profile file:
Once installed, you can use the Configu CLI by simply running
configu in your terminal.
If you see the help message of the Configu CLI including the current version of the installation, then your installation was successful.
The CLI has a built-in help system that you can use to learn about the available commands and options. You can access the help system by running
configu --help or configu [COMMAND] --help`.
To update the Configu CLI, you can run the following command:
If you encounter any errors, you can try re-installing the CLI by running the installation process again.