swift-ring-builder - En ligne dans le Cloud

PROGRAMME:

Nom

constructeur d'anneaux rapide - Générateur d'anneaux Openstack-swift

SYNOPSIS

constructeur d'anneaux rapide <...>

DESCRIPTION

L'utilitaire swift-ring-builder est utilisé pour créer, rechercher et manipuler le stockage rapide
anneau. Le constructeur d'anneau attribue des partitions aux appareils et écrit un Python optimisé
structure vers un fichier gzippé et décapé sur disque pour expédition vers les serveurs. Le serveur
les processus vérifient simplement l'heure de modification du fichier de temps en temps et rechargent leur
copies mémoire de la structure en anneau selon les besoins. En raison de la façon dont le constructeur d'anneau gère
modifications apportées à l'anneau, l'utilisation d'un anneau légèrement plus ancien signifie généralement simplement l'un des trois
les répliques d'un sous-ensemble des partitions seront incorrectes, ce qui peut être facilement utilisé
autour.

Le constructeur de l'anneau conserve également son propre fichier de constructeur avec les informations de l'anneau et des
données nécessaires à la construction des futurs anneaux. Il est très important de conserver plusieurs copies de sauvegarde
de ces fichiers de constructeur. Une option consiste à copier les fichiers du constructeur sur chaque serveur tout en
copier les fichiers de sonnerie eux-mêmes. Une autre consiste à télécharger les fichiers du constructeur dans le
cluster lui-même. La perte complète d'un fichier de constructeur signifiera la création d'un nouvel anneau à partir de
scratch, presque toutes les partitions finiront par être attribuées à différents appareils, et donc
presque toutes les données stockées devront être répliquées vers de nouveaux emplacements. Ainsi, la récupération d'un
la perte de fichier du constructeur est possible, mais les données seront définitivement inaccessibles pendant une période prolongée
le temps.

S'il est invoqué en tant que « swift-ring-builder-safe », le répertoire contenant le fichier de constructeur fourni
sera verrouillé (via un fichier .lock dans le répertoire parent des fichiers). Cela fournit une base
une protection contre plusieurs instances de swift-ring-builder (ou d'autres utilitaires qui
observer ce verrou) d'essayer d'écrire ou de lire les fichiers constructeur/anneau pendant
des opérations sont en cours. Cela peut être utile dans les environnements où la gestion des anneaux a
été automatisé, mais l'opérateur doit encore interagir manuellement avec les anneaux.

Rechercher

Peut être de la forme :
ré z - : / _

Toute partie est facultative, mais vous devez inclure au moins un exemple :

d74 Correspond à l'identifiant de l'appareil 74
z1 Correspond aux appareils de la zone 1
z1-1.2.3.4 Correspond aux appareils de la zone 1 avec l'ip 1.2.3.4
1.2.3.4 Correspond aux appareils dans n'importe quelle zone avec l'ip 1.2.3.4
z1:5678 Correspond aux périphériques de la zone 1 utilisant le port 5678
:5678 Correspond aux appareils qui utilisent le port 5678
/sdb1 Correspond aux périphériques avec le nom de périphérique sdb1
_shiny Correspond aux appareils avec brillant dans les métadonnées
_'snet : 5.6.7.8' Correspond aux appareils avec snet : 5.6.7.8 dans les métadonnées
[::1] Correspond aux appareils dans n'importe quelle zone avec l'ip ::1
z1-[::1]:5678 Correspond aux périphériques de la zone 1 avec ip :::1 et port 5678

Exemple le plus précis :

d74z1-1.2.3.4:5678/sdb1_"snet: 5.6.7.8"

Explication de nerd :

Tous les éléments nécessitent leur préfixe à caractère unique, à l'exception de l'adresse IP, auquel cas le -
est facultatif, sauf si l'identifiant ou la zone de l'appareil est également inclus.

COMMANDES

