Créer et distribuer les anneaux initiaux.¶

Avant de démarrer les services de Stockage Objet, vous devez créer le compte initial, le conteneur et les anneaux d’objets. Le constructeur d’anneau créé des fichiers de configuration que chaque nœud utilise pour déterminer et déployer l’architecture de stockage. Pour simplifier, ce guide utilise une région et deux zones avec au maximum 2^10 (1024) partitions, 3 replicas de chaque objet, et au minimum 1 heure entre les déplacements multiples de partition. Pour le Stockage Objet, une partition désigne un répertoire sur un device de stockage plutôt qu’une table de partition conventionnelle. Pour plus d’informations, voir le Guide de Déploiement.

Note

Effectuer ces opérations sur le contrôleur.

Créer l’anneau des comptes¶

Le serveur de comptes utilise l’anneau de comptes pour maintenir les listes de conteneurs.

Se placer dans le répertoire /etc/swift.
Créer le fichier de base account.builder :
```
# swift-ring-builder account.builder create 10 3 1
```
Note

Cette commande ne produit aucune sortie.

Ajouter chaque nœud de stockage à l’anneau :

# swift-ring-builder account.builder \
  add --region 1 --zone 1 --ip STORAGE_NODE_MANAGEMENT_INTERFACE_IP_ADDRESS --port 6002 \
  --device DEVICE_NAME --weight DEVICE_WEIGHT

Remplacer STORAGE_NODE_MANAGEMENT_INTERFACE_IP_ADDRESS par l’adresse IP du réseau de management sur le nœud de stockage. Remplacer DEVICE_NAME par le nom d’un device de stockage sur le même nœud de stockage. Par exemple, utiliser le premier nœud de stockage du Installer et configurer les nœuds de stockage avec le device de stockage ``/dev/sdb``et un poids de 100 :

# swift-ring-builder account.builder add \
  --region 1 --zone 1 --ip 10.0.0.51 --port 6002 --device sdb --weight 100

Répéter cette commande pour chaque device de stockage sur chaque nœud de stockage. Dans l’exemple d’architecture, utiliser la commande de quatre façons différentes :

# swift-ring-builder account.builder add \
  --region 1 --zone 1 --ip 10.0.0.51 --port 6002 --device sdb --weight 100
Device d0r1z1-10.0.0.51:6002R10.0.0.51:6002/sdb_"" with 100.0 weight got id 0
# swift-ring-builder account.builder add \
  --region 1 --zone 1 --ip 10.0.0.51 --port 6002 --device sdc --weight 100
Device d1r1z2-10.0.0.51:6002R10.0.0.51:6002/sdc_"" with 100.0 weight got id 1
# swift-ring-builder account.builder add \
  --region 1 --zone 2 --ip 10.0.0.52 --port 6002 --device sdb --weight 100
Device d2r1z3-10.0.0.52:6002R10.0.0.52:6002/sdb_"" with 100.0 weight got id 2
# swift-ring-builder account.builder add \
  --region 1 --zone 2 --ip 10.0.0.52 --port 6002 --device sdc --weight 100
Device d3r1z4-10.0.0.52:6002R10.0.0.52:6002/sdc_"" with 100.0 weight got id 3

Vérifier les contenus des anneaux :

# swift-ring-builder account.builder
account.builder, build version 4
1024 partitions, 3.000000 replicas, 1 regions, 2 zones, 4 devices, 100.00 balance, 0.00 dispersion
The minimum number of hours before a partition can be reassigned is 1
The overload factor is 0.00% (0.000000)
Devices:    id  region  zone      ip address  port  replication ip  replication port      name weight partitions balance meta
             0       1     1       10.0.0.51  6002       10.0.0.51              6002      sdb  100.00          0 -100.00
             1       1     1       10.0.0.51  6002       10.0.0.51              6002      sdc  100.00          0 -100.00
             2       1     2       10.0.0.52  6002       10.0.0.52              6002      sdb  100.00          0 -100.00
             3       1     2       10.0.0.52  6002       10.0.0.52              6002      sdc  100.00          0 -100.00

