Search 1.9 billion lines of Odoo code on GitHub
ir_attachment_s3
<a class="reference external image-reference" href="https://itpp.dev"><img alt="Tested and maintained by IT Projects Labs" src="https://itpp.dev/images/infinity-readme.png" /></a>
<a name="s3-attachment-storage"></a>
<h2>S3 Attachment Storage</h2>
<ul class="simple">
<li>The module allows to upload the attachments in Amazon S3 automatically without storing them in Odoo database. It will allow to reduce the load on your server. Attachments will be uploaded on S3 depending on the condition you specified in Odoo settings. So you can choose and manage which type of attachments should be uploaded on S3.</li>
<li>It is useful in cases where your database was crashed, because you will be able to easily restore all attachments from external storage at any time.</li>
<li>The possibility to use one external storage for any number of databases.</li>
</ul>
<a name="roadmap"></a>
<h3>Roadmap</h3>
<ul class="simple">
<li>In settings add options:<ul>
<li>condition, if object in s3 must be stored as public (as it does now)</li>
<li>condition, if object in s3 must be stored as private and think about, how to return it to user, 'cos you cannot use link to that. Possibly read from bucket and return and uncomment this: <a class="reference external" href="https://github.com/it-projects-llc/misc-addons/pull/775/files#r302856876">https://github.com/it-projects-llc/misc-addons/pull/775/files#r302856876</a></li>
<li>how to name a file in s3 storage. As for now it is "odoo/{hash}". Maybe we could add database name to filename</li>
</ul>
</li>
<li>Fix these bugs (possible in ir_attachment_url):<ul>
<li>After loading image url to existing product variant, image does not change in backend</li>
<li>Set image with url, then upload other image as binary file (s3), backend shows old image. It can be fixed with clearing cache. Reason: there is no 'unique' parameter in image source attribute (<img src)</li>
<li>In backend. Set product image as binary file (s3), in product page it shows new image, in product list it shows old image.
Reason: there is no 'unique' parameter in image source attribute (<img src)</li>
<li>Using <cite>website_sale</cite> addon. Upload main image to product variant. Then<ul>
<li>in list of products old image is shown (bug)</li>
<li>in product page main image is shown as main, previous main image is extra (maybe not a bug, but don't know how to remove previous main image)</li>
</ul>
</li>
</ul>
</li>
<li>S3 Condition is ignored in attachment creation</li>
</ul>
<a name="sandbox"></a>
<h3>Sandbox</h3>
<p>To install local minio add following specification to your docker-compose.yml:</p>
<pre>
<code>services:
# ...
minio:
image: minio/minio
networks: *public # for doodba
ports:
- "127.0.0.1:9000:9000"
environment:
MINIO_ACCESS_KEY: "admin"
MINIO_SECRET_KEY: "password"
command:
server /data
volumes:
- s3:/data:z
volumes:
# ...
s3:</code>
</pre>
<p>Add to your <code>/etc/hosts</code> file:</p>
<pre>
<code>127.0.0.1 minio</code>
</pre>
<p>Now make minio publicly accessable:</p>
<ul>
<li><p class="first"><a class="reference external" href="https://docs.min.io/docs/minio-client-complete-guide.html">install minio client</a>, e.g.</p>
<pre>
<code>wget https://dl.min.io/client/mc/release/linux-amd64/mc
chmod +x mc</code>
</pre>
</li>
<li><p class="first">create <em>alias</em></p>
<pre>
<code>./mc alias set local http://minio:9000 admin password</code>
</pre>
</li>
<li><p class="first">create bucket</p>
<pre>
<code>./mc mb local/mybucket</code>
</pre>
</li>
<li><p class="first">set policy</p>
<pre>
<code>./mc policy set public local/mybucket</code>
</pre>
</li>
</ul>
<p>Then set parameters:</p>
<ul class="simple">
<li><code>s3.bucket</code>: <code>mybucket</code></li>
<li><code>s3.access_key_id</code>: <code>admin</code></li>
<li><code>s3.secret_key</code>: <code>password</code></li>
<li><code>s3.endpoint_url</code>: <code>http://minio:9000</code></li>
<li><code>s3.obj_url</code>: <code>http://minio:9000/mybucket/</code></li>
</ul>
<a name="questions"></a>
<h3>Questions?</h3>
<p>To get an assistance on this module contact us by email :arrow_right: <a class="reference external" href="mailto:help@itpp.dev">help@itpp.dev</a></p>
<a name="contributors"></a>
<h3>Contributors</h3>
<ul class="simple">
<li><cite>Ivan Yelizariev <https://twitter.com/yelizariev></cite></li>
<li><cite>Ildar Nasyrov <https://it-projects.info/team/iledarn></cite></li>
<li><cite>Kolushov Alexandr <https://it-projects.info/team/KolushovAlexandr></cite></li>
<li><cite>Dinar Gabbasov <https://it-projects.info/team/GabbasovDinar></cite></li>
<li><cite>Eugene Molotov <https://it-projects.info/team/em230418></cite></li>
</ul>
<hr class="docutils" />
<p>Odoo Apps Store: <a class="reference external" href="https://apps.odoo.com/apps/modules/14.0/ir_attachment_s3/">https://apps.odoo.com/apps/modules/14.0/ir_attachment_s3/</a></p>
<p>Tested on <a class="reference external" href="https://github.com/odoo/odoo/commit/120366491f58a802deef68a17ebb26199ef829a2">Odoo 14.0</a></p>