From d49868a97f7a5586077d21643997397fe9011a84 Mon Sep 17 00:00:00 2001
From: Michele Cereda <cereda.michele@gmail.com>
Date: Thu, 21 Nov 2024 00:49:57 +0100
Subject: [PATCH] feat(ansible): work with aws s3

---
 knowledge base/ansible.md  |  2 ++
 snippets/ansible/tasks.yml | 18 ++++++++++++++++++
 2 files changed, 20 insertions(+)

diff --git a/knowledge base/ansible.md b/knowledge base/ansible.md
index 9731ba4..f34b828 100644
--- a/knowledge base/ansible.md	
+++ b/knowledge base/ansible.md	
@@ -1485,6 +1485,7 @@ Solution: use a version of `ansible-core` lower than 2.17.
 - [Ansible Vault with AWX]
 - [Asynchronous actions and polling]
 - [Patterns: targeting hosts and groups]
+- [How to use ansible with S3 - Ansible aws_s3 examples]
 
 <!--
   Reference
@@ -1547,6 +1548,7 @@ Solution: use a version of `ansible-core` lower than 2.17.
 [how to recursively set directory and file permissions]: https://superuser.com/questions/1024677/ansible-how-to-recursively-set-directory-and-file-permissions#1317715
 [how to set up and use python virtual environments for ansible]: https://www.redhat.com/sysadmin/python-venv-ansible
 [how to speed up ansible playbooks drastically?]: https://www.linkedin.com/pulse/how-speed-up-ansible-playbooks-drastically-lionel-gurret
+[how to use ansible with s3 - ansible aws_s3 examples]: https://www.middlewareinventory.com/blog/ansible-aws_s3-example/
 [how to work with lists and dictionaries in ansible]: https://www.redhat.com/sysadmin/ansible-lists-dictionaries-yaml
 [human-readable output format]: https://www.shellhacks.com/ansible-human-readable-output-format/
 [include task only if file exists]: https://stackoverflow.com/questions/28119521/ansible-include-task-only-if-file-exists#comment118578470_62289639
diff --git a/snippets/ansible/tasks.yml b/snippets/ansible/tasks.yml
index b1d627f..7392fa3 100644
--- a/snippets/ansible/tasks.yml
+++ b/snippets/ansible/tasks.yml
@@ -796,6 +796,24 @@
             resource: i-xyzxyz01
             tags:
               MyNewTag: value
+    - name: Check S3 object exists
+      amazon.aws.s3_object_info:
+        bucket_name: my-bucket
+        object_name: prefix/object.tar
+    - name: Download objects from S3
+      # The 'amazon.aws.s3_object' module might be *not* suitable here as at the time of writing it stores downloaded
+      # data in memory before flushing it to disk, filling the host's memory up when downloading big files
+      amazon.aws.s3_object:
+        bucket: my-bucket
+        object: prefix/object.tar
+        dest: /tmp/object.tar
+        mode: get
+    - name: Upload objects to S3
+      amazon.aws.s3_object:
+        bucket: my-bucket
+        object: prefix/object.tar
+        src: /tmp/object.tar
+        mode: put
     - name: EC2-specific operations
       block:
         - name: Get running instances with 'K8S' as the 'Application' tag