Ré-équiliber l’anneau :

# swift-ring-builder account.builder rebalance
Reassigned 1024 (100.00%) partitions. Balance is now 0.00.  Dispersion is now 0.00

Créer l’anneau de conteneurs¶

Le serveur de conteneurs utilise l’anneau de conteneurs pour maintenir les listes d’objets. Néanmoins, il ne trace pas l’emplacement des objets.

Se placer dans le répertoire /etc/swift.
Créer le fichier de base container.builder :
```
# swift-ring-builder container.builder create 10 3 1
```
Note

Cette commande ne produit aucune sortie.

Ajouter chaque nœud de stockage à l’anneau :

# swift-ring-builder container.builder \
  add --region 1 --zone 1 --ip STORAGE_NODE_MANAGEMENT_INTERFACE_IP_ADDRESS --port 6001 \
  --device DEVICE_NAME --weight DEVICE_WEIGHT

Remplacer STORAGE_NODE_MANAGEMENT_INTERFACE_IP_ADDRESS par l’adresse IP du réseau de management sur le nœud de stockage. Remplacer DEVICE_NAME par le nom d’un device de stockage sur le même nœud de stockage. Par exemple, utiliser le premier nœud de stockage du Installer et configurer les nœuds de stockage avec le device de stockage ``/dev/sdb``et un poids de 100 :

# swift-ring-builder container.builder add \
  --region 1 --zone 1 --ip 10.0.0.51 --port 6001 --device sdb --weight 100

Répéter cette commande pour chaque device de stockage sur chaque nœud de stockage. Dans l’exemple d’architecture, utiliser la commande de quatre façons différentes :

# swift-ring-builder container.builder add \
  --region 1 --zone 1 --ip 10.0.0.51 --port 6001 --device sdb --weight 100
Device d0r1z1-10.0.0.51:6001R10.0.0.51:6001/sdb_"" with 100.0 weight got id 0
# swift-ring-builder container.builder add \
  --region 1 --zone 1 --ip 10.0.0.51 --port 6001 --device sdc --weight 100
Device d1r1z2-10.0.0.51:6001R10.0.0.51:6001/sdc_"" with 100.0 weight got id 1
# swift-ring-builder container.builder add \
  --region 1 --zone 2 --ip 10.0.0.52 --port 6001 --device sdb --weight 100
Device d2r1z3-10.0.0.52:6001R10.0.0.52:6001/sdb_"" with 100.0 weight got id 2
# swift-ring-builder container.builder add \
  --region 1 --zone 2 --ip 10.0.0.52 --port 6001 --device sdc --weight 100
Device d3r1z4-10.0.0.52:6001R10.0.0.52:6001/sdc_"" with 100.0 weight got id 3

Vérifier les contenus des anneaux :

# swift-ring-builder container.builder
container.builder, build version 4
1024 partitions, 3.000000 replicas, 1 regions, 2 zones, 4 devices, 100.00 balance, 0.00 dispersion
The minimum number of hours before a partition can be reassigned is 1
The overload factor is 0.00% (0.000000)
Devices:    id  region  zone      ip address  port  replication ip  replication port      name weight partitions balance meta
             0       1     1       10.0.0.51  6001       10.0.0.51              6001      sdb  100.00          0 -100.00
             1       1     1       10.0.0.51  6001       10.0.0.51              6001      sdc  100.00          0 -100.00
             2       1     2       10.0.0.52  6001       10.0.0.52              6001      sdb  100.00          0 -100.00
             3       1     2       10.0.0.52  6001       10.0.0.52              6001      sdc  100.00          0 -100.00

Ré-équiliber l’anneau :

