etcd 3.7 Documentation on PIG.CENTER

Démarrage rapide

Mon, 01 Jan 0001 00:00:00 +0000

Suivez ces instructions pour installer, exécuter et tester localement un cluster à membre unique de etcd :

Installez etcd à partir de binaires précompilés ou du code source. Pour plus de détails, consultez Installation .

Avertissement

Important : Veillez à effectuer la dernière étape des instructions d’installation afin de vérifier que etcd est dans votre chemin.
Démarrer etcd :
```
$ etcd
{"level":"info","ts":"2021-09-17T09:19:32.783-0400","caller":"etcdmain/etcd.go:72","msg":... }
⋮
```
Note

Remarque : La sortie produite par etcd est logs — des journaux de niveau info peuvent être ignorés.

Exemple

Mon, 01 Jan 0001 00:00:00 +0000

Cette série d’exemples illustre les procédures de base pour travailler avec un cluster etcd.

Auth

auth,user,role pour l’authentification :

export ETCDCTL_API=3
ENDPOINTS=localhost:2379

etcdctl --endpoints=${ENDPOINTS} role add root
etcdctl --endpoints=${ENDPOINTS} role get root

etcdctl --endpoints=${ENDPOINTS} user add root
etcdctl --endpoints=${ENDPOINTS} user grant-role root root
etcdctl --endpoints=${ENDPOINTS} user get root

etcdctl --endpoints=${ENDPOINTS} role add role0
etcdctl --endpoints=${ENDPOINTS} role grant-permission role0 readwrite foo
etcdctl --endpoints=${ENDPOINTS} user add user0
etcdctl --endpoints=${ENDPOINTS} user grant-role user0 role0

etcdctl --endpoints=${ENDPOINTS} auth enable
# now all client requests go through auth

etcdctl --endpoints=${ENDPOINTS} --user=user0:123 put foo bar
etcdctl --endpoints=${ENDPOINTS} get foo
# permission denied, user name is empty because the request does not issue an authentication request
etcdctl --endpoints=${ENDPOINTS} --user=user0:123 get foo
# user0 can read the key foo
etcdctl --endpoints=${ENDPOINTS} --user=user0:123 get foo1

Installer

Mon, 01 Jan 0001 00:00:00 +0000

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 :

Téléchargez le fichier archive compressé pour votre plateforme depuis Releases , en choisissant une version v3.7.0 ou ultérieure.
Décompressez le fichier archive. Cela crée un répertoire contenant les binaires.
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.

Portes fonctionnelles

Mon, 01 Jan 0001 00:00:00 +0000

Cette page présente un aperçu des diverses options de fonctionnalité qu’un administrateur peut spécifier sur etcd.

Voir étapes du fonctionnement pour une explication des étapes d’une fonctionnalité.

Aperçu

Les portes fonctionnelles sont un ensemble de paires clé=valeur qui décrivent les fonctionnalités d’etcd. Vous pouvez activer ou désactiver ces fonctionnalités à l’aide du drapeau de ligne de commande --feature-gates sur etcd.

FAQ

Mon, 01 Jan 0001 00:00:00 +0000

etcd, général

Qu’est-ce qu’etcd ?

etcd est un magasin clé-valeur distribué cohérent. Principalement utilisé comme service de coordination indépendant dans les systèmes distribués. Conçu pour stocker de petites quantités de données pouvant tenir entièrement en mémoire.

Comment prononce-t-on etcd ?

etcd se prononce /ˈɛtsiːdiː/ et signifie « répertoire etc distribué ».

Les clients doivent-ils envoyer des requêtes au leader etcd ?

Raft est basé sur un leader ; le leader gère toutes les requêtes clients nécessitant un consensus au sein du cluster. Toutefois, le client n’a pas besoin de savoir quel nœud est le leader. Toute requête nécessitant un consensus envoyée à un suiveur est automatiquement redirigée vers le leader. Les requêtes ne nécessitant pas de consensus (par exemple, les lectures sérialisées) peuvent être traitées par n’importe quel membre du cluster.

