minio-api

README

MINIO-API

API to manage Minio IAM users and Servers
Explore the docs »

Table of Contents

• About the Project
  • Built With
• Getting Started
  • Prerequisites
  • Installation
  • Dockerize Minio-api
• Configuration
• API Reference

About The Project

Minio-api is a simple admin REST API for minio s3 server. The API manages the same features and resources that AWS IAM applies but oficial MINIO API doesn't support: groups, policies, users, keys.

Built With

Minio-api was made ♥ based on:

• GO
• Docker

Getting Started

To get Minio-API as a local copy up and running follow these simple example steps below.

Prerequisites

Before running minio-api, install golang and docker acconding to your OS.

Installation

1. Clone the repo:

git clone https://github.com/aminueza/minio-api.git

1. Build MINIO-API project:

go build main.go

1. Run MINIO-API project:

./main

1. Testing MINIO-API project:

curl -X GET http://localhost:8080/api/v1/version

Dockerize Minio-api

There is a Dockerfile and a Docker-Compose to run MINIO-API. Run it:

docker-compose -f docker-compose.yml up

Configuration

Variable	Description	Default
API_HOST_PORT	which host and port API should listening. Docker and Kubernetes must listening on 0.0.0.0:8080	localhost:8080
MINIO_HOST_PORT	provide a minio server host and port	localhost:9000
MINIO_SSL	enable or disable ssl	false
MINIO_REGION	set minio region	us-east-1
MINIO_ACCESS	set minio Access Key	minio
MINIO_SECRET	set minio Secret Key	minio123

API Reference

• TO-DO