Author: |
Camptocamp,Odoo Community Association (OCA) |
License: |
AGPL-3 |
Branch: |
merge-branch-2477-12.0.0.1.0 |
Repository: |
grindtildeath/odoo-cloud-platform |
Dependencies: |
base,
and
base_attachment_object_storage |
Languages: |
Python (198, 86.8%),
and
reStructuredText (30, 13.2%) |
Other branches: |
10.0,
10.0_dev_attachments,
11.0,
11.0-fix_auth_to_keystone_v3,
11.0_dev_attachments,
12.0,
12.0-fix-base_fileurl_field_demo_test,
12.0-fix-typeerror_resource_bucket_name,
12.0-fix_auth_to_keystone_v3,
12.0_add_base_fileurl_field,
12.0_attachment_s3_add_set_acl,
12.0_attachment_s3_bin_size_close,
12.0_attachment_s3_connection_params,
12.0_base_fileurl_acl_slot,
12.0_boto3,
12.0_context_storage,
12.0_dev_s3_attachments,
12.0_hostname_scheme,
12.0_improvements,
13.0-fix_auth_to_keystone_v3,
13.0-mig-base_attachment_object_storage,
13.0_dev_attachments,
13.0_fix_travis_version,
7.0-fix_auth_to_keystone_v3,
7.0_swift_use_specific_container,
8.0-fix_auth_to_keystone_v3,
9.0,
9.0-fix_auth_to_keystone_v3,
9.0_dev_attachments,
bscloudfr-7_fix_auth_to_keystone_v3,
merge-branch-1305-master,
merge-branch-1955-12.0-04330cea,
merge-branch-1955-12.0-b19bf503,
merge-branch-1955-13_initialize_branch_v12-06a09553,
merge-branch-2176-11.0.0,
merge-branch-2176-11.0.1,
merge-branch-2176-11.0.3,
merge-branch-2176-11.1.0,
merge-branch-2176-11.2.0,
merge-branch-2176-master,
merge-branch-2221-fix-swift-14021d9d,
merge-branch-2221-ovh-56-qty-received-scenario-8d7505aa,
merge-branch-2221-update_submodules_for_travis-9fd09271,
merge-branch-2258-12.1.1,
merge-branch-2258-12.1.2,
merge-branch-2258-add_odoo_cloud_platform-3acc3ca7,
merge-branch-2258-master,
merge-branch-2477-12.0.1.0.0,
merge-branch-2477-12.0.1.1.0,
merge-branch-2477-12.0.1.2.0,
merge-branch-2477-12.0.1.2.1,
merge-branch-2477-master-266b01e9,
merge-branch-559-gste-44-89edcceb,
and
merge-branch-559-gste-44-b88ff338 |
Other repositories: |
ERPLibre/odoo-cloud-platform,
GSLabIt/odoo-cloud-platform,
MjAbuz/odoo-cloud-platform,
NCS-75/odoo-cloud-platform,
PCatinean/odoo-cloud-platform,
RL-OtherApps/odoo-cloud-platform,
TelmoSenseFly/odoo-cloud-platform,
Tonow-c2c/odoo-cloud-platform,
Wiserby/odoo-cloud-platform,
acarmisc/odoo-cloud-platform,
acsone/odoo-cloud-platform,
agrista/odoo-cloud-platform,
akretion/odoo-cloud-platform,
ap-wtioit/odoo-cloud-platform,
asiellb/odoo-cloud-platform,
avoinsystems/odoo-cloud-platform,
camptocamp/odoo-cloud-platform,
celm1990/odoo-cloud-platform,
cialuo/odoo-cloud-platform,
difra/odoo-cloud-platform,
exosoftware/c2c-odoo-cloud-platform,
guewen/odoo-cloud-platform,
gurneyalex/odoo-cloud-platform,
hibou-io/camptocamp-cloud-platform,
ircodoo/odoo-cloud-platform,
itsalgeria/odoo-cloud-platform,
junariltd/odoo-cloud-platform,
leemannd/odoo-cloud-platform,
loftwah/odoo-cloud-platform,
modoolar/odoo-cloud-platform,
mohamed-helmy/odoo-cloud-platform,
mudismud/odoo-cloud-platform,
oondeo/odoo-cloud-platform,
p-tombez/odoo-cloud-platform,
pasgou/odoo-cloud-platform,
paulpwo/odoo-cloud-platform,
royalline1/odoo-cloud-platform,
sadeqamin/odoo-cloud-platform,
sbidoul/odoo-cloud-platform,
sebalix/odoo-cloud-platform,
sebastienbeau/odoo-cloud-platform,
simahawk/odoo-cloud-platform,
sm2x/odoo-cloud-platform,
smussie/odoo-cloud-platform,
suningwz/odoo-cloud-platform,
tate11/odoo-cloud-platform,
tirix/odoo-cloud-platform,
tschanzt/odoo-cloud-platform,
ursais/odoo-cloud-platform-1,
vidtsin/odoo-cloud-platform,
vrenaville/odoo-cloud-platform,
wahello/odoo-cloud-platform,
xuanox/odoo-cloud-platform,
yvaucher/odoo-cloud-platform,
and
zakiuu/odoo-cloud-platform |
<h1 class="title">Attachments on S3 storage</h1>
<p>This addon allows to store the attachments (documents and assets) on S3 or any
other S3-compatible Object Storage.</p>
<a name="configuration"></a>
<h2>Configuration</h2>
<p>Activate S3 storage:</p>
<ul class="simple">
<li>Create or set the system parameter with the key <code>ir_attachment.location</code>
and the value in the form <code>s3</code>.</li>
</ul>
<p>Configure accesses with environment variables:</p>
<ul class="simple">
<li><code>AWS_HOST</code> (not required if using AWS services)</li>
<li><code>AWS_REGION</code> (required if using AWS services)</li>
<li><code>AWS_ACCESS_KEY_ID</code></li>
<li><code>AWS_SECRET_ACCESS_KEY</code></li>
<li><code>AWS_BUCKETNAME</code></li>
</ul>
<p>Read-only mode:</p>
<p>The bucket and the file key are stored in the attachment. So if you change the
<code>AWS_BUCKETNAME</code> or the <code>ir_attachment.location</code>, the existing attachments
will still be read on their former bucket. But as soon as they are written over
or new attachments are created, they will be created on the new bucket 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_s3</code></p>
<a name="limitations"></a>
<h2>Limitations</h2>
<ul class="simple">
<li>You need to call <code>env['ir.attachment'].force_storage()</code> after
having changed the <code>ir_attachment.location</code> configuration in order to
migrate the existing attachments to S3.</li>
</ul>