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) |
||||
|
||||
## 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. |
||||
|
||||
```sh |
||||
|
||||
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. |
||||
|
||||
```sh |
||||
### GNU/Linux and macOS |
||||
|
||||
```sh |
||||
docker run -p 9000:9000 --name minio1 \ |
||||
-v /mnt/export/minio1:/export \ |
||||
-v /mnt/config/minio1:/root/.minio \ |
||||
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. |
||||
|
||||
```sh |
||||
### GNU/Linux and macOS |
||||
|
||||
```sh |
||||
docker run -p 9000:9000 --name minio1 \ |
||||
-e "MINIO_ACCESS_KEY=AKIAIOSFODNN7EXAMPLE" \ |
||||
-e "MINIO_SECRET_KEY=wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY" \ |
||||
-v /mnt/export/minio1:/export \ |
||||
-v /mnt/config/minio1:/root/.minio \ |
||||
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. |
||||
|
||||
### Run `docker-compose` |
||||
|
||||
#### Run `docker-compose` on GNU/Linux and macOS |
||||
|
||||
```sh |
||||
docker-compose pull |
||||
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