This adds swift-specific contents from the OpenStack Installation Guide in the swift repo per [1]. A separate change will remove the swift contents from the OpenStack Installation Guide for Newton per [2]. The swift install-guide structure is based on the Install Guide Cookiecutter [3]. Also adds tox.ini environment for install-guide and adds openstackdocs-theme to test-requirements.txt. [1] http://specs.openstack.org/openstack/docs-specs/specs/newton/project-specific-installguides.html [2] http://specs.openstack.org/openstack/docs-specs/specs/newton/installguide.html [3] http://git.openstack.org/cgit/openstack/installguide-cookiecutter/ Change-Id: I59b92eebaf5acc657b97bcf10d9ff2cf2db05885 Partially-Implements: blueprint projectspecificinstallguides Depends-On: Ifebc65b188c4f2ba35b61c0deae5ec24401df7f9
1.9 KiB
Object Storage service overview
The OpenStack Object Storage is a multi-tenant object storage system. It is highly scalable and can manage large amounts of unstructured data at low cost through a RESTful HTTP API.
It includes the following components:
- Proxy servers (swift-proxy-server)
-
Accepts OpenStack Object Storage API and raw HTTP requests to upload files, modify metadata, and create containers. It also serves file or container listings to web browsers. To improve performance, the proxy server can use an optional cache that is usually deployed with memcache.
- Account servers (swift-account-server)
-
Manages accounts defined with Object Storage.
- Container servers (swift-container-server)
-
Manages the mapping of containers or folders, within Object Storage.
- Object servers (swift-object-server)
-
Manages actual objects, such as files, on the storage nodes.
- Various periodic processes
-
Performs housekeeping tasks on the large data store. The replication services ensure consistency and availability through the cluster. Other periodic processes include auditors, updaters, and reapers.
- WSGI middleware
-
Handles authentication and is usually OpenStack Identity.
- swift client
-
Enables users to submit commands to the REST API through a command-line client authorized as either a admin user, reseller user, or swift user.
- swift-init
-
Script that initializes the building of the ring file, takes daemon names as parameter and offers commands. Documented in http://docs.openstack.org/developer/swift/admin_guide.html#managing-services.
- swift-recon
-
A cli tool used to retrieve various metrics and telemetry information about a cluster that has been collected by the swift-recon middleware.
- swift-ring-builder
-
Storage ring build and rebalance utility. Documented in http://docs.openstack.org/developer/swift/admin_guide.html#managing-the-rings.