koddr / do-spaces-microservice

🧺 Microservice for upload, remove and list objects to/from your DigitalOcean Spaces. Production-ready, zero configuration, working out of the box!

🧺 Microservice for DigitalOcean Spaces

   

Upload, remove and list objects to/from your CDN. Production-ready, zero configuration, working out of the box!

⚡️ Quick start

Sign in to your DigitalOcean account.

Don't have an account yet? Join DigitalOcean at our referral link! Your profit is $100 and we get $25. This will allow you not to think about paying for Spaces for 10 months, and we will send the money received to support the Komentory project servers.

Next, create your own Spaces and upload folder with permissions. Go to the Spaces access keys section at the Manage Keys page and create a new keys. Save them to a notepad for later!

OK, now we're ready to click this button:

After that, please fill all of the following environment variables (all variables are required):

Choose name of your web service (which will be displayed in the Spaces URL, like https://your-web-service.ondigitalocean.app), region and a Basic plan ($5/mo) for start. Click to Launch Basic App and get our congratulations.

You have successfully deployed microservice to DigitalOcean! 🎉

📖 Next steps

Open your favorite REST API tool and send requests:

• GET /v1/list (get all objects from upload folder)
  • Request body (JSON): none
• PUT /v1/upload (put object to upload folder)
  • Request body (JSON): { "type": "<TYPE>", "path": "<PATH/TO/FILE>" }
  • Supported types: archive, audio, document, image, video
• DELETE /v1/remove (delete object from upload folder by object key)
  • Request body (JSON): { "key": "<OBJECT_KEY>", "version_id": "<ID>" }

⚠️ License

do-spaces-microservice is free and open-source software licensed under the Apache 2.0 License.