From 3f53154683a17d239fd2ff8a63002872e9221d86 Mon Sep 17 00:00:00 2001 From: Alexander Miller Date: Fri, 20 Oct 2023 11:25:59 +0200 Subject: [PATCH] Add readmes. --- README.adoc | 10 ++++++++++ examples/s3/README.adoc | 11 +++++++++++ 2 files changed, 21 insertions(+) create mode 100644 README.adoc create mode 100644 examples/s3/README.adoc diff --git a/README.adoc b/README.adoc new file mode 100644 index 0000000..81bdaa7 --- /dev/null +++ b/README.adoc @@ -0,0 +1,10 @@ += Cloud Native Testing: AWS Technologies + +This repository contains example code for AWS-based technologies and how to efficiently test them, without necessarily +having access to an actual AWS environment. + +All examples are based on _our_ experience in different actual small and large scale projects. + +== Examples + +** link:examples/s3/[S3] diff --git a/examples/s3/README.adoc b/examples/s3/README.adoc new file mode 100644 index 0000000..3b641ed --- /dev/null +++ b/examples/s3/README.adoc @@ -0,0 +1,11 @@ += AWS: S3 + +This module demonstrates the basics of using and testing the AWS Simple Storage Service. It contains a simple service +that allows you to store and fetch book cover images. You can interact with it locally through IntelliJ's +link:../s3/http/S3.http[http plugin]. + +The module includes examples for how to: + +- Write a reasonable abstraction layer for the S3 sdk +- Locally run an S3 instance with your application thanks to with link:https://localstack.cloud/[LocalStack] +- Write tests which use a locally running S3 instead of a simple mock