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 393d219
Show file tree
Hide file tree
Showing 2 changed files with 275 additions and 4 deletions.
140 changes: 138 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,148 @@ $ brew update
$ brew install etcd
```

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

## Linux

TBD
Although it is possible to install etcd through many major Linux 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 +249,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>
139 changes: 137 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,147 @@ $ brew update
$ brew install etcd
```

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

## Linux

TBD
Although it is possible to install etcd through many major Linux 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 +249,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 393d219

Please sign in to comment.