Skip to content

[stable17] Add example Swift v3 scope #2006

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
MorrisJobke merged 1 commit into from
Apr 21, 2020
Merged

[stable17] Add example Swift v3 scope #2006

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
60 changes: 47 additions & 13 deletions admin_manual/configuration_files/primary_storage.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -41,12 +41,12 @@ The configuration has the following structure:

::

'objectstore' => array(
'objectstore' => [
'class' => 'Object\\Storage\\Backend\\Class',
'arguments' => array(
'arguments' => [
...
),
),
],
],

~~~~~~~~~~~~~~~
OpenStack Swift
Expand All @@ -57,11 +57,15 @@ server into the virtual filesystem.

The class to be used is :code:`\\OC\\Files\\ObjectStore\\Swift`

Both openstack v2 and v3 authentication are supported,

V2 Authentication:

::

'objectstore' => array(
'objectstore' => [
'class' => '\\OC\\Files\\ObjectStore\\Swift',
'arguments' => array(
'arguments' => [
'username' => 'username',
'password' => 'Secr3tPaSSWoRdt7',
// the container to store the data in
Expand All @@ -75,8 +79,38 @@ The class to be used is :code:`\\OC\\Files\\ObjectStore\\Swift`
'serviceName' => 'swift',
// The Interface / url Type, optional
'urlType' => 'internal'
),
),
],
],

V3 Authentication:

::

'objectstore' => [
'class' => 'OC\\Files\\ObjectStore\\Swift',
'arguments' => [
'autocreate' => true,
'user' => [
'name' => 'swift',
'password' => 'Secr3tPaSSWoRdt7',
'domain' => [
'name' => 'Default',
],
],
'scope' => [
'project' => [
'name' => 'OS_PROJECT_NAME',
'domain' => [
'name' => 'Default',
],
],
],
'serviceName' => 'swift',
'region' => 'regionOne',
'url' => 'http://example.com/v3',
'bucket' => 'nextcloud',
],
],

~~~~~~~~~~~~~~~~~~~~~~~~~~~
Simple Storage Service (S3)
Expand All @@ -90,9 +124,9 @@ The class to be used is :code:`\\OC\\Files\\ObjectStore\\S3`

::

'objectstore' => array(
'objectstore' => [
'class' => '\\OC\\Files\\ObjectStore\\S3',
'arguments' => array(
'arguments' => [
'bucket' => 'nextcloud',
'autocreate' => true,
'key' => 'EJ39ITYZEUH5BGWDRUFY',
Expand All @@ -103,8 +137,8 @@ The class to be used is :code:`\\OC\\Files\\ObjectStore\\S3`
'region' => 'optional',
// required for some non Amazon S3 implementations
'use_path_style'=>true
),
),
],
],

.. note:: Not all configuration options are required for all S3 servers. Overriding
the hostname, port and region of your S3 server is only required for
Expand All @@ -123,4 +157,4 @@ Multibucket Object Store
It's possible to configure Nextcloud to distribute its data over multiple buckets
for scalability purpose. You can find out more information about upscaling with
object storage and Nextcloud in the
`Nextcloud customer portal <https://portal.nextcloud.com/article/object-store-as-primary-storage-16.html>`_.
`Nextcloud customer portal <https://portal.nextcloud.com/article/object-store-as-primary-storage-16.html>`_.