Installer

Exigences

Avant d’installer etcd, consultez les pages suivantes :

• Plateformes prises en charge
• Recommandations matérielles

Installer les binaires préconstruits

La méthode la plus simple pour installer etcd consiste à utiliser des binaires pré-construits :

1. Téléchargez le fichier archive compressé pour votre plateforme depuis versions publiées , en choisissant une version v3.7.2 ou ultérieure.

2. Décompressez le fichier archive. Cela crée un répertoire contenant les binaires.

3. Ajoutez les binaires exécutables à votre chemin d’accès. Par exemple, renommez et/ou déplacez les binaires vers un répertoire de votre chemin d’accès (comme /usr/local/bin), ou ajoutez le répertoire créé à l’étape précédente à votre chemin d’accès.

4. À partir d’un shell, vérifiez que etcd est dans votre chemin d’accès :

   $ etcd --version
   etcd Version: 3.7.2
   ...

Générer à partir du code source

Pour etcd v3.7.2, utilisez Go version 1.26+ ; cette version fixe la chaîne d’outils Go 1.26.8. Compilez etcd à partir de son code source en suivant ces étapes :

1. Téléchargez le dépôt etcd sous forme de fichier zip et décompressez-le, ou clonez le dépôt à l’aide de la commande suivante.

   $ git clone -b v3.7.2 https://github.com/etcd-io/etcd.git

   Pour construire à partir de main@HEAD, omettre le drapeau -b v3.7.2.

2. Changer de répertoire :

   $ cd etcd

3. Exécutez le script de compilation :

   $ ./scripts/build.sh

   Les binaires se trouvent dans le répertoire bin.

4. Ajoutez le chemin complet du répertoire bin à votre variable d’environnement PATH, par exemple :

   $ export PATH="$PATH:`pwd`/bin"

5. Vérifiez que etcd est dans votre chemin :

   $ etcd --version

Installation via les paquets du système

Avertissement : les installations d’etcd via les gestionnaires de paquets du système d’exploitation peuvent fournir des versions obsolètes, car elles ne sont ni automatiquement maintenues ni officiellement prises en charge par le projet etcd. Utilisez donc les paquets du système avec précaution.

Il existe plusieurs façons d’installer etcd sur différents systèmes d’exploitation, et voici quelques exemples de la manière dont cela peut être réalisé.

macOS (Homebrew)

1. Mettre à jour Homebrew :

$ brew update

2. Installer etcd :

$ brew install etcd

3. Vérifier l’installation

$ etcd --version

Linux

Bien qu’il soit possible d’installer etcd via les dépôts officiels et les gestionnaires de paquets de nombreuses distributions Linux majeures, les versions publiées peuvent être fortement obsolètes. L’installation de cette manière est donc fortement déconseillée.

La méthode recommandée pour installer etcd sous Linux consiste soit à utiliser des binaires pré-construits , soit à utiliser Homebrew.

Homebrew sous Linux

Homebrew peut fonctionner sous Linux et peut fournir des versions récentes des logiciels.

• Prérequis

  • Mettre à jour Homebrew :

    $ brew update

• Procédure

  • Installation à l’aide de brew :

    $ brew install etcd

• Résultat

  • Vérifiez l’installation en obtenant la version :

    $ etcd --version
    etcd Version: 3.7.2
    ...

    La sortie ci-dessus est un exemple. La version corrective fournie par Homebrew peut différer ; vérifiez la version installée avec etcd --version.

Docker

etcd utilise gcr.io/etcd-development/etcd comme registre conteneur principal, et quay.io/coreos/etcd comme secondaire.

Pour exécuter etcd à l’aide de Docker :

ETCD_VER=v3.7.2

rm -rf /tmp/etcd-data.tmp && mkdir -p /tmp/etcd-data.tmp && \
  docker rmi gcr.io/etcd-development/etcd:${ETCD_VER} || true && \
  docker run \
  -p 2379:2379 \
  -p 2380:2380 \
  --mount type=bind,source=/tmp/etcd-data.tmp,destination=/etcd-data \
  --name etcd-gcr-${ETCD_VER} \
  gcr.io/etcd-development/etcd:${ETCD_VER} \
  /usr/local/bin/etcd \
  --name s1 \
  --data-dir /etcd-data \
  --listen-client-urls http://0.0.0.0:2379 \
  --advertise-client-urls http://0.0.0.0:2379 \
  --listen-peer-urls http://0.0.0.0:2380 \
  --initial-advertise-peer-urls http://0.0.0.0:2380 \
  --initial-cluster s1=http://0.0.0.0:2380 \
  --initial-cluster-token tkn \
  --initial-cluster-state new \
  --log-level info \
  --logger zap \
  --log-outputs stderr

docker exec etcd-gcr-${ETCD_VER} /usr/local/bin/etcd --version
docker exec etcd-gcr-${ETCD_VER} /usr/local/bin/etcdctl version
docker exec etcd-gcr-${ETCD_VER} /usr/local/bin/etcdutl version
docker exec etcd-gcr-${ETCD_VER} /usr/local/bin/etcdctl endpoint health
docker exec etcd-gcr-${ETCD_VER} /usr/local/bin/etcdctl put foo bar
docker exec etcd-gcr-${ETCD_VER} /usr/local/bin/etcdctl get foo

Installation dans le cadre de l’installation de Kubernetes

• Exécuter etcd en tant que StatefulSet Kubernetes

Vérification d’installation

Pour une vérification de cohérence un peu plus poussée de votre installation, consultez Démarrage rapide .