summaryrefslogtreecommitdiff
path: root/doc/source/getting_started.rst
blob: cde52221f805406862a997ff9f6f8e6329aa64dc (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
===============
Getting Started
===============

-------------------
System Requirements
-------------------

Swift development currently targets Ubuntu Server 22.04, but should work on
most Linux platforms.

Swift is written in Python and has these dependencies:

* Python (2.7 or 3.6-3.10)
* rsync 3.x
* `liberasurecode <https://opendev.org/openstack/liberasurecode/>`__
* The Python packages listed in `the requirements file <https://github.com/openstack/swift/blob/master/requirements.txt>`__
* Testing additionally requires `the test dependencies <https://github.com/openstack/swift/blob/master/test-requirements.txt>`__
* Testing requires `these distribution packages <https://github.com/openstack/swift/blob/master/bindep.txt>`__

-----------
Development
-----------

To get started with development with Swift, or to just play around, the
following docs will be useful:

* :doc:`Swift All in One <development_saio>` - Set up a VM with Swift installed
* :doc:`Development Guidelines <development_guidelines>`
* :doc:`First Contribution to Swift <first_contribution_swift>`
* :doc:`Associated Projects <associated_projects>`

--------------------------
CLI client and SDK library
--------------------------

There are many clients in the :ref:`ecosystem <application-bindings>`. The official CLI
and SDK is python-swiftclient.

* `Source code <https://opendev.org/openstack/python-swiftclient>`__
* `Python Package Index <https://pypi.org/project/python-swiftclient>`__

----------
Production
----------

If you want to set up and configure Swift for a production cluster, the
following doc should be useful:

* :doc:`Multiple Server Swift Installation <howto_installmultinode>`