Skip to content

Commit

Permalink
Add Linux installation instructions
Browse files Browse the repository at this point in the history
Signed-off-by: Ivan Valdes <ivan@vald.es>
  • Loading branch information
ivanvc committed Feb 22, 2024
1 parent 7c1f764 commit 0622ccc
Show file tree
Hide file tree
Showing 2 changed files with 223 additions and 4 deletions.
114 changes: 112 additions & 2 deletions content/en/docs/v3.5/install.md
Original file line number Diff line number Diff line change
Expand Up @@ -86,14 +86,122 @@ $ brew update
$ brew install etcd
```

3. Verify install
3. Verify install
```sh
$ etcd --version
```

## Linux

TBD
Although it is possible to install etcd through major distribution's official repositories and package managers, the versions published are significantly outdated. So, installing this way is strongly discouraged.

The following package managers are community maintained and have the most up-to-date version:

### Homebrew on Linux

[Homebrew can run on Linux], and can provide recent software versions.

* Prerequisites
* Update Homebrew:
```sh
$ brew update
```
* Procedure
* Install using `brew`:
```sh
$ brew install etcd
```
* Result
* Verify installation by getting the version:
```sh
$ etcd --version
etcd Version: {{< psubstr git_version_tag 1 >}}
...
```

### Alpine Linux

Alpine Linux provides two separate packages: `etcd` and `etcd-ctl`. They are in the testing repository, so you must enable it before installing.

* Prerequisites
* Enable testing repository:
```sh
$ echo 'https://dl-cdn.alpinelinux.org/alpine/edge/testing/' | sudo tee -a /etc/apk/repositories
# or if you're running as root:
$ echo 'https://dl-cdn.alpinelinux.org/alpine/edge/testing/' >> /etc/apk/repositories
```
* Procedure
* Install using apk:
```sh
$ sudo apk add etcd etcd-ctl
# or if you're running as root:
$ apk add etcd etcd-ctl
```
* Result
* Verify installation by getting the version:
```sh
$ etcd --version
etcd Version: {{< psubstr git_version_tag 1 >}}
...
```

### ArchLinux (AUR)

The [Arch User Repository (AUR)] keeps an up-to-date version.

* Prerequisites
* Ensure you have installed the `base-devel` package:
```sh
$ sudo pacman -S base-devel
```
* Fetch the most recent snapshot by going to https://aur.archlinux.org/packages/etcd
* Extract the downloaded tar.gz file:
```sh
$ tar -zxf etcd.tar.gz
```
* Change the working directory:
```sh
$ cd etcd
```
* Procedure
* Run `makepkg`:
```sh
$ makepkg -s
```
* Install the generated pkg file:
```sh
$ sudo pacman -U etcd-*.pkg.tar.zst
```
* Result
* Verify installation by getting the version:
```sh
$ etcd --version
etcd Version: {{< psubstr git_version_tag 1 >}}
...
```

### ALT Linux Sisyphus

ALT Linux Sisyphus maintains an up-to-date version.

* Prerequisites
* Update apt repository
```sh
$ sudo apt-get update
```
* Procedure
* Install using `apt-get`:
```sh
$ sudo apt-get install etcd
```
* Result
* Verify installation by getting the vesion:
```sh
$ etcd --version
etcd Version: {{< psubstr git_version_tag 1 >}}
...
```

## Installation as part of Kubernetes installation

TBD---Help Wanted
Expand All @@ -115,3 +223,5 @@ For a slightly more involved sanity check of your installation, see
[tagged-release]: https://github.com/etcd-io/etcd/releases/tag/{{< param git_version_tag >}}
[Supported platforms]: {{< relref "op-guide/supported-platform" >}}
[Bitnami's etcd Helm chart]: https://bitnami.com/stack/etcd/helm
[Arch User Repository (AUR)]: https://wiki.archlinux.org/title/Arch_User_Repository
[Homebrew can run on Linux]: https://docs.brew.sh/Homebrew-on-Linux
113 changes: 111 additions & 2 deletions content/en/docs/v3.6/install.md
Original file line number Diff line number Diff line change
Expand Up @@ -86,14 +86,121 @@ $ brew update
$ brew install etcd
```

3. Verify install
3. Verify install
```sh
$ etcd --version
```

## Linux

TBD
Although it is possible to install etcd through major distribution's official repositories and package managers, the versions published are significantly outdated. So, installing this way is strongly discouraged.

The following package managers are community maintained and have the most up-to-date version:

### Homebrew on Linux

[Homebrew can run on Linux], and can provide recent software versions.

* Prerequisites
* Update Homebrew:
```sh
$ brew update
```
* Procedure
* Install using `brew`:
```sh
$ brew install etcd
```
* Result
* Verify installation by getting the version:
```sh
$ etcd --version
etcd Version: {{< psubstr git_version_tag 1 >}}
...
```

### Alpine Linux

Alpine Linux provides two separate packages: `etcd` and `etcd-ctl`. They are in the testing repository, so you must enable it before installing.

* Prerequisites
* Enable testing repository:
```sh
$ echo 'https://dl-cdn.alpinelinux.org/alpine/edge/testing/' | sudo tee -a /etc/apk/repositories
# or if you're running as root:
$ echo 'https://dl-cdn.alpinelinux.org/alpine/edge/testing/' >> /etc/apk/repositories
```
* Procedure
* Install using apk:
```sh
$ sudo apk add etcd etcd-ctl
# or if you're running as root:
$ apk add etcd etcd-ctl
```
* Result
* Verify installation by getting the version:
```sh
$ etcd --version
etcd Version: {{< psubstr git_version_tag 1 >}}
...
```

### ArchLinux (AUR)

The [Arch User Repository (AUR)] keeps an up-to-date version.

* Prerequisites
* Ensure you have installed the `base-devel` package:
```sh
$ sudo pacman -S base-devel
```
* Fetch the most recent snapshot by going to https://aur.archlinux.org/packages/etcd
* Extract the downloaded tar.gz file:
```sh
$ tar -zxf etcd.tar.gz
```
* Change the working directory:
```sh
$ cd etcd
```
* Procedure
* Run `makepkg`:
```sh
$ makepkg -s
```
* Install the generated pkg file:
```sh
$ sudo pacman -U etcd-*.pkg.tar.zst
```
* Result
* Verify installation by getting the version:
```sh
$ etcd --version
etcd Version: {{< psubstr git_version_tag 1 >}}
...
```

### ALT Linux Sisyphus

ALT Linux Sisyphus maintains an up-to-date version.

* Prerequisites
* Update apt repository
```sh
$ sudo apt-get update
```
* Procedure
* Install using `apt-get`:
```sh
$ sudo apt-get install etcd
```
* Result
* Verify installation by getting the vesion:
```sh
$ etcd --version
etcd Version: {{< psubstr git_version_tag 1 >}}
...
```

## Installation as part of Kubernetes installation

Expand All @@ -116,3 +223,5 @@ For a slightly more involved sanity check of your installation, see
[tagged-release]: https://github.com/etcd-io/etcd/releases/tag/{{< param git_version_tag >}}
[Supported platforms]: {{< relref "op-guide/supported-platform" >}}
[Bitnami's etcd Helm chart]: https://bitnami.com/stack/etcd/helm
[Arch User Repository (AUR)]: https://wiki.archlinux.org/title/Arch_User_Repository
[Homebrew can run on Linux]: https://docs.brew.sh/Homebrew-on-Linux

0 comments on commit 0622ccc

Please sign in to comment.