This project is a File Upload backend designed to be plug and play(just pull the docker image and deploy). I built it as a step to ease workload for developers building MircroServices.

Kindly leave a star and share so others who may find it useful.

Feel free to open issues and leave PRs.

Table of Contents

• PreRequisites
• Setup
  • Setup for S3
  • Setup for Cloudinary
• Usage
• Testing
• TODOs
• NOTE

PreRequisites

• Cloudinary Account (Optional)
  • CLOUDINARY_API_ENVIRONMENT_VARIABLE
  • CLOUDINARY_API_SECRET
• AWS S3 Account(Optional)
  • AWS_ACCESS_KEY_ID
  • AWS_SECRET_ACCESS_KEY
  • AWS_REGION
• MongoDB URL(Required)
• Docker Installed on Server/Local Machine

Setup

• Setup environment variables. See env.example

  • Setup for Cloudinary

    • Get Cloudinary API Environment variable and API Secret
      • https://cloudinary.com/documentation/how_to_integrate_cloudinary#1_create_and_set_up_your_account
    • Add keys to .env file

  • Setup for S3

    • Get AWS Access Keys
      • https://aws.github.io/aws-sdk-go-v2/docs/getting-started#get-your-aws-access-keys
    • Add keys to .env file

Usage

• docker pull brymes/reusable-file-upload-service:stable
• docker run --platform=linux/amd64 --env-file .env reusable-file-upload-service
• Kindly find the Postman API Documentation at this link

Testing

• WIP

TODOs

• Unit tests
• CallBack URLs
• Add new services
  • Azure Blob Storage
  • Google Cloud Storage
• Authentication workflow (A POC for how to use in a Microservice Environent)
• Empty upload folder after upload complete
• Consider using goroutines to perform uploads in background
• Error management with Sentry or similar/ distributing logs
• Eager transformations for Cloudinary

NOTE

Tags always get parsed as strings