oyd
/
minio
6
1
Fork 0
Code Issues Pull Requests Releases Wiki Activity
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
4016 Commits
1 Branch
0 Tags
89 MiB
 
 
 
 
 
 
Tag: Branch: Tree: 051f9bb5c6
Branches Tags
${ item.name }
Create tag ${ searchTerm }
Create branch ${ searchTerm }
from '051f9bb5c6'
${ noResults }
minio/docs/orchestration/docker-swarm
History
Nitish Tiwari 03937e7554
Added documentation for orchestration platforms (#3684) 		8 years ago
..
README.md Added documentation for orchestration platforms (#3684) 8 years ago
docker-compose.yaml Added documentation for orchestration platforms (#3684) 8 years ago

README.md

Deploy Minio on Docker Swarm Slack Go Report Card Docker Pulls codecov

Docker Engine provides cluster management and orchestration features in Swarm mode. Minio server can be easily deployed in distributed mode on Swarm to create a multi-tenant, highly-available and scalable object store.

As of Docker Engine v1.13.0 (Docker Compose v3.0), Docker Swarm and Compose are cross-compatible. This allows a Compose file to be used as a template to deploy services on Swarm. We have used a Docker Compose file to create distributed Minio setup.

1. Prerequisites

2. Create a Swarm

SSH into the machine supposed to serve as Swarm manager. If the machine is named manager, you can SSH by

docker-machine ssh manager

After logging in to the designated manager node, create the Swarm by

docker swarm init --advertise-addr <MANAGER-IP>

After the manager is up, add worker nodes to the Swarm. Find detailed steps to create the Swarm on Docker documentation site.

3. Deploy distributed Minio services

Download the Docker Compose file on your Swarm master. Then execute the command

docker stack deploy --compose-file=docker-compose.yaml minio_stack

This deploys services described in the Compose file as Docker stack minio_stack. Look up the docker stack command reference for more info.

After the stack is successfully deployed, you should be able to access Minio server via Minio Client mc or your browser at http://[Node_Public_IP_Address]:[Expose_Port_on_Host]

4. Remove distributed Minio services

Remove the distributed Minio services and related network by

docker stack rm minio_stack

Notes

  • By default the Docker Compose file uses the Docker image for latest Minio server release. You can change the image tag to pull a specific Minio Docker image.

  • There are 4 minio distributed instances created by default. You can add more Minio services (upto total 16) to your Minio Swarm deployment. To add a deployment

    • Replicate a service definition and change the name of the new service appropriately.
    • Add a volume in volumes section, and update volume section in the service accordingly.
    • Update the command section in each service. Specifically, add the drive location to be used as storage on the new service.
    • Update the port number to exposed for the new service.

    Read more about distributed Minio here.

  • By default the services use local volume driver. Refer to Docker documentation to explore further options.

  • Minio services in the Docker compose file expose ports 9001 to 9004. This allows multiple services to run on a host. Explore other configuration options in Docker documentation.

  • Docker Swarm uses ingress load balancing by default. You can configure external load balancer based on requirements.

Explore Further