Affiche des informations sur l'anneau et les appareils qu'il contient.

recherche
Affiche des informations sur les appareils correspondants.

ajouter z - : / _
ajouter r z - : / _
ajouter -r -z -je -p -ré -m -w
Ajoute un appareil à l'anneau avec les informations fournies. Aucune partition ne sera attribuée
sur le nouvel appareil jusqu'à ce que vous ayez exécuté « rebalance ». C'est ainsi que vous pouvez faire plusieurs
changements d'appareil et rééquilibrez-les tous une seule fois.

créer des
Crée avec 2^ cloisons et .
est le nombre d'heures pour restreindre le déplacement d'une partition plus d'une fois.

liste_parties [ ] ..
Renvoie une liste à 2 colonnes de toutes les partitions affectées à l'un des périphériques
correspondant aux valeurs de recherche données. La première colonne est le numéro de partition attribué
et la deuxième colonne est le nombre de correspondances de périphériques pour cette partition. La liste est
ordonné du plus grand nombre de correspondances au moins. S'il y a beaucoup d'appareils pour correspondre
contre, cette commande peut prendre un certain temps à s'exécuter.

rééquilibrer
Tente de rééquilibrer l'anneau en réaffectant des partitions qui n'ont pas été récemment
réaffecté.

supprimez
Supprime le ou les appareils de l'anneau. Cela devrait normalement être utilisé pour un appareil
qui a échoué. Pour un appareil que vous souhaitez mettre hors service, il est préférable de définir son poids
à 0, attendez qu'il draine toutes ses données, puis utilisez cette commande remove. Ce ne sera pas
ne prend effet qu'après avoir exécuté 'rebalance'. C'est pour que vous puissiez faire plusieurs appareils
changements et rééquilibrez-les tous une seule fois.

set_info : / _
Réinitialise les informations de l'appareil. Ces informations ne sont pas utilisées pour attribuer des partitions, donc
vous pouvez utiliser 'write_ring' par la suite pour réécrire la sonnerie actuelle avec le nouvel appareil
informations. Toutes les parties sont facultatives dans la finale
: / _ paramètre; donnez juste ce que vous voulez changer. Pour
l'instance set_info d74 _"snet: 5.6.7.8" mettrait simplement à jour les métadonnées de l'identifiant de l'appareil
74.

set_min_part_hours
Modifie le au donné . Cela devrait être réglé aussi longtemps
un cycle complet de réplication/mise à jour prend. Nous travaillons sur un moyen de déterminer cela plus
facilement que la numérisation des journaux.

set_weight
Réinitialise le poids de l'appareil. Aucune partition ne sera réaffectée vers ou depuis l'appareil
jusqu'à ce qu'après avoir exécuté 'rebalance'. C'est ainsi que vous pouvez apporter plusieurs modifications à l'appareil et
rééquilibrez-les tous une seule fois.

valider
Exécute simplement les routines de validation sur l'anneau.

écrire_ring
Réécrit simplement le fichier de sonnerie distribuable. Cela se fait automatiquement après un
rééquilibrage réussi, donc vraiment cela n'est utile qu'après un ou plusieurs 'set_info'
appels lorsqu'aucun rééquilibrage n'est nécessaire mais que vous souhaitez envoyer le nouvel appareil
</br>L’Information.

Aperçu liste: ajouter créer list_parts rééquilibrer supprimer rechercher set_info
set_min_part_hours set_weight valider write_ring

Sortie codes: 0 = sonnerie changée, 1 = sonnerie n'a pas changé, 2 = erreur

DOCUMENTATION

Une documentation plus approfondie sur l'anneau Swift et Openstack-Swift dans son ensemble peuvent
être trouvé à http://swift.openstack.org/overview_ring.html,
http://swift.openstack.org/admin_guide.html#gérer-les-anneaux et
http://swift.openstack.org

Utilisez swift-ring-builder en ligne en utilisant les services onworks.net