Ubuntu 24.04
Sponsored Link

OpenStack Dalmatian : How to use Swift2024/10/14

 

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          | e644cb550f1545b8a98ae322545bf53a |
| 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          | cb626175861140ba91032d1d008298fe |
| name        | swiftoperator                    |
| options     | {}                               |
+-------------+----------------------------------+

# add a user

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

+---------------------+----------------------------------+
| Field               | Value                            |
+---------------------+----------------------------------+
| default_project_id  | e644cb550f1545b8a98ae322545bf53a |
| domain_id           | default                          |
| email               | None                             |
| enabled             | True                             |
| id                  | f906588cf57b4d0aa5bf474f96cefb58 |
| 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] )
ubuntu@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)\$ '
ubuntu@client:~$
chmod 600 ~/keystonerc_swift

ubuntu@client:~$
source ~/keystonerc_swift

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

ubuntu@client ~(swift)$
swift stat

               Account: AUTH_518e84756a424c8080928411c4bd94e8
            Containers: 0
               Objects: 0
                 Bytes: 0
          Content-Type: text/plain; charset=utf-8
           X-Timestamp: 1729211711.72565
       X-Put-Timestamp: 1729211711.72565
                  Vary: Accept
            X-Trans-Id: txfb7644b4f0c24fb294b3c-006711ad3f
X-Openstack-Request-Id: txfb7644b4f0c24fb294b3c-006711ad3f
[4] Create a Container for saving files.
ubuntu@client ~(swift)$
openstack container create test-container

+------------------------------+----------------+------------------------------+
| account                      | container      | x-trans-id                   |
+------------------------------+----------------+------------------------------+
| AUTH_e644cb550f1545b8a98ae32 | test-container | txd0807738939e464d895f3-     |
| 2545bf53a                    |                | 00670c91bc                   |
+------------------------------+----------------+------------------------------+

ubuntu@client ~(swift)$
openstack container list

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

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

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

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

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

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

ubuntu@client ~(swift)$
total 8
-rw------- 1 ubuntu ubuntu 286 Oct 14 03:32 keystonerc_swift
-rw-rw-r-- 1 ubuntu ubuntu   9 Oct 14 03:37 testfile.txt
[7] Delete a file on Swift Storage.
ubuntu@client ~(swift)$
openstack object delete test-container testfile.txt

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

# [testfile.txt] has been removed

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

ubuntu@client ~(swift)$
openstack container list

# [test-container] has been removed
Matched Content