website icon indicating copy to clipboard operation
website copied to clipboard

Where do I download etcdutl?

Open chadleywilson opened this issue 7 months ago • 4 comments
trafficstars

Hi

I am newbie, I am following the documentation from https://kubernetes.io/docs/tasks/administer-cluster/configure-upgrade-etcd/

I have several on premise clusters and I need to back them up.

now I can't get etcdctl to work because its doesn't have the "snapshot" option anymore and there is zero / nothing explaining how to use the new format of commands:

etcdctl backup --data-dir <doesn't matter what I put here, none of the parameters work>

I looked for an older package without any luck.

So I have now starting looking at etcdutl and google has never heard of it and I have no idea where to get it. I am NOT a developer and do not have a compiling environment setup, so I will not be adding yet another repo to my local drive. (I just need a package)

I do not want to compile the software I just want an Ubuntu / Debian package so I can crack on with learning to backup and restore my cluster.

What am I missing? Why can't I find the answers on google?

TIA Chadley

chadleywilson avatar Mar 31 '25 10:03 chadleywilson

Hi, @chadleywilson. Thanks for raising this issue. You can download etcdutl from our released files at the main etcd repository (https://github.com/etcd-io/etcd/releases), select the version you want to download, and uncompress the downloaded archive.

I do not want to compile the software I just want an Ubuntu / Debian package so I can crack on with learning to backup and restore my cluster.

We don't recommend using distribution-released packages because their release version lags significantly behind our latest versions.

Why can't I find the answers on google?

The removal of snapshot save is new in v3.6. We're still working on this documentation. The issue could be that the upgrade guide is not online yet (but I don't want to dig further into SEO practices ;)

@jmhbnz / @ahrtr, I think we need to include the removal of etcdctl snapshot save (in favor of etcdutl snapshot restore) in our upgrade instructions, as this is not the first time someone has raised this question.

ivanvc avatar Mar 31 '25 10:03 ivanvc

@jmhbnz / @ahrtr, I think we need to include the removal of etcdctl snapshot save (in favor of etcdutl snapshot restore) in our upgrade instructions

It isn't a blocker for the upgrade, but we just need to point users to the breaking changes and deprecations

ahrtr avatar Mar 31 '25 16:03 ahrtr

It isn't a blocker for the upgrade, but we just need to point users to the breaking changes and deprecations

Is the CHANGELOG out of date? In rc.3 we don't have etcdutl snapshot save, it is still in etcdctl.

ivanvc avatar Apr 01 '25 12:04 ivanvc

It isn't a blocker for the upgrade, but we just need to point users to the breaking changes and deprecations

Is the CHANGELOG out of date? In rc.3 we don't have etcdutl snapshot save, it is still in etcdctl.

It's in rc.0.

ahrtr avatar Apr 01 '25 14:04 ahrtr

Discussed during sig-etcd triage meeting, the immediate question of where to download etcdutl has been answered (https://github.com/etcd-io/etcd/releases/). We have an open issue for the upgrade guide (https://github.com/etcd-io/website/issues/963), closing.

jmhbnz avatar May 08 '25 18:05 jmhbnz