# swift-ring-builder container.builder rebalance
Reassigned 1024 (100.00%) partitions. Balance is now 0.00.  Dispersion is now 0.00

Créer l’anneau d’ objets¶

Le serveur d’objets utilise l’anneau d’objets pour maintenir les listes des emplacements des objets sur les devices locaux.

Se placer dans le répertoire /etc/swift.
Créer le fichier de base object.builder :
```
# swift-ring-builder object.builder create 10 3 1
```
Note

Cette commande ne produit aucune sortie.

Ajouter chaque nœud de stockage à l’anneau :

# swift-ring-builder object.builder \
  add --region 1 --zone 1 --ip STORAGE_NODE_MANAGEMENT_INTERFACE_IP_ADDRESS --port 6000 \
  --device DEVICE_NAME --weight DEVICE_WEIGHT

Remplacer STORAGE_NODE_MANAGEMENT_INTERFACE_IP_ADDRESS par l’adresse IP du réseau de management sur le nœud de stockage. Remplacer DEVICE_NAME par le nom d’un device de stockage sur le même nœud de stockage. Par exemple, utiliser le premier nœud de stockage du Installer et configurer les nœuds de stockage avec le device de stockage ``/dev/sdb``et un poids de 100 :

# swift-ring-builder object.builder add \
  --region 1 --zone 1 --ip 10.0.0.51 --port 6000 --device sdb --weight 100

Répéter cette commande pour chaque device de stockage sur chaque nœud de stockage. Dans l’exemple d’architecture, utiliser la commande de quatre façons différentes :

# swift-ring-builder object.builder add \
  --region 1 --zone 1 --ip 10.0.0.51 --port 6000 --device sdb --weight 100
Device d0r1z1-10.0.0.51:6000R10.0.0.51:6000/sdb_"" with 100.0 weight got id 0
# swift-ring-builder object.builder add \
  --region 1 --zone 1 --ip 10.0.0.51 --port 6000 --device sdc --weight 100
Device d1r1z2-10.0.0.51:6000R10.0.0.51:6000/sdc_"" with 100.0 weight got id 1
# swift-ring-builder object.builder add \
  --region 1 --zone 2 --ip 10.0.0.52 --port 6000 --device sdb --weight 100
Device d2r1z3-10.0.0.52:6000R10.0.0.52:6000/sdb_"" with 100.0 weight got id 2
# swift-ring-builder object.builder add \
  --region 1 --zone 2 --ip 10.0.0.52 --port 6000 --device sdc --weight 100
Device d3r1z4-10.0.0.52:6000R10.0.0.52:6000/sdc_"" with 100.0 weight got id 3

Vérifier les contenus des anneaux :

# swift-ring-builder object.builder
object.builder, build version 4
1024 partitions, 3.000000 replicas, 1 regions, 2 zones, 4 devices, 100.00 balance, 0.00 dispersion
The minimum number of hours before a partition can be reassigned is 1
The overload factor is 0.00% (0.000000)
Devices:    id  region  zone      ip address  port  replication ip  replication port      name weight partitions balance meta
             0       1     1       10.0.0.51  6000       10.0.0.51              6000      sdb  100.00          0 -100.00
             1       1     1       10.0.0.51  6000       10.0.0.51              6000      sdc  100.00          0 -100.00
             2       1     2       10.0.0.52  6000       10.0.0.52              6000      sdb  100.00          0 -100.00
             3       1     2       10.0.0.52  6000       10.0.0.52              6000      sdc  100.00          0 -100.00

Ré-équiliber l’anneau :

# swift-ring-builder object.builder rebalance
Reassigned 1024 (100.00%) partitions. Balance is now 0.00.  Dispersion is now 0.00

Distribuer les fichiers de configuration d’anneau :¶

Copier les fichiers account.ring.gz, container.ring.gz, et object.ring.gz dans le répertoire /etc/swift sur chaque nœud de stockage et tout nœud additionnel faisant tourner le service proxy.