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. |
|
[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)]$
[cent@client ~(swift)]$ rm testfile.txt
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
|
| Sponsored Link |