CLI Setup
Install with script
To install Configu CLI globally, you can use the following command:
1curl https://cli.configu.com/install.sh | shThis 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.
If you want to install the CLI in a stanalone mode (without granting it permissions to add it to $PATH), you can replace the url in the command with https://cli.configu.com/install-standalone.sh.
It is important to note that currently the install-standalone.sh script is only available for Unix-based operating systems, such as Linux and macOS.
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 |
|---|---|---|
| Linux | ||
| MacOS | ||
| Windows |
To extract the TAR file using tar, you can use the following command:
tar xz ./configu-<os>-<arm>.tar.gzThis 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:
./configu/bin/configu [COMMAND]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:
PATH=<path-to-upacked-directory>/bin:$PATHVerify
Once installed, you can use the Configu CLI by simply running configu in your terminal.
configuIf 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`.
Update
To update the Configu CLI, you can run the following command:
configu updateIf you encounter any errors, you can try re-installing the CLI by running the installation process again.
Install Autocomplete
To display autocomplete installation instructions, you can run the following command:
configu autocomplete