<h1 class="title">Attachments on Swift storage</h1> <p>This addon enable storing attachments (documents and assets) on OpenStack Object Storage (Swift)</p> <a name="configuration"></a> <h2>Configuration</h2> <p>Activate Swift storage:</p> <ul class="simple"> <li>Create or set the system parameter with the key <code>ir_attachment.location</code> with the following value <code>swift</code>.</li> </ul> <p>Configure accesses with environment variables:</p> <ul class="simple"> <li><code>SWIFT_AUTH_URL</code> : URL of the Swift server</li> <li><code>SWIFT_TENANT_NAME</code> : <strong>!</strong> DEPRECATED <strong>!</strong> Use <code>SWIFT_PROJECT_NAME</code> instead</li> <li><code>SWIFT_PROJECT_NAME</code></li> <li><code>SWIFT_ACCOUNT</code></li> <li><code>SWIFT_PASSWORD</code></li> <li><code>SWIFT_REGION_NAME</code> : optional region</li> <li><code>SWIFT_WRITE_CONTAINER</code> : Name of the container to use in the store (created if not existing)</li> </ul> <p>Read-only mode:</p> <p>The container name and the key are stored in the attachment. So if you change the <code>SWIFT_WRITE_CONTAINER</code> or the <code>ir_attachment.location</code>, the existing attachments will still be read on their former container. But as soon as they are written over or new attachments are created, they will be created on the new container or on the other location (db or filesystem). This is a convenient way to be able to read the production attachments on a replication (since you have the credentials) without any risk to alter the production data.</p> <p>This addon must be added in the server wide addons with (<code>--load</code> option):</p> <p><code>--load=web,attachment_swift</code></p> <p>The System Parameter <code>ir_attachment.storage.force.database</code> can be customized to force storage of files in the database. See the documentation of the module <code>base_attachment_object_storage</code>.</p> <a name="python-dependencies"></a> <h2>Python Dependencies</h2> <p>This module needs the python-swiftclient and the python-keystoneclient (For auth v3.0) to work. The python-keystoneclient needs the linux package build-essential and python-dev to install properly.</p> <p>The python-swiftclient can be used from the command line, useful to test:</p> <pre> <code lang="sh">export AUTH_VERSION=3.0 export OS_USERNAME={SWIFT_ACCOUNT} export OS_PASSWORD={SWIFT_PASSWORD} export OS_PROJECT_NAME={SWIFT_PROJECT_NAME} export OS_REGION_NAME={SWIFT_REGION_NAME} export OS_AUTH_URL=https://auth.cloud.ovh.net/v3 swift stat</code> </pre> <p>More information at <a class="reference external" href="https://docs.openstack.org/python-swiftclient/latest/cli/index.html#swift-usage">https://docs.openstack.org/python-swiftclient/latest/cli/index.html#swift-usage</a></p>