Friday, December 5, 2025

OpenStack Epoxy : How to use Swift

OpenStack Epoxy : How to use Swift

 

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          | ea5ee4b3cdbd4bbaa832f1eb9ece4598 |
| is_domain   | False                            |
| name        | swiftservice                     |
| options     | {}                               |
| parent_id   | default                          |
| tags        | []                               |
+-------------+----------------------------------+

# create [swiftoperator] role

root@dlp ~(keystone)# 
openstack role create swiftoperator

+-------------+----------------------------------+
| Field       | Value                            |
+-------------+----------------------------------+
| id          | a5c1b36ac7c0485b9e564a97954fe5b8 |
| name        | swiftoperator                    |
| domain_id   | None                             |
| description | None                             |
+-------------+----------------------------------+

# add a user

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

+---------------------+----------------------------------+
| Field               | Value                            |
+---------------------+----------------------------------+
| default_project_id  | ea5ee4b3cdbd4bbaa832f1eb9ece4598 |
| domain_id           | default                          |
| email               | None                             |
| enabled             | True                             |
| id                  | dc6eed5b379d48b6934666e5353c4128 |
| name                | swiftuser01                      |
| description         | None                             |
| 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 from here and later.
Install Keystoneclient, Swiftclient on a Client first.
root@client:~# 
apt -y install python3-openstackclient python3-keystoneclient python3-swiftclient
[3]Load environment variables first. ( it's the value for a user added in [1] )
debian@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/v3
export OS_IDENTITY_API_VERSION=3
export PS1='\u@\h \W(swift)\$ '
debian@client:~$ 
chmod 600 ~/keystonerc_swift

debian@client:~$ 
source ~/keystonerc_swift

ubuntu@client ~(swift)$ 
echo "source ~/keystonerc_swift " >> ~/.bash_profile
# verify status

ubuntu@client ~(swift)$ 
swift stat

               Account: AUTH_7f02de02c70a4c7c8f95eb5c86201869
            Containers: 0
               Objects: 0
                 Bytes: 0
          Content-Type: text/plain; charset=utf-8
           X-Timestamp: 1756694779.75885
       X-Put-Timestamp: 1756694779.75885
                  Vary: Accept
            X-Trans-Id: txab8d9878d04a4853b15ae-0068b508fb
X-Openstack-Request-Id: txab8d9878d04a4853b15ae-0068b508fb
[4]Create a Container for saving files.
debian@client ~(swift)$ 
openstack container create test-container

+------------------------------+----------------+------------------------------+
| account                      | container      | x-trans-id                   |
+------------------------------+----------------+------------------------------+
| AUTH_7f02de02c70a4c7c8f95eb5 | test-container | txe9aa8f1cc0a44a7d8bf4e-     |
| c86201869                    |                | 0068b50913                   |
+------------------------------+----------------+------------------------------+

debian@client ~(swift)$ 
openstack container list

+----------------+
| Name           |
+----------------+
| test-container |
+----------------+
[5]Upload a file on local to the Container.
# upload [testfile.txt]

debian@client ~(swift)$ 
echo testfile > testfile.txt

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

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

debian@client ~(swift)$ 
openstack object list test-container

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

debian@client ~(swift)$ 
total 8
-rw------- 1 debian debian 286 Sep  1 11:46 keystonerc_swift
-rw-rw-r-- 1 debian debian   9 Sep  1 11:49 testfile.txt
[7]Delete a file on Swift Storage.
debian@client ~(swift)$ 
openstack object delete test-container testfile.txt

debian@client ~(swift)$ 
openstack object list test-container

# [testfile.txt] has been removed

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

debian@client ~(swift)$ 
openstack container list

# [test-container] has been removed
Matched Content

No comments:

Post a Comment