docs: Added guide for distributed minio on Windows (#3507)

master
koolhead17 8 years ago committed by Harshavardhana
parent 2f4a7483ea
commit f37f56ac15
  1. 64
      docs/docker/README.md

@ -1,51 +1,95 @@
# Minio Docker Quickstart Guide [![Gitter](https://badges.gitter.im/Join%20Chat.svg)](https://gitter.im/minio/minio?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge) # Minio Docker Quickstart Guide [![Gitter](https://badges.gitter.im/Join%20Chat.svg)](https://gitter.im/minio/minio?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
## 1. Test Minio on Docker. ## 1. Prerequisites
### GNU/Linux
Install Docker for GNU/Linux from [here](https://www.docker.com/products/docker#/linux)
### Microsoft Windows
Install Docker for Windows from [here](https://www.docker.com/products/docker#/windows)
### macOS
Install Docker for macOS from [here](https://www.docker.com/products/docker#/mac)
## 2. Test Minio on Docker.
Minio generates new access and secret keys each time you run this command. Container state is lost after you end this session. This mode is only intended for testing purpose. Minio generates new access and secret keys each time you run this command. Container state is lost after you end this session. This mode is only intended for testing purpose.
```sh ```sh
docker run -p 9000:9000 minio/minio server /export docker run -p 9000:9000 minio/minio server /export
``` ```
## 2. Run Minio Standalone on Docker. ## 3. Run Minio Standalone on Docker.
Minio container requires a persistent volume to store configuration and application data. Following command maps local persistent directories from the host OS to virtual config `~/.minio` and export `/export` directories. Minio container requires a persistent volume to store configuration and application data. Following command maps local persistent directories from the host OS to virtual config `~/.minio` and export `/export` directories.
```sh ### GNU/Linux and macOS
```sh
docker run -p 9000:9000 --name minio1 \ docker run -p 9000:9000 --name minio1 \
-v /mnt/export/minio1:/export \ -v /mnt/export/minio1:/export \
-v /mnt/config/minio1:/root/.minio \ -v /mnt/config/minio1:/root/.minio \
minio/minio server /export minio/minio server /export
```
### Microsoft Windows
```sh
docker run -p 9000:9000 --name minio1 \
-v D:\export\minio1:/export \
-v D:\export\minio1-config:/root/.minio \
minio/minio server /export
``` ```
## 3. Run Minio Standalone on Docker with Custom Access and Secret Keys ## 4. Run Minio Standalone on Docker with Custom Access and Secret Keys
To override Minio's auto-generated keys, you may pass secret and access keys explicitly as environment variables. Minio server also allows regular strings as access and secret keys. To override Minio's auto-generated keys, you may pass secret and access keys explicitly as environment variables. Minio server also allows regular strings as access and secret keys.
```sh ### GNU/Linux and macOS
```sh
docker run -p 9000:9000 --name minio1 \ docker run -p 9000:9000 --name minio1 \
-e "MINIO_ACCESS_KEY=AKIAIOSFODNN7EXAMPLE" \ -e "MINIO_ACCESS_KEY=AKIAIOSFODNN7EXAMPLE" \
-e "MINIO_SECRET_KEY=wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY" \ -e "MINIO_SECRET_KEY=wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY" \
-v /mnt/export/minio1:/export \ -v /mnt/export/minio1:/export \
-v /mnt/config/minio1:/root/.minio \ -v /mnt/config/minio1:/root/.minio \
minio/minio server /export minio/minio server /export
```
### Microsoft Windows
```sh
docker run -p 9000:9000 --name minio1 \
-e "MINIO_ACCESS_KEY=AKIAIOSFODNN7EXAMPLE" \
-e "MINIO_SECRET_KEY=wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY" \
-v D:\export\minio1:/export \
-v D:\export\minio1-config:/root/.minio \
minio/minio server /export
``` ```
## 4. Test Distributed Minio on Docker ## 5. Test Distributed Minio on Docker
This example shows how to run 4 node Minio cluster inside different docker containers using [docker-compose](https://docs.docker.com/compose/). Please download [docker-compose.yml](https://raw.githubusercontent.com/minio/minio/master/docs/docker/docker-compose.yml) to your current working directory, docker-compose pulls the Minio Docker image. This example shows how to run 4 node Minio cluster inside different docker containers using [docker-compose](https://docs.docker.com/compose/). Please download [docker-compose.yml](https://raw.githubusercontent.com/minio/minio/master/docs/docker/docker-compose.yml) to your current working directory, docker-compose pulls the Minio Docker image.
### Run `docker-compose`
#### Run `docker-compose` on GNU/Linux and macOS
```sh ```sh
docker-compose pull docker-compose pull
docker-compose up docker-compose up
``` ```
Each instance is accessible on the host at ports 9001 through 9004, proceed to access the Web browser at http://localhost:9001/ #### Run `docker-compose.exe` on Microsoft Windows
```sh
docker-compose.exe pull
docker-compose.exe up
```
Each instance is accessible on the host at ports 9001 through 9004, proceed to access the Web browser at http://127.0.0.1:9001/
## 6. Explore Further
* [Minio Erasure Code QuickStart Guide](https://docs.minio.io/docs/minio-erasure-code-quickstart-guide)
* [Distributed Minio Quickstart Guide ](https://docs.minio.io/docs/distributed-minio-quickstart-guide)
* [Docker Compose](https://docs.docker.com/compose/)

Loading…
Cancel
Save