提交 0e81cc02 编写于 作者: R Ray Zhou

Update README

上级 038bc790
...@@ -79,7 +79,7 @@ KubeSphere can run anywhere from on-premise datacenter to any cloud to edge. In ...@@ -79,7 +79,7 @@ KubeSphere can run anywhere from on-premise datacenter to any cloud to edge. In
#### Prerequisites #### Prerequisites
- `Kubernetes version``1.15.x, 1.16.x, 1.17.x` - `Kubernetes version``1.15.x, 1.16.x, 1.17.x`
- `Helm version` >= `2.10.0`,see [Install and Configure Helm in Kubernetes](https://devopscube.com/install-configure-helm-kubernetes/), (Helm v3 will be supported in KubeSphere 3.0.0) - `2.10.0 ≤ Helm Version < 3.0.0` excluding 2.16.0 because of [#6894](https://github.com/helm/helm/issues/6894). Please see [Install and Configure Helm in Kubernetes](https://devopscube.com/install-configure-helm-kubernetes/). Helm v3 will be supported in KubeSphere 3.0.0.
- An existing Storage Class in your Kubernetes cluster, use `kubectl get sc` to verify it - An existing Storage Class in your Kubernetes cluster, use `kubectl get sc` to verify it
- The CSR signing feature is activated in kube-apiserver, see [RKE installation issue](https://github.com/kubesphere/kubesphere/issues/1925#issuecomment-591698309). - The CSR signing feature is activated in kube-apiserver, see [RKE installation issue](https://github.com/kubesphere/kubesphere/issues/1925#issuecomment-591698309).
...@@ -97,6 +97,12 @@ kubectl apply -f https://raw.githubusercontent.com/kubesphere/ks-installer/maste ...@@ -97,6 +97,12 @@ kubectl apply -f https://raw.githubusercontent.com/kubesphere/ks-installer/maste
kubectl apply -f https://raw.githubusercontent.com/kubesphere/ks-installer/master/kubesphere-complete-setup.yaml kubectl apply -f https://raw.githubusercontent.com/kubesphere/ks-installer/master/kubesphere-complete-setup.yaml
``` ```
Wait the installation logs using the following command till showing `"Successful"`, then you can log in the console using the default username and password.
```bash
kubectl logs -n kubesphere-system $(kubectl get pod -n kubesphere-system -l app=ks-install -o jsonpath='{.items[0].metadata.name}') -f
```
### Deploy on Linux ### Deploy on Linux
KubeSphere Installer can help you to install KubeSphere and Kubernetes on your linux machines. It provides [All-in-One](https://kubesphere.io/docs/installation/all-in-one/) and [Multi-Node](https://kubesphere.io/docs/installation/multi-node/) installation options. KubeSphere Installer can help you to install KubeSphere and Kubernetes on your linux machines. It provides [All-in-One](https://kubesphere.io/docs/installation/all-in-one/) and [Multi-Node](https://kubesphere.io/docs/installation/multi-node/) installation options.
...@@ -132,7 +138,7 @@ You can enable other components after installation, see [Pluggable Components In ...@@ -132,7 +138,7 @@ You can enable other components after installation, see [Pluggable Components In
## Contributing, Support, Discussion, and Community ## Contributing, Support, Discussion, and Community
This [document](https://github.com/kubesphere/community) walks you through how to get started contributing KubeSphere. This [document](https://github.com/kubesphere/community) walks you through how to get started contributing KubeSphere. The [development guide](https://github.com/kubesphere/community/tree/master/developer-guide/development) explains how to set up development environment.
If you need any help with KubeSphere, please join us at [Slack Channel](https://join.slack.com/t/kubesphere/shared_invite/enQtNTE3MDIxNzUxNzQ0LTZkNTdkYWNiYTVkMTM5ZThhODY1MjAyZmVlYWEwZmQ3ODQ1NmM1MGVkNWEzZTRhNzk0MzM5MmY4NDc3ZWVhMjE). If you need any help with KubeSphere, please join us at [Slack Channel](https://join.slack.com/t/kubesphere/shared_invite/enQtNTE3MDIxNzUxNzQ0LTZkNTdkYWNiYTVkMTM5ZThhODY1MjAyZmVlYWEwZmQ3ODQ1NmM1MGVkNWEzZTRhNzk0MzM5MmY4NDc3ZWVhMjE).
......
# KubeSphere 容器平台 # KubeSphere 容器平台
[![License](http://img.shields.io/badge/license-apache%20v2-blue.svg)](https://github.com/KubeSphere/KubeSphere/blob/master/LICENSE) [![License](http://img.shields.io/badge/license-apache%20v2-blue.svg)](https://github.com/KubeSphere/KubeSphere/blob/master/LICENSE)
[![Build Status](https://travis-ci.org/kubesphere/kubesphere.svg?branch=master)](https://travis-ci.org/kubesphere/kubesphere) [![Build Status](https://travis-ci.org/kubesphere/kubesphere.svg?branch=master)](https://travis-ci.org/kubesphere/kubesphere)
[![KubeSphere release](https://img.shields.io/github/release/kubesphere/kubesphere.svg?color=release&label=release&logo=release&logoColor=release)](https://github.com/kubesphere/kubesphere/releases/tag/v2.1.1) [![KubeSphere release](https://img.shields.io/github/release/kubesphere/kubesphere.svg?color=release&label=release&logo=release&logoColor=release)](https://github.com/kubesphere/kubesphere/releases/tag/v2.1.1)
...@@ -13,22 +14,20 @@ ...@@ -13,22 +14,20 @@
[KubeSphere](https://kubesphere.com.cn) 是在 [Kubernetes](https://kubernetes.io) 之上构建的以**应用为中心的**多租户容器平台,提供全栈的 IT 自动化运维的能力,简化企业的 DevOps 工作流。KubeSphere 提供了运维友好的向导式操作界面,帮助企业快速构建一个强大和功能丰富的容器云平台。KubeSphere 愿景是打造一个基于 Kubernetes 的云原生分布式操作系统,它的架构可以很方便地与云原生生态进行即插即用(plug-and-play)的集成。 [KubeSphere](https://kubesphere.com.cn) 是在 [Kubernetes](https://kubernetes.io) 之上构建的以**应用为中心的**多租户容器平台,提供全栈的 IT 自动化运维的能力,简化企业的 DevOps 工作流。KubeSphere 提供了运维友好的向导式操作界面,帮助企业快速构建一个强大和功能丰富的容器云平台。KubeSphere 愿景是打造一个基于 Kubernetes 的云原生分布式操作系统,它的架构可以很方便地与云原生生态进行即插即用(plug-and-play)的集成。
KubeSphere 目前最新的版本为 2.1.1,所有版本 100% 开源,关于 KubeSphere 更详细的介绍与说明请参阅 [什么是 KubeSphere](https://kubesphere.com.cn/docs/zh-CN/introduction/what-is-kubesphere/)
> 说明:KubeSphere 目前最新的版本为 2.1.1,所有版本 100% 开源,关于 KubeSphere 更详细的介绍与说明请参阅 [什么是 KubeSphere](https://kubesphere.com.cn/docs/zh-CN/introduction/intro/)。
<table> <table>
<tr> <tr>
<td width="50%" align="center"><b>KubeSphere Dashboard</b></td> <td width="50%" align="center"><b>工作台</b></td>
<td width="50%" align="center"><b>Project Resources</b></td> <td width="50%" align="center"><b>项目资源</b></td>
</tr> </tr>
<tr> <tr>
<td><img src="docs/images/console.png"/></td> <td><img src="docs/images/console.png"/></td>
<td><img src="docs/images/project.png"/></td> <td><img src="docs/images/project.png"/></td>
</tr> </tr>
<tr> <tr>
<td width="50%" align="center"><b>CI/CD Pipeline</b></td> <td width="50%" align="center"><b>CI/CD 流水线</b></td>
<td width="50%" align="center"><b>Application Store</b></td> <td width="50%" align="center"><b>应用商店</b></td>
</tr> </tr>
<tr> <tr>
<td><img src="docs/images/cicd.png"/></td> <td><img src="docs/images/cicd.png"/></td>
...@@ -38,13 +37,13 @@ ...@@ -38,13 +37,13 @@
## 快速体验 ## 快速体验
使用体验账号 `demo1 / Demo123` 登录 [Demo 环境](https://demo.kubesphere.io/),该账号仅授予了 viewer 权限,建议自行安装体验完整的管理功能。您还可以访问 Youtube 查看 [KubeSphere Demo 视频](https://youtu.be/u5lQvhi_Xlc) 使用体验账号 `demo1 / Demo123` 登录 [Demo 环境](https://demo.kubesphere.io/),该账号仅授予了 view 权限,建议自行安装体验完整的管理功能。您还可以访问 Youtube 查看 [KubeSphere Demo 视频](https://youtu.be/u5lQvhi_Xlc)
## 架构 ## 架构
KubeSphere 采用了前后端分离的架构设计,后端的各个功能组件可通过 REST API 对接外部系统,详见 [架构说明](https://kubesphere.com.cn/docs/zh-CN/introduction/architecture/)。本仓库仅包含后端代码,前端代码参考 [Console 项目](https://github.com/kubesphere/console) KubeSphere 采用了前后端分离的架构设计,后端的各个功能组件可通过 REST API 对接外部系统,详见 [架构说明](https://kubesphere.com.cn/docs/zh-CN/introduction/architecture/)。本仓库仅包含后端代码,前端代码参考 [Console 项目](https://github.com/kubesphere/console)
![](docs/images/architecture.png) ![Architecture](docs/images/architecture.png)
## 核心功能 ## 核心功能
...@@ -62,8 +61,7 @@ KubeSphere 采用了前后端分离的架构设计,后端的各个功能组件 ...@@ -62,8 +61,7 @@ KubeSphere 采用了前后端分离的架构设计,后端的各个功能组件
| 网络管理 | 支持 Calico、Flannel,提供 Porter LB 插件用于暴露物理环境 K8s 集群的 LoadBalancer 服务 | | 网络管理 | 支持 Calico、Flannel,提供 Porter LB 插件用于暴露物理环境 K8s 集群的 LoadBalancer 服务 |
| GPU support | 集群支持添加 GPU 与 vGPU,可运行 TensorFlow 等 ML 框架 | | GPU support | 集群支持添加 GPU 与 vGPU,可运行 TensorFlow 等 ML 框架 |
以上功能说明详见 [产品功能](https://kubesphere.com.cn/docs/zh-CN/introduction/features/)
> 以上功能说明详见 [产品功能](https://kubesphere.com.cn/docs/zh-CN/introduction/features/)。
---- ----
...@@ -76,16 +74,16 @@ KubeSphere 2.1.1 已于 2020 年 02 月 23 日 正式发布,点击 [Release No ...@@ -76,16 +74,16 @@ KubeSphere 2.1.1 已于 2020 年 02 月 23 日 正式发布,点击 [Release No
### 部署在 Linux ### 部署在 Linux
- 操作系统 - 操作系统
- CentOS 7.5 (64 bit) - CentOS 7.5 (64 bit)
- Ubuntu 16.04/18.04 LTS (64 bit) - Ubuntu 16.04/18.04 LTS (64 bit)
- Red Hat Enterprise Linux Server 7.4 (64 bit) - Red Hat Enterprise Linux Server 7.4 (64 bit)
- Debian Stretch 9.5 (64 bit) - Debian Stretch 9.5 (64 bit)
- 配置规格(最低) - 配置规格(最低)
- CPU:2 Core, 内存:4 G, 硬盘:100 G - CPU:2 Cores, 内存:4 GB, 硬盘:100 GB
#### All-in-One #### All-in-One
执行以下命令下载 Installer,请关闭防火墙或 [开放指定的端口](https://kubesphere.com.cn/docs/v2.1/zh-CN/installation/port-firewall/),建议使用干净的机器并使用 `root` 用户安装: 执行以下命令下载 Installer,请关闭防火墙或 [开放指定的端口](https://kubesphere.com.cn/docs/zh-CN/installation/port-firewall/),建议使用干净的机器并使用 `root` 用户安装:
```bash ```bash
curl -L https://kubesphere.io/download/stable/latest > installer.tar.gz \ curl -L https://kubesphere.io/download/stable/latest > installer.tar.gz \
...@@ -98,24 +96,24 @@ curl -L https://kubesphere.io/download/stable/latest > installer.tar.gz \ ...@@ -98,24 +96,24 @@ curl -L https://kubesphere.io/download/stable/latest > installer.tar.gz \
> 注意:All-in-One 仅适用于**测试环境**,**正式环境** 安装和使用请参考 [安装说明](https://kubesphere.com.cn/docs/zh-CN/installation/intro/)。 > 注意:All-in-One 仅适用于**测试环境**,**正式环境** 安装和使用请参考 [安装说明](https://kubesphere.com.cn/docs/zh-CN/installation/intro/)。
### 部署在已有 Kubernetes 集群上
### 部署在 Kubernetes
可参考 [前提条件](https://kubesphere.com.cn/docs/zh-CN/installation/prerequisites/) 验证是否满足以下条件: 可参考 [前提条件](https://kubesphere.com.cn/docs/zh-CN/installation/prerequisites/) 验证是否满足以下条件:
> - `Kubernetes` 版本: `1.15.x、1.16.x、1.17.x`; #### 前提条件
> - `Helm`版本: `2.10.0 ≤ Helm Version < 3.0.0`(不支持 helm 2.16.0 [#6894](https://github.com/helm/helm/issues/6894)),且已安装了 Tiller,参考 [如何安装与配置 Helm](https://devopscube.com/install-configure-helm-kubernetes/) (预计 3.0 支持 Helm v3);
> - 集群已有默认的存储类型(StorageClass),若还没有准备存储请参考 [安装 OpenEBS 创建 LocalPV 存储类型](../../appendix/install-openebs) 用作开发测试环境。 - `Kubernetes` 版本: `1.15.x、1.16.x、1.17.x`
- `Helm`版本: `2.10.0 ≤ Helm Version < 3.0.0`(不支持 helm 2.16.0 [#6894](https://github.com/helm/helm/issues/6894)),且已安装了 Tiller,参考 [如何安装与配置 Helm](https://devopscube.com/install-configure-helm-kubernetes/) (预计 3.0 支持 Helm v3);
- 集群已有默认的存储类型(StorageClass),若还没有准备存储请参考 [安装 OpenEBS 创建 LocalPV 存储类型](../../appendix/install-openebs) 用作开发测试环境。
用 kubectl 安装
- 若您的集群可用的资源符合 CPU > 1 Core,可用内存 > 2 G,可参考以下命令开启 KubeSphere 最小化安装: - 若您的集群可用的资源符合 CPU >= 1 Core,可用内存 >= 2 G,可参考以下命令开启 KubeSphere 最小化安装。后续如果您的集群资源足够可以参考 [开启可插拔功能功能组件](https://kubesphere.com.cn/docs/zh-CN/installation/pluggable-components/) 按需开启其它功能组件。
```yaml ```yaml
kubectl apply -f https://raw.githubusercontent.com/kubesphere/ks-installer/master/kubesphere-minimal.yaml kubectl apply -f https://raw.githubusercontent.com/kubesphere/ks-installer/master/kubesphere-minimal.yaml
``` ```
请参考 [开启可插拔功能功能组件](https://kubesphere.com.cn/docs/v2.1/zh-CN/installation/pluggable-components/) 按需开启其它功能组件。
- 若您的集群可用的资源符合 CPU ≥ 8 Core,可用内存 ≥ 16 G,建议参考以下命令开启 KubeSphere 完整安装,即开启所有功能组件的安装: - 若您的集群可用的资源符合 CPU ≥ 8 Core,可用内存 ≥ 16 G,建议参考以下命令开启 KubeSphere 完整安装,即开启所有功能组件的安装:
```yaml ```yaml
...@@ -130,20 +128,31 @@ kubectl logs -n kubesphere-system $(kubectl get pod -n kubesphere-system -l app= ...@@ -130,20 +128,31 @@ kubectl logs -n kubesphere-system $(kubectl get pod -n kubesphere-system -l app=
## 开始使用 KubeSphere ## 开始使用 KubeSphere
- [KubeSphere 文档中心 (En/中) ](https://kubesphere.io/docs/) - KubeSphere 文档中心 ([En](https://kubesphere.com.cn/docs/)/[](https://kubesphere.com.cn/docs/zh-CN/))
- [API 文档](https://kubesphere.com.cn/docs/v2.1/zh-CN/api-reference/api-docs/) - [API 文档](https://kubesphere.com.cn/docs/zh-CN/api-reference/api-docs/)
## 技术社区
[KubeSphere 社区](https://github.com/kubesphere/community)包含所有社区的信息,包括如何开发,兴趣小组(SIG)等。比如[开发指南](https://github.com/kubesphere/community/tree/master/developer-guide/development) 详细说明了如何从源码编译、KubeSphere 的 GitHub 工作流、如何贡献代码以及如何测试等。
- [论坛](https://kubesphere.com.cn/forum/)
- [Slack Channel](https://join.slack.com/t/kubesphere/shared_invite/enQtNTE3MDIxNzUxNzQ0LTZkNTdkYWNiYTVkMTM5ZThhODY1MjAyZmVlYWEwZmQ3ODQ1NmM1MGVkNWEzZTRhNzk0MzM5MmY4NDc3ZWVhMjE)
## Bug 与建议反馈
## 开发 KubeSphere 欢迎在 [GitHub Issue](https://github.com/kubesphere/kubesphere/issues) 提交 Issue。
[开发指南](https://github.com/kubesphere/community/tree/master/developer-guide/development) 详细说明了如何从源码编译、KubeSphere 的 GitHub 工作流、如何贡献代码以及如何测试等。 ## 谁在使用 KubeSphere
[Powered by KubeSphere](docs/powered-by-kubesphere.md) 列出了哪些企业在使用 KubeSphere,如果您所在的企业已安装使用了 KubeSphere,欢迎提交 PR 至该页面。
## 路线图 ## 路线图
目前,KubeSphere 已发布了 4 个大版本和 4 个小版本,所有版本都是完全开源的,参考 [Plans for 2.1.1 and 3.0.0](https://github.com/kubesphere/kubesphere/issues/1368) 了解后续版本的规划,欢迎在 GitHub issue 中提交需求。 目前,KubeSphere 已发布了 3 个大版本和 1 个小版本和 4 个 fixpack,所有版本都是完全开源的,参考 [Plans for 2.1.1 and 3.0.0](https://github.com/kubesphere/kubesphere/issues/1368) 了解后续版本的规划,欢迎在 GitHub issue 中提交需求。
**Express Edition** => **v1.0.x** => **v2.0.x** => **v2.1.0** => **v2.1.1** => **v3.0.0** **Express Edition** => **v1.0.x** => **v2.0.x** => **v2.1.0** => **v2.1.1** => **v3.0.0**
![](https://pek3b.qingstor.com/kubesphere-docs/png/20190926000514.png) ![Roadmap](https://pek3b.qingstor.com/kubesphere-docs/png/20190926000514.png)
## Landscapes ## Landscapes
...@@ -155,17 +164,3 @@ KubeSphere 是 CNCF 基金会成员并且通过了 <a href="https://www.cncf.io/ ...@@ -155,17 +164,3 @@ KubeSphere 是 CNCF 基金会成员并且通过了 <a href="https://www.cncf.io/
</a>,进一步丰富了 <a href="https://landscape.cncf.io/landscape=observability-and-analysis&license=apache-license-2-0">CNCF 云原生的生态。 </a>,进一步丰富了 <a href="https://landscape.cncf.io/landscape=observability-and-analysis&license=apache-license-2-0">CNCF 云原生的生态。
</a> </a>
</p> </p>
## Who Uses KubeSphere
[Powered by KubeSphere](docs/powered-by-kubesphere.md) 列出了哪些企业在使用 KubeSphere,如果您所在的企业已安装使用了 KubeSphere,欢迎提交 PR 至该页面。
## 技术社区
- [论坛](https://kubesphere.com.cn/forum/)
- [Slack Channel](https://join.slack.com/t/kubesphere/shared_invite/enQtNTE3MDIxNzUxNzQ0LTZkNTdkYWNiYTVkMTM5ZThhODY1MjAyZmVlYWEwZmQ3ODQ1NmM1MGVkNWEzZTRhNzk0MzM5MmY4NDc3ZWVhMjE)
## Bug 与建议反馈
欢迎在 [GitHub Issue](https://github.com/kubesphere/kubesphere/issues) 提交 Issue。
Markdown is supported
0% .
You are about to add 0 people to the discussion. Proceed with caution.
先完成此消息的编辑!
想要评论请 注册