Add local S3 support with MinIO (#54)

* build: add MinIO to services

* docs: added documentation for MinIO

* style: lint fixes

* update: Moved MinIO from services to tools.

* docs: edited docs to be inline with current document pattern.

* update: Changed ports to avoid conflicting with Xdebug.

* docs: Changed ports to avoid conflicting with Xdebug.

---------

Co-authored-by: Chris Reed <[email protected]>

Author: chrisr-st

.gitignore

@@ -1,3 +1,5 @@
 .DS_Store
 .idea
+docker/data-source-tools/storage
+docker/data-source-tools/storage/*
 

README.md

@@ -37,6 +37,7 @@ cd ./devop-tools/docker/data-source-services && docker-compose up --build -d
 * Optionally included is the following tools:
   * phpMyAdmin
   * Mailpit
+  * MinIO
 
 ```bash
 cd ./devop-tools/docker/data-source-tools && docker-compose up --build -d
@@ -62,6 +63,23 @@ _For mimicking an email inbox (ala mailtrap) for local usage._
   * `MAIL_PASSWORD=null`
   * `MAIL_ENCRYPTION=null`
 
+### MinIO
+_For running an S3 service locally._
+
+* Edit the `/etc/hosts` file on your system and make a reference for `127.0.0.1 s3.docker`
+* Open the admin console http://s3.docker:10001 and login.
+  * username: root
+  * password: password
+* Create an appropriate bucket for each project as needed.
+* Modify the project's `.env` as follows:
+  * `FILESYSTEM_DRIVER=s3`
+  * `AWS_ACCESS_KEY_ID=root`
+  * `AWS_SECRET_ACCESS_KEY=password`
+  * `AWS_DEFAULT_REGION=us-east-1`
+  * `AWS_BUCKET=[project-bucket-name]`
+  * `AWS_ENDPOINT=http://s3.docker:10000`
+  * `AWS_USE_PATH_STYLE_ENDPOINT=true`
+
 ---
 
 ## Scripts

docker/data-source-tools/docker-compose.yml

@@ -13,6 +13,21 @@ services:
       MP_MAX_MESSAGES: 5000
       MP_SMTP_AUTH_ACCEPT_ANY: 1
       MP_SMTP_AUTH_ALLOW_INSECURE: 1
+  minio:
+    hostname: s3.docker
+    image: minio/minio:latest
+    container_name: sourcetoad_minio
+    ports:
+      - "10000:10000"
+      - "10001:10001"
+    volumes:
+      - ./storage/data:/data
+    environment:
+      - MINIO_ROOT_USER=root
+      - MINIO_ROOT_PASSWORD=password
+    command: server /data/ --address :10000 --console-address :10001
+    networks:
+      - st-internal
   phpmyadmin:
     image: phpmyadmin/phpmyadmin:latest
     container_name: sourcetoad_phpmyadmin