Bibliothèques et outils

Mon, 01 Jan 0001 00:00:00 +0000

Notez que les bibliothèques et outils tiers (non hébergés sur https://github.com/etcd-io ) mentionnés ci-dessous ne sont pas testés ni entretenus par l’équipe etcd. Avant de les utiliser, les utilisateurs sont invités à les lire et à les examiner.

Outils

etcdctl - Client en ligne de commande pour etcd
etcd-dump - Utilitaire en ligne de commande pour sauvegarder/restaurer etcd.
etcd-fs - Système de fichiers FUSE pour etcd
etcddir - Synchronisation en temps réel entre etcd et un répertoire local. Fonctionne sous Windows et Linux.
etcd-browser - Éditeur web de magasin clé-valeur pour etcd utilisant AngularJS
etcd-lock - Implémentation d’élection de maître et de verrouillage lecture/écriture distribué utilisant etcd - Prend en charge la version 2
etcd-console - Éditeur web de magasin clé-valeur pour etcd utilisant PHP
etcd-viewer - Éditeur/visualiseur de magasin clé-valeur etcd écrit en Java
etcdtool - Export/Import/Edit répertoire etcd en tant que JSON/YAML/TOML et validation du répertoire à l’aide d’un schéma JSON
etcdloadtest - Client de test de charge en ligne de commande pour etcd 3.0 et versions ultérieures
etcd-tui - Une interface utilisateur moderne en mode terminal (TUI) pour interagir avec votre base de données etcd. Parcourez les clés, affichez les valeurs, filtrez les données et gérez votre cluster etcd directement depuis votre terminal.
etcdfinder - Une interface web moderne et ultra-rapide pour etcd, avec recherche instantanée. Prend en charge à la fois etcd v2 et v3.
lucas - Un visualiseur de paires clé-valeur basé sur web pour les clusters etcd3.0+ de Kubernetes.
etcd-manager - Outil graphique et client moderne, efficace, multiplateforme et gratuit pour etcd 3.x. Disponible pour Windows, Linux et Mac.
etcd-backup-restore - Utilitaire permettant de sauvegarder et de restaurer de manière périodique et incrémentielle etcd.
etcd-druid - Opérateur Kubernetes permettant de déployer des clusters etcd et de gérer les opérations de gestion de jour 2.
etcdadm - Outil en ligne de commande pour gérer un cluster etcd.
etcd-defrag - Outil de défragmentation etcd plus facile à utiliser et plus intelligent.
etcdhelper - Plugin pour la plateforme IntelliJ pour etcd.

Bibliothèques

Les sections ci-dessous listent les bibliothèques clientes etcd par langage.

Signalement de bogues

Mon, 01 Jan 0001 00:00:00 +0000

Si une partie du projet etcd présente des bogues ou des erreurs de documentation, veuillez nous en informer en ouvrant une demande . Nous prenons très au sérieux les bogues et les erreurs, et considérons qu’aucun problème n’est trop petit. Avant de créer un rapport de bogue, veuillez vérifier qu’une demande signalant le même problème n’existe pas déjà.

Pour que le rapport de bogues soit précis et facile à comprendre, veuillez essayer de rédiger des rapports de bogues qui sont :

Optimisation

Mon, 01 Jan 0001 00:00:00 +0000

Les paramètres par défaut d’etcd devraient fonctionner correctement pour les installations sur un réseau local où la latence réseau moyenne est faible. Toutefois, lors de l’utilisation d’etcd sur plusieurs centres de données ou sur des réseaux à forte latence, il se peut que les paramètres d’intervalle de battement et de délai d’élection nécessitent une adaptation.

Le réseau n’est pas la seule source de latence. Chaque requête et réponse peut être affectée par des disques lents sur le leader et le suiveur. Chacun de ces délais d’attente représente le temps total écoulé entre la requête et la réponse réussie de l’autre machine.