s3manager-web/README.md
2020-05-27 23:28:36 +02:00

1.8 KiB

S3 Manager

Go Report Card Build Status Docker Build

A Web GUI written in Go to manage S3 buckets from any provider.

Screenshot

Usage

Configuration

The application can be configured with the following environment variables:

  • ENDPOINT: The endpoint of your S3 server (defaults to s3.amazonaws.com)
  • ACCESS_KEY_ID: Your S3 access key ID (required)
  • SECRET_ACCESS_KEY: Your S3 secret access key (required)
  • USE_SSL: Whether your S3 server uses SSL or not (defaults to true)
  • PORT: The port the s3manager app should listen on (defaults to 8080)

Build and Run Locally

  1. Run make build
  2. Execute the created binary and visit http://localhost:8080

Deploy to Cloud Foundry

  1. Modify deployments/cf/* to your liking
  2. Run make deploy-cf

Development

Lint Code

  1. Run make lint

Run Tests

  1. Run make test

Build Docker Image

The image is available on Docker Hub

  1. Run make build-docker

Run Locally for Testing

There is an example docker-compose.yml file that spins up an S3 service and the s3manager. You can try it by issuing the following command:

$ docker-compose up