openstack/swift
Code Issues Proposed changes

Merge "Update SAIO document"

Browse Source
This commit is contained in:
Zuul
2025-06-25 01:55:38 +00:00
committed by Gerrit Code Review
parent 5698934098 89ad202f73
commit b2a0d96f6d
1 changed files with 30 additions and 39 deletions
Download Patch File Download Diff File Expand all files Collapse all files

69
doc/source/development_saio.rst
View File

@@ -20,8 +20,8 @@ cluster. To begin:
* Get a Linux system server image, this guide will cover: * Get a Linux system server image, this guide will cover:
* Ubuntu 14.04, 16.04 LTS * Ubuntu 24.04 LTS
* CentOS 7 * CentOS Stream 9
* Fedora * Fedora
* OpenSuse * OpenSuse
@@ -57,50 +57,46 @@ Installing dependencies
sudo apt-get update sudo apt-get update
sudo apt-get install curl gcc memcached rsync sqlite3 xfsprogs \ sudo apt-get install curl gcc memcached rsync sqlite3 xfsprogs \
git-core libffi-dev python-setuptools \ git-core libffi-dev python3-setuptools \
liberasurecode-dev libssl-dev liberasurecode-dev libssl-dev
sudo apt-get install python-coverage python-dev python-nose \ sudo apt-get install python3-coverage python3-dev python3-pytest \
python-xattr python-eventlet \ python3-xattr python3-eventlet \
python-greenlet python-pastedeploy \ python3-greenlet python3-pastedeploy \
python-netifaces python-pip python-dnspython \ python3-pip python3-dnspython
python-mock
* On ``CentOS`` (requires additional repositories):: * On ``CentOS`` (requires additional repositories)::
sudo yum update sudo dnf update
sudo yum install epel-release sudo dnf install epel-release
sudo yum-config-manager --enable epel extras sudo dnf config-manager --enable epel extras
sudo yum install centos-release-openstack-train sudo dnf install centos-release-openstack-epoxy
sudo yum install curl gcc memcached rsync sqlite xfsprogs git-core \ sudo dnf install curl gcc memcached rsync-daemon sqlite xfsprogs git-core \
libffi-devel xinetd liberasurecode-devel \ libffi-devel liberasurecode-devel \
openssl-devel python-setuptools \ openssl-devel python3-setuptools \
python-coverage python-devel python-nose \ python3-coverage python3-devel python3-pytest \
pyxattr python-eventlet \ python3-pyxattr python3-eventlet \
python-greenlet python-paste-deploy \ python3-greenlet python3-paste-deploy \
python-netifaces python-pip python-dns \ python3-pip python3-dns
python-mock
* On ``Fedora``:: * On ``Fedora``::
sudo dnf update sudo dnf update
sudo dnf install curl gcc memcached rsync-daemon sqlite xfsprogs git-core \ sudo dnf install curl gcc memcached rsync-daemon sqlite xfsprogs git-core \
libffi-devel liberasurecode-devel python-pyeclib \ libffi-devel liberasurecode-devel python3-pyeclib \
openssl-devel python-setuptools \ openssl-devel python3-setuptools \
python-coverage python-devel python-nose \ python3-coverage python3-devel python3-pytest \
python-pyxattr python-eventlet \ python3-pyxattr python3-eventlet \
python-greenlet python-paste-deploy \ python3-greenlet python3-paste-deploy \
python-netifaces python-pip python-dns \ python3-pip python3-dns
python-mock
* On ``OpenSuse``:: * On ``OpenSuse``::
sudo zypper install curl gcc memcached rsync sqlite3 xfsprogs git-core \ sudo zypper install curl gcc memcached rsync sqlite3 xfsprogs git-core \
libffi-devel liberasurecode-devel python2-setuptools \ libffi-devel liberasurecode-devel python3-setuptools \
libopenssl-devel libopenssl-devel
sudo zypper install python2-coverage python-devel python2-nose \ sudo zypper install python3-coverage python3-devel python3-nose \
python-xattr python-eventlet python2-greenlet \ python3-xattr python3-eventlet python3-greenlet \
python2-netifaces python2-pip python2-dnspython \ python3-pip python3-dnspython
python2-mock
.. note:: .. note::
This installs necessary system dependencies and *most* of the python This installs necessary system dependencies and *most* of the python
@@ -291,12 +287,7 @@ Getting the code
#. Build a development installation of python-swiftclient:: #. Build a development installation of python-swiftclient::
cd $HOME/python-swiftclient; sudo python setup.py develop; cd - cd $HOME/python-swiftclient; sudo python3 setup.py develop; cd -
Ubuntu 12.04 users need to install python-swiftclient's dependencies before the installation of
python-swiftclient. This is due to a bug in an older version of setup tools::
cd $HOME/python-swiftclient; sudo pip install -r requirements.txt; sudo python setup.py develop; cd -
#. Check out the Swift repo:: #. Check out the Swift repo::
@@ -749,7 +740,7 @@ Testing Swift
curl -v -H 'X-Auth-Token: <token-from-x-auth-token-above>' <url-from-x-storage-url-above> curl -v -H 'X-Auth-Token: <token-from-x-auth-token-above>' <url-from-x-storage-url-above>
#. Check that ``swift`` command provided by the python-swiftclient package works:: #. Check that the ``swift`` command provided by python-swiftclient works::
swift -A http://127.0.0.1:8080/auth/v1.0 -U test:tester -K testing stat swift -A http://127.0.0.1:8080/auth/v1.0 -U test:tester -K testing stat