Creating the Swift cluster starts the Swift services and generates the necessary nodes.

Important: In VMware Integrated OpenStack 7.3, Swift is provided as a technical preview only. Running production workloads is not currently supported.

Prerequisites

  • Ensure that you have sufficient resources available to deploy Swift. The resources required depend on the scale of your deployment.
  • Ensure that all hosts in the Swift cluster use a shared datastore (vSAN or NFS). Local datastores are not supported for Swift.
  • Verify that all datastores included in the Swift cluster are available to all controller nodes in your deployment.

Procedure

  1. Log in to the Integrated OpenStack Manager as the root user.
    ssh root@mgmt-server-ip
  2. In a text editor, create the Swift cluster configuration file in YAML format.

    The configuration file must define three Swift nodes. Use the following template:

    ---
    nodes:
    - datastore: node1-datastore
      disk_size: node1-disksize-GB
      name: node1-name
      zone: node1-zone
    - datastore: node2-datastore
      disk_size: node2-disksize-GB
      name: node2-name
      zone: node2-zone
    - datastore: node3-datastore
      disk_size: node3-disksize-GB
      name: node3-name
      zone: node3-zone
    Option Description

    node-datastore

    Enter the name of the datastore for the specified Swift node.

    node-disksize-GB

    Enter the desired disk size in gigabytes.

    node-name

    Enter a name for the specified Swift node. The name of each node must be unique.

    node-zone

    Enter the Swift zone number for the specified Swift node. The zone number must be an integer.

  3. Create the Swift cluster using the configuration file defined in the previous step.
    viocli create swift -f swift-config-file

Results

The pods required for your Swift cluster are created and the service is enabled.

What to do next

To scale out your cluster, see Add Nodes to Your Swift Cluster.

To delete your Swift cluster, run the viocli delete swift command.