ECM Distro Tools is a collection of utilities that provide for easier administration, management, and interaction with the great Rancher ecosystems, including RKE2 and K3s.
The easiest way to install a single utility is to go to the release page, choose the release you want, and download the utility for your operation system and architecture.
To install all executables and shell libraries, run the install script as follows:
Install the latest version
curl -sfL https://raw.githubusercontent.com/rancher/ecm-distro-tools/master/install.sh | sh -Install a specific version
curl -sfL https://raw.githubusercontent.com/rancher/ecm-distro-tools/master/install.sh | ECM_VERSION=v0.31.2 sh -This will download all binaries and shell libraries and install them to /usr/local/bin/ecm-distro-tools. You'll need to add that directory to your path after installation.
New Configuration File
release config gen > $HOME/.ecm-distro-tools/config.jsonLoad config from custom path
release config view -c ./config.jsonLoad config from string
release generate rancher missing-images-list v2.7.15 -C '{"rancher": { "versions": {"v2.7.15": {"check_images": ["rancher/rancher:v2.7.15"]}}}}' -i "https://prime.ribs.rancher.io/rancher/v2.7.15/rancher-images.txt" --ignore-validateThere's a mix of code in this repository. The shell scripts and shell libraries reside in the bin directory and are ready to use. The Go programs are rooted in the cmd directory and need to be compiled.
To compile the programs run the following in the root of the project:
make allTo compile the container image locally:
docker build . -t rancher/ecm-distro-toolsThe following is a non-exausitve list of the utilities included in this repository and their corresponding usage. (see bin/ and cmd/ for all utility code)
utility_indexFor details on specific utilities, review the script header or the README for the specific utility.
All utilities comes with help output.
This repository provides the "Setup ecm-distro-tools" GitHub action.
It downloads the assets belonging to the specified release to a temporary directory,
and adds the directory to the PATH.
The action can be run on ubuntu-latest runners.
The version parameter is required.
Providing the GH_TOKEN environment variable is recommended to avoid rate limiting by the GitHub API.
steps:
- name: setup ecm-distro-tools
uses: rancher/[email protected]
with:
version: v0.27.0
env:
GH_TOKEN: ${{ github.token }}
- name: release
run: release -hWe welcome additions to this repo and are excited to keep expanding its functionality.
To contribute, please do the following:
- Open an issue explaining the feature(s) / bug(s) you are looking to add/fix.
- Fork the repo, create a branch, push your changes, and open a pull request.
- Request review
A set of patterns have been established with the Go and shell code that need to be adhered to. Usage output and flags should be copied and pasted from other code files and adjusted to keep the UX as similar as possible to the rest of the utilities in the repo.
Library code has been written for Go and shell which to simpler access to Github, loggers, and means of validating common checks.
When a new utility is added or an API is changed, documentation needs to be updated to reflect that change. This needs to be done wherever that documentation lives, likely the utility's README.
- Go code additions are expected to have been linted, vetted, and fmt'd prior to pushing the code.
- Prefer the standard library over 3rd party libraries when possible
- Shell scripts are expected to be POSIX compliant, avoiding specific shell features for portability. We are currently using
shellcheckto perform these checks and validations.
When building locally, you may want to build just for your ARCH and OS. To do so, you can use one of the two methods below:
Using this method, you can set these variables in .bashrc or .zshrc to make it easier to alaways build for your ARCH and OS.
Just be aware that if you do this, you'll need to unset them if you want to build for all ARCHs and OSs.
export ARCHS=amd64
export OSs=linux
make allUsing this method, you'll need to set the variables each time you want to build just for your ARCH and OS.
make ARCHS=amd64 OSs=linux allecm-distro-tools source code is available under the Apache Clause License.
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent