Starting with release 2023.03.0 for Linux and 2023.04.0 for Windows and macOS, CloudBees CD/RO releases include a CloudBees Tools archive you can add to your installation. This archive includes the CloudBees CD/RO client binaries used to interact with CloudBees CD/RO server and serves as a lightweight option compared to installing the tools separately using multiple installers.
CloudBees CD/RO is normally backward compatible with older versions of CloudBees Tools as long as you are using the latest API version. However, to assure you have the latest CloudBees Tool features and API support, you must update the CloudBees Tools client binaries to the latest version as they are released. For information on upgrading the CloudBees Tools archive to the latest version, refer to Updating CloudBees Tools. |
The following tool commands are included in the CloudBees Tools archive:
-
cb-perl
: Use to access CloudBees CD/RO Perl APIs. For more information, refer to Use the CloudBees CD/RO Perl API. -
dslsync
: Use with git log to identify DSL changes to apply to the server. For more information, refer to DSL Git Synchronization -
ectool
: Use to manage CloudBees CD/RO. For more information, refer to Use the CloudBees CD/RO ectool API. -
ec-groovy
: Use to access CloudBees CD/RO Groovy APIs. For more information, refer to Use the CloudBees CD/RO Groovy API.
Install CloudBees CD/RO Tools
Use the information in this section to complete the installation of the CloudBees CD/RO tools.
-
Navigate to CloudBees CD/RO downloads.
-
Select the latest release for CloudBees CD/RO.
-
Download the CloudBees CD/RO Tools archive files.
-
Linux and macOS:
CloudBeesFlowTools-<version>.tar.gz
-
Windows:
CloudBeesFlowTools-<version>.zip
-
-
Extract the archive files into a
CloudBeesFlowTools-<version>
directory within the current directory.-
Linux and macOS: Run the command below in directory containing archive file.
tar -xf CloudBeesFlowTools.tar.gz
-
Windows 10 and later: Right-click on the archive file. Then select Extract all.
-
-
Add CloudBees CD/RO tools to system path.
-
Linux and macOS: Use the command below.
export PATH=/path/you/installed/CloudBeesFlowTools-<version>/bin:$PATH
-
Windows 10 and later: Add
path\you\installed\CloudBeesFlowTools-<version>\bin
to thePATH
environmental variable using your chosen method.
-
Verify access to CloudBees CD/RO Tools
After installing CloudBees CD/RO tools test access to them using the --help
for each tool.
-
Access
cb-perl
command help:View access details
-
Linux and macOS
-
Access via archive folder.
cb-perl --help
-
Access using a relative path
bin/cb-perl --help
-
Access using the full path.
/path/you/installed/CloudBeesFlowTools-<version>/bin/cb-perl --help
-
-
Windows
Access the
*.exe
from theCloudBeesFlowTools-<version>/bin
.\path\you\installed\CloudBeesFlowTools-<version>\bin\ectool.exe --help
-
-
Access
dslsync
command help:View access details
-
Linux and macOS
-
Access via archive folder.
dslsync --help
-
Access using a relative path
bin/dslsync --help
-
Access using the full path.
/path/you/installed/CloudBeesFlowTools-<version>/bin/dslsync --help
-
-
Windows
Access the
*.exe
from theCloudBeesFlowTools-<version>/bin
.\path\you\installed\CloudBeesFlowTools-<version>\bin\dslsync.exe --help
-
-
Access
ectool
command help:View access details
-
Linux and macOS
-
Access via archive folder.
ectool --help
-
Access using a relative path
bin/ectool --help
-
Access using the full path.
/path/you/installed/CloudBeesFlowTools-<version>/bin/ectool --help
-
-
Windows
Access the
*.exe
from theCloudBeesFlowTools-<version>/bin
.\path\you\installed\CloudBeesFlowTools-<version>\bin\ectool.exe --help
-
-
Access
ec-groovy
command help:View access details
-
Execute export commands
export COMMANDER_HOME=/path/you/installed/CloudBeesFlowTools
export COMMANDER_DATA=/path/you/installed/CloudBeesFlowTools
-
Access
ec-groovy
help.ec-groovy --help
-
Updating CloudBees Tools
CloudBees CD/RO is normally backward compatible with older versions of CloudBees Tools as long as you are using the latest API version. However, to assure you have the latest CloudBees Tool features and API support, you must update the CloudBees Tools client binaries to the latest version as they are released. To get the latest tool versions:
-
Navigate to CloudBees CD/RO downloads.
-
Select the latest release for CloudBees CD/RO.
-
Download the CloudBees Tools archive file for your distribution.
-
Linux and macOS:
CloudBeesFlowTools-<version>.tar.gz
-
Windows:
CloudBeesFlowTools-<version>.zip
-
-
Extract the archive in the same location as your current version.
For specific instructions on extracting the archive, refer to Install CloudBees CD/RO tools -
If prompted to override existing files, you may answer Yes to All.