CentOS Stream 9
Sponsored Link

OpenStack Caracal : How to use Swift2024/08/07

 

This section shows how to use Swift Storage from Clients.

This example is based on the environment like follows.

------------+--------------------------+------------
            |                          |
        eth0|10.0.0.30             eth0|10.0.0.50
+-----------+-----------+  +-----------+-----------+
|   [ dlp.srv.world ]   |  | [ network.srv.world ] |
|     (Control Node)    |  |      (Proxy Node)     |
|                       |  |                       |
|  MariaDB    RabbitMQ  |  |      Swift Proxy      |
|  Memcached  Nginx     |  |         Nginx         |
|  Keystone   httpd     |  |                       |
+-----------------------+  +-----------------------+

------------+--------------------------+--------------------------+-----------
        eth0|10.0.0.71             eth0|10.0.0.72             eth0|10.0.0.73
+-----------+-----------+  +-----------+-----------+  +-----------+-----------+
|  [snode01.srv.world]  |  |  [snode02.srv.world]  |  |  [snode03.srv.world]  |
|    (Storage Node#1)   |  |    (Storage Node#2)   |  |    (Storage Node#3)   |
|                       |  |                       |  |                       |
|     Swift-Account     |  |     Swift-Account     |  |     Swift-Account     |
|    Swift-Container    |  |    Swift-Container    |  |    Swift-Container    |
|     Swift-Object      |  |     Swift-Object      |  |     Swift-Object      |
+-----------------------+  +-----------------------+  +-----------------------+

[1] Add a user for using Swift on Keystone Control Node.
By the way, if you'd like to use Swift Quickly, it's unnecessary to add a new user, it's possible to use with existing admin or swift user on Keystone.
# create [swiftservice] project

[root@dlp ~(keystone)]#
openstack project create --domain default --description "Swift Service Project" swiftservice

+-------------+----------------------------------+
| Field       | Value                            |
+-------------+----------------------------------+
| description | Swift Service Project            |
| domain_id   | default                          |
| enabled     | True                             |
| id          | edd13cc63f624e998ae2a40e7d6e3ae4 |
| is_domain   | False                            |
| name        | swiftservice                     |
| options     | {}                               |
| parent_id   | default                          |
| tags        | []                               |
+-------------+----------------------------------+

# create [SwiftOperator] role

[root@dlp ~(keystone)]#
openstack role create SwiftOperator

+-------------+----------------------------------+
| Field       | Value                            |
+-------------+----------------------------------+
| description | None                             |
| domain_id   | None                             |
| id          | 81da06f3716a440b84cf6f9614132995 |
| name        | SwiftOperator                    |
| options     | {}                               |
+-------------+----------------------------------+

# add a user

[root@dlp ~(keystone)]#
openstack user create --domain default --project swiftservice --password userpassword swiftuser01

+---------------------+----------------------------------+
| Field               | Value                            |
+---------------------+----------------------------------+
| default_project_id  | edd13cc63f624e998ae2a40e7d6e3ae4 |
| domain_id           | default                          |
| enabled             | True                             |
| id                  | 08a7dfaa61204ca4b993012265af01ea |
| name                | swiftuser01                      |
| options             | {}                               |
| password_expires_at | None                             |
+---------------------+----------------------------------+

# add the user to [SwiftOperator] role

[root@dlp ~(keystone)]#
openstack role add --project swiftservice --user swiftuser01 SwiftOperator
[2] Work on a Client Host from here and later.
Install Keystoneclient, Swiftclient on a Client Host first.
# install from Caracal, EPEL, CRB

[root@client ~]#
dnf --enablerepo=centos-openstack-caracal,epel,crb -y install python3-openstackclient python3-keystoneclient python3-swiftclient
[3] Login as any user and load environment variables. ( it's just the value for a user added in [1] )
[cent@client ~]$
vi ~/keystonerc_swift
export OS_PROJECT_DOMAIN_NAME=Default
export OS_USER_DOMAIN_NAME=Default
export OS_PROJECT_NAME=swiftservice
export OS_USERNAME=swiftuser01
export OS_PASSWORD=userpassword
export OS_AUTH_URL=https://dlp.srv.world:5000
export OS_IDENTITY_API_VERSION=3
export PS1='[\u@\h \W(swift)]\$ '
[cent@client ~]$
chmod 600 ~/keystonerc_swift

[cent@client ~]$
source ~/keystonerc_swift

[cent@client ~(swift)]$
echo "source ~/keystonerc_swift " >> ~/.bash_profile
# show status

[cent@client ~(swift)]$
swift stat

               Account: AUTH_edd13cc63f624e998ae2a40e7d6e3ae4
            Containers: 0
               Objects: 0
                 Bytes: 0
          Content-Type: text/plain; charset=utf-8
           X-Timestamp: 1723011667.26050
       X-Put-Timestamp: 1723011667.26050
                  Vary: Accept
            X-Trans-Id: tx306afaaac68a414680184-0066b31253
X-Openstack-Request-Id: tx306afaaac68a414680184-0066b31253
[4] Create a Container for saving files.
[cent@client ~(swift)]$
openstack container create test-container

+---------------------------------------+----------------+------------------------------------+
| account                               | container      | x-trans-id                         |
+---------------------------------------+----------------+------------------------------------+
| AUTH_edd13cc63f624e998ae2a40e7d6e3ae4 | test-container | tx910a026e1a1f4525a48e0-0066b31268 |
+---------------------------------------+----------------+------------------------------------+

[cent@client ~(swift)]$
openstack container list

+----------------+
| Name           |
+----------------+
| test-container |
+----------------+
[5] Upload a file on localhost to the Container.
[cent@client ~(swift)]$
echo testfile > testfile.txt

[cent@client ~(swift)]$
openstack object create test-container testfile.txt

+--------------+----------------+----------------------------------+
| object       | container      | etag                             |
+--------------+----------------+----------------------------------+
| testfile.txt | test-container | e9409172a4036cc688f169c72131e921 |
+--------------+----------------+----------------------------------+

[cent@client ~(swift)]$
openstack object list test-container

+--------------+
| Name         |
+--------------+
| testfile.txt |
+--------------+
[6] Download a file from Swift Storage to localhost.
[cent@client ~(swift)]$
rm testfile.txt
[cent@client ~(swift)]$
openstack object save test-container testfile.txt

[cent@client ~(swift)]$
total 16
-rw-------. 1 cent cent    9 Aug  7 10:00 keystonerc_swift
-rw-r--r--. 1 cent cent    9 Aug  7 15:23 testfile.txt
[7] Delete a file on Swift Storage.
[cent@client ~(swift)]$
openstack object delete test-container testfile.txt

[cent@client ~(swift)]$
openstack object list test-container

# [testfile.txt] has been removed

[8] Delete a Container on Swift Storage.
[cent@client ~(swift)]$
openstack container delete test-container

[cent@client ~(swift)]$
openstack container list

# [test-container] has been removed
Matched Content