docs: Added guide for distributed minio on Windows (#3507)
parent
2f4a7483ea
commit
f37f56ac15
@ -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…
Reference in new issue