Liqoctl is the swiss-knife CLI tool to install and manage Liqo clusters.
You can find how to install Liqo in the Installation section.
In this section, you can find how to use some
liqoctl install advanced features.
liqoctl install installs the last stable version of Liqo.
However, if you want to try an unstable release you can just specify it using the –version flag:
liqoctl install kind --version v0.3.1-alpha.1
It is suggested to use liqoctl of the same version you are installing. You can download liqoctl through the release page.
Under the hood, liqoctl uses Helm 3 to configure and install the Liqo chart available on the official repository.
However, if you prefer to directly use Helm you can use
liqoctl install just to “compile” the
values.yaml of the Liqo helm chart for your cluster and then install it using an explicit helm command.
liqoctl install k3s --only-output-values
By default, you will find the values.yaml file in the current directory.
You can then install Liqo by typing:
helm repo add liqo https://helm.liqo.io/ # if the repository was not already present helm install liqo liqo/liqo -n liqo --values values.yaml --create-namespace
If you need to install a custom version from a local version, you can use the
--version option like the following example:
git clone https://github.com/liqotech/liqo.git cd liqo git checkout $YOUR_COMMIT go run ./cmd/liqoctl install kind --chart-path ./deployments/liqo/ --version "$(git log --format="%H" -n 1)"
In this command, you are selecting the version tagged with the current commit as version and the
./deployments/liqo as chart path.