From 0d0f09ee66a1ca2c1e86d9fec1beffc5a6c33cb8 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E9=A3=9E=E9=9B=AA=E6=97=A0=E6=83=85?= Date: Wed, 29 Jul 2020 00:08:22 +0800 Subject: [PATCH] update and improve zh_CN readme documentation (#10145) --- README_zh_CN.md | 116 ++++++++++++++++++++++++++++++++++++++++++------ 1 file changed, 103 insertions(+), 13 deletions(-) diff --git a/README_zh_CN.md b/README_zh_CN.md index 65d66bca8..a7369c10e 100644 --- a/README_zh_CN.md +++ b/README_zh_CN.md @@ -7,29 +7,33 @@ MinIO是一个非常轻量的服务,可以很简单的和其他应用的结合 ## Docker 容器 ### 稳定版 ``` -docker pull minio/minio -docker run -p 9000:9000 minio/minio server /data +docker run -p 9000:9000 \ + -e "MINIO_ACCESS_KEY=AKIAIOSFODNN7EXAMPLE" \ + -e "MINIO_SECRET_KEY=wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY" \ + minio/minio server /data ``` ### 尝鲜版 ``` -docker pull minio/minio:edge -docker run -p 9000:9000 minio/minio:edge server /data +docker run -p 9000:9000 \ + -e "MINIO_ACCESS_KEY=AKIAIOSFODNN7EXAMPLE" \ + -e "MINIO_SECRET_KEY=wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY" \ + minio/minio:edge server /data ``` -更多Docker部署信息请访问 [这里](https://docs.min.io/docs/minio-docker-quickstart-guide) + +> 提示：除非你通过`-it`(TTY交互)参数启动容器，否则Docker将不会显示默认的密钥。一般情况下，并不推荐使用容器的默认密钥，更多Docker部署信息请访问 [这里](https://docs.min.io/docs/minio-docker-quickstart-guide) ## macOS -### Homebrew +### Homebrew（推荐） 使用 [Homebrew](http://brew.sh/)安装minio ```sh brew install minio/stable/minio minio server /data ``` -#### Note -如果你之前使用 `brew install minio`安装过minio, 可以用 `minio/stable/minio` 官方镜像进行重装. 由于golang 1.8的bug,homebrew版本不太稳定。 -``` +> 提示：如果你之前使用 `brew install minio`安装过minio, 可以用 `minio/stable/minio` 官方镜像进行重装. 由于golang 1.8的bug,homebrew版本不太稳定。 +```sh brew uninstall minio brew install minio/stable/minio ``` @@ -49,6 +53,16 @@ chmod 755 minio | ---------- | -------- | ------ | | GNU/Linux | 64-bit Intel | https://dl.min.io/server/minio/release/linux-amd64/minio | ```sh +wget https://dl.min.io/server/minio/release/linux-amd64/minio +chmod +x minio +./minio server /data +``` + +| 操作系统 | CPU架构 | 地址 | +| ---------- | -------- | ------ | +| GNU/Linux | ppc64le | https://dl.min.io/server/minio/release/linux-ppc64le/minio | +```sh +wget https://dl.min.io/server/minio/release/linux-ppc64le/minio chmod +x minio ./minio server /data ``` @@ -64,7 +78,7 @@ minio.exe server D:\Photos ## FreeBSD ### Port -使用 [pkg](https://github.com/freebsd/pkg)进行安装。 +使用 [pkg](https://github.com/freebsd/pkg)进行安装，, MinIO官方并没有提供FreeBSD二进制文件， 它由FreeBSD上游维护，点击 [这里](https://www.freshports.org/www/minio)查看。 ```sh pkg install minio @@ -75,14 +89,68 @@ service minio start ## 使用源码安装 -采用源码安装仅供开发人员和高级用户使用,如果你还没有Golang环境， 请参考 [How to install Golang](https://golang.org/doc/install). +采用源码安装仅供开发人员和高级用户使用,如果你还没有Golang环境， 请参考 [How to install Golang](https://golang.org/doc/install)。最低需要Golang版本为 [go1.13](https://golang.org/dl/#stable) + +```sh +GO111MODULE=on go get github.com/minio/minio +``` + +## 为防火墙设置允许访问的端口 + +默认情况下，MinIO 使用端口9000来侦听传入的连接。如果你的平台默认阻止了该端口，则需要启用对该端口的访问。 + +### ufw + +对于启用了ufw的主机（基于Debian的发行版）, 你可以通过`ufw`命令允许指定端口上的所有流量连接. 通过如下命令允许访问端口9000 + +```sh +ufw allow 9000 +``` + +如下命令允许端口9000-9010上的所有传入流量。 + +```sh +ufw allow 9000:9010/tcp +``` + +### firewall-cmd + +对于启用了firewall-cmd的主机（CentOS）, 你可以通过`firewall-cmd`命令允许指定端口上的所有流量连接。 通过如下命令允许访问端口9000 ```sh -go get -u github.com/minio/minio +firewall-cmd --get-active-zones +``` + +这个命令获取当前正在使用的区域。 现在，就可以为以上返回的区域应用端口规则了。 假如返回的区域是 `public`, 使用如下命令 + +```sh +firewall-cmd --zone=public --add-port=9000/tcp --permanent +``` + +这里的`permanent`参数表示持久化存储规则，可用于防火墙启动、重启和重新加载。 最后，需要防火墙重新加载，让我们刚刚的修改生效。 + +```sh +firewall-cmd --reload +``` + +### iptables + +对于启用了iptables的主机（RHEL, CentOS, etc）, 你可以通过`iptables`命令允许指定端口上的所有流量连接。 通过如下命令允许访问端口9000 + +```sh +iptables -A INPUT -p tcp --dport 9000 -j ACCEPT +service iptables restart +``` + +如下命令允许端口9000-9010上的所有传入流量。 + +```sh +iptables -A INPUT -p tcp --dport 9000:9010 -j ACCEPT +service iptables restart ``` ## 使用MinIO浏览器进行验证 -安装后使用浏览器访问[http://127.0.0.1:9000](http://127.0.0.1:9000)，如果可以访问，则表示minio已经安装成功。 +MinIO Server带有一个嵌入的Web对象浏览器，安装后使用浏览器访问[http://127.0.0.1:9000](http://127.0.0.1:9000)，如果可以访问，则表示minio已经安装成功。 ![Screenshot](https://github.com/minio/minio/blob/master/docs/screenshots/minio-browser.png?raw=true) @@ -94,6 +162,25 @@ go get -u github.com/minio/minio 上述描述对所有网关后端同样有效。 +## 升级 MinIO +MinIO 服务端支持滚动升级, 也就是说你可以一次更新分布式集群中的一个MinIO实例。 这样可以在不停机的情况下进行升级。可以通过将二进制文件替换为最新版本并以滚动方式重新启动所有服务器来手动完成升级。但是, 我们建议所有用户从客户端使用 [`mc admin update`](https://docs.min.io/docs/minio-admin-complete-guide.html#update) 命令升级。 这将同时更新集群中的所有节点并重新启动它们, 如下命令所示: + +``` +mc admin update +``` + +> 注意: 有些发行版可能不允许滚动升级，这通常在发行说明中提到，所以建议在升级之前阅读发行说明。在这种情况下，建议使用`mc admin update`升级机制来一次升级所有服务器。 + +### MinIO升级时要记住的重要事项 + +- `mc admin update` 命令仅当运行MinIO的用户对二进制文件所在的父目录具有写权限时才工作, 比如当前二进制文件位于`/usr/local/bin/minio`, 你需要具备`/usr/local/bin`目录的写权限. +- `mc admin update` 命令同时更新并重新启动所有服务器，应用程序将在升级后重试并继续各自的操作。 +- `mc admin update` 命令在 kubernetes/container 环境下是不能用的, 容器环境提供了它自己的更新机制来更新。 +- 对于联盟部署模式，应分别针对每个群集运行`mc admin update`。 在成功更新所有群集之前，不要将`mc`更新为任何新版本。 +- 如果将`kes`用作MinIO的KMS，只需替换二进制文件并重新启动`kes`，可以在 [这里](https://github.com/minio/kes/wiki) 找到有关`kes`的更多信息。 +- 如果将Vault作为MinIO的KMS，请确保已遵循如下Vault升级过程的概述：https://www.vaultproject.io/docs/upgrading/index.html +- 如果将MindIO与etcd配合使用, 请确保已遵循如下etcd升级过程的概述: https://github.com/etcd-io/etcd/blob/master/Documentation/upgrades/upgrading-etcd.md + ## 了解更多 - [MinIO纠删码入门](https://docs.min.io/docs/minio-erasure-code-quickstart-guide) - [`mc`快速入门](https://docs.min.io/docs/minio-client-quickstart-guide) @@ -104,3 +191,6 @@ go get -u github.com/minio/minio ## 如何参与到MinIO项目 请参考 [贡献者指南](https://github.com/minio/minio/blob/master/CONTRIBUTING.md)。欢迎各位中国程序员加到MinIO项目中。 + +## 授权许可 +MinIO的使用受 Apache 2.0 License 约束，你可以在 [LICENSE](./LICENSE) 查看许可。