Utilisez la commande viocli swift pour gérer les clusters et les nœuds Swift de votre déploiement OpenStack.

La commande viocli swift prend en charge un large éventail d'actions pour effectuer différentes tâches. Les paramètres suivants s'appliquent à toutes les actions.

Paramètre

Obligatoire ou facultatif

Description

-d NAME ou --deployment NAME

Facultatif

Nom du déploiement à utiliser.

Si vous n'entrez pas de valeur, le déploiement par défaut est utilisé.

-p ou --progress

Facultatif

Affiche la progression de l'opération en cours.

--verbose

Facultatif

Affiche le résultat en mode détaillé.

Vous pouvez exécuter viocli swift -h ou viocli swift --help pour afficher les paramètres de la commande. Vous pouvez également utiliser l'option -h ou --help sur toutes les actions pour afficher des paramètres pour l'action. Par exemple, viocli swift create-cluster -h affichera les paramètres de l'action create-cluster.

Les actions prises en charge par la commande viocli swift sont répertoriées comme suit.

viocli swift create-cluster [-d NAME] --cluster-moid MOID --datastores DS1[,DS2...] [--storage-node-count STORAGE-NODES] [--proxy-node-count PROXY-NODES] [--disk-size GB] [--swift-partition-power-count PARTITION-POWER] [--swift-replica-count REPLICAS] [--swift-min-part-hours HOURS] [-f SPEC-FILE] [-p] [--verbose]

Crée un cluster Swift. Les paramètres supplémentaires suivants s'appliquent à l'action create-cluster.

Paramètre

Obligatoire ou facultatif

Description

--cluster-moid

Obligatoire sauf si -f est utilisé.

ID d'objet géré du cluster vSphere.

--datastores

Obligatoire sauf si -f est utilisé.

Banques de données à utiliser pour les nœuds de stockage Swift, séparées par des virgules.

Important:

Swift ne prend pas en charge les clusters de banque de données.

--storage-node-count

Facultatif

Nombre de nœuds de stockage Swift à créer.

Si vous n'entrez pas une valeur, 3 est utilisé par défaut.

--proxy-node-count

Facultatif

Nombre de nœuds de proxy Swift à créer.

Si vous n'entrez pas une valeur, 2 est utilisé par défaut.

--disk-size

Facultatif

Taille du disque en gigaoctets pour les nœuds de stockage Swift.

Si vous n'entrez pas une valeur, 2048 est utilisé par défaut.

--swift-partition-power-count

Facultatif

Puissance de partition de l'anneau Swift. Le nombre de partitions gérés par l'anneau est égal à 2 élevé à la puissance de la partition.

Si vous n'entrez pas une valeur, 10 est utilisé par défaut.

--swift-replica-count

Facultatif

Nombre de réplicas à créer pour les objets stockés dans Swift.

Si vous n'entrez pas une valeur, 3 est utilisé par défaut.

Note:

Le nombre de réplicas ne peut pas dépasser le nombre de nœuds de stockage dans le déploiement.

--swift-min-part-hours

Facultatif

Période en heures au terme de laquelle une partition peut être attribuée à un autre nœud de stockage.

Si vous n'entrez pas une valeur, 1 est utilisé par défaut.

-f ou --json-file

Facultatif

Fichier JSON contenant les paramètres pour créer le cluster Swift.

Le format du fichier JSON est le suivant :

{
        "cluster_moid": "moid",
        "storage_node_number": storage-nodes,
        "proxy_node_number": proxy-nodes,
        "ring_settings": {
                "swift_replica_count": replicas,
                "swift_min_part_hours": hours,
                "swift_partition_power_count": power
        },
        "storage_settings": [
                {
                        "datastore_name": "ds1",
                        "zone_number": ds1-zone,
                        "disk_size": ds1-disk-gb
                }
        ]
}

Effectuez une copie du contenu de la section storage_settings pour chaque nœud de stockage que vous souhaitez créer.

Si vous n'utilisez pas de fichier JSON pour créer votre cluster, les numéros de zone sont attribués aux banques de données spécifiées, dans l'ordre. Vous pouvez utiliser le paramètre zone_number du fichier JSON pour attribuer des numéros de zone spécifiques ou pour placer plusieurs banques de données dans la même zone. Une banque de données ne peut pas être placée dans plusieurs zones.

 

viocli swift delete-cluster [-d NAME] [-f] [-p] [--verbose]

Supprime le cluster Swift.

Paramètre

Obligatoire ou facultatif

Description

-f ou --force

Facultatif

Supprime le cluster sans demander de confirmation.

 

viocli swift add-storage [-d NAME] --datastores DS1[,DS2...] [--storage-node-count STORAGE-NODES] [--disk-size GB] [-f SPEC-FILE] [-p] [--verbose]

Ajoute des nœuds de stockage à un cluster Swift existant.

Paramètre

Obligatoire ou facultatif

Description

--datastores

Obligatoire sauf si -f est utilisé.

Banques de données à utiliser pour les nouveaux nœuds de stockage Swift, séparées par des virgules.

Important:

Swift ne prend pas en charge les clusters de banque de données.

--storage-node-count

Facultatif

Nombre de nœuds de stockage Swift à ajouter.

Si vous n'entrez pas une valeur, 1 est utilisé par défaut.

--disk-size

Facultatif

Taille du disque en gigaoctets pour les nouveaux nœuds de stockage Swift.

Si vous n'entrez pas une valeur, 2048 est utilisé par défaut.

-f ou --json-file

Facultatif

Fichier JSON contenant les paramètres pour créer les nœuds de stockage.

Le format du fichier JSON est le suivant :

{
        "storage_node_number": nodes,
        "storage_settings": [
                {
                        "datastore_name": "ds1",
                        "zone_number": ds1-zone,
                        "disk_size": ds1-disk-gb
                }
        ]
}

Effectuez une copie du contenu de la section storage_settings pour chaque nœud de stockage que vous souhaitez créer.

Si vous n'utilisez pas de fichier JSON pour ajouter des nœuds de stockage, les numéros de zone sont attribués aux banques de données spécifiées, dans l'ordre. Vous pouvez utiliser le paramètre zone_number du fichier JSON pour attribuer des numéros de zone spécifiques ou pour placer plusieurs banques de données dans la même zone. Une banque de données ne peut pas être placée dans plusieurs zones.

 

viocli swift add-proxy [-d NAME] [--proxy-node-count PROXY-NODES] [-p] [--verbose]

Ajoute des nœuds de proxy à un cluster Swift existant.

Paramètre

Obligatoire ou facultatif

Description

--proxy-node-count

Facultatif

Nombre de nœuds de proxy Swift à ajouter.

Si vous n'entrez pas une valeur, 1 est utilisé par défaut.

 

viocli swift list-datastore-zone-mapping [-d NAME] [-p] [--verbose]

Affiche toutes les banques de données et les zones dans lesquelles elles se trouvent.