diff --git a/content/zh/docs/installing-on-kubernetes/hosted-kubernetes/install-kubesphere-on-ack.md b/content/zh/docs/installing-on-kubernetes/hosted-kubernetes/install-kubesphere-on-ack.md new file mode 100644 index 000000000..c96607b35 --- /dev/null +++ b/content/zh/docs/installing-on-kubernetes/hosted-kubernetes/install-kubesphere-on-ack.md @@ -0,0 +1,235 @@ +--- +title: "在阿里云 ACK 上安装 KubeSphere" +keywords: "kubesphere, kubernetes, docker, aliyun, ack" +description: "介绍如何在阿里云容器服务 ACK 上部署 KubeSphere 3.0" + + +weight: 4250 +--- + +本指南将介绍如果在[阿里云容器服务 ACK](https://www.aliyun.com/product/kubernetes/) 上部署并使用 KubeSphere 3.0.0 平台。 + +## 阿里云 ACK 环境准备 + +### 创建 Kubernetes 集群 + +首先按使用环境的资源需求创建 Kubernetes 集群，满足以下一些条件即可（如已有环境并满足条件可跳过本节内容）： + +- KubeSphere 3.0.0 默认支持的 Kubernetes 版本为 `1.15.x`, `1.16.x`, `1.17.x`, `1.18.x`，选择支持的版本创建集群（如 `v1.16.9`, `v1.18.8`）； +- 需要确保 Kubernetes 集群所使用的 ECS 实例的网络正常工作，可以通过在创建集群的同时**自动创建**或**使用已有**弹性 IP；或者在集群创建后自行配置网络（如配置 [NAT 网关](https://www.aliyun.com/product/network/nat/)）； +- 小规模场景下工作节点规格建议选择 `4核｜8GB` 配置，不推荐`2核｜4GB` ，并按需扩展工作节点数量（通常生产环境需要 3 个及以上工作节点），详情可参考[最佳实践- ECS 选型](https://help.aliyun.com/document_detail/98886.html)。 + +1.创建标准托管集群，转到导航菜单，然后参考下图创建集群，您可以使用集群模板快速创建标准托管集群: + +![ack-template](/images/docs/zh-cn/installing-on-kubernetes/hosted-kubernetes/install-kubesphere-on-ack/ack-template.png) + +选择标准托管集群 + +![standard-template](/images/docs/zh-cn/installing-on-kubernetes/hosted-kubernetes/install-kubesphere-on-ack/standard-template.png) + +2.在**配置集群**页面，配置以下集群信息： + +![create-ack-cluster](/images/docs/zh-cn/installing-on-kubernetes/hosted-kubernetes/install-kubesphere-on-ack/create-ack-cluster.png) + +说明：配置集群名称、选择 Kubernetes版本、容器运行时版本等。 + + + +3.指定专有网络，勾选为专有网络配置 SNAT 以及使用 EIP 暴露 API Server： + +![network-and-apiserver](/images/docs/zh-cn/installing-on-kubernetes/hosted-kubernetes/install-kubesphere-on-ack/network-and-apiserver.png) + +4.配置 Worker 实例规格 + +![ack-worker-config](/images/docs/zh-cn/installing-on-kubernetes/hosted-kubernetes/install-kubesphere-on-ack/ack-worker-config.png) + +指定实例操作系统类型，并为实例配置密码或秘钥 + +![ack-worker-password](/images/docs/zh-cn/installing-on-kubernetes/hosted-kubernetes/install-kubesphere-on-ack/ack-worker-password.png) + +5.选择安装相关组件，完成后创建集群 + +![ack-components](/images/docs/zh-cn/installing-on-kubernetes/hosted-kubernetes/install-kubesphere-on-ack/ack-components.png) + +{{< notice warning >}} + +由于阿里云 Prometheus node-exporter端口与 KubeSphere冲突，这里不勾选 Prometheus 监控服务， 不安装阿里云 Prometheus 组件。 + +{{}} + + + +6.等待集群创建完成，点击详情，查看集群信息 + +![ack-cluster](/images/docs/zh-cn/installing-on-kubernetes/hosted-kubernetes/install-kubesphere-on-ack/ack-cluster.png) + + + +### 连接到 ACK 集群 + +- 创建完集群后，点击**集群信息** > **连接信息**界面，选择**公网访问**，复制下方 kubeconfig 信息到本地计算机，即可在本地连接到 ack 集群。 + + ![ack-kubeconfig](/images/docs/zh-cn/installing-on-kubernetes/hosted-kubernetes/install-kubesphere-on-ack/ack-kubeconfig.png) + + + +也可以通过连接 CloudShell 管理集群，点击通过 CloudShell 管理集群，执行以下命令查看集群节点信息： + +```bash +shell@Alicloud:~$ kubectl get nodes -o wide +NAME STATUS ROLES AGE VERSION INTERNAL-IP EXTERNAL-IP OS-IMAGE KERNEL-VERSION CONTAINER-RUNTIME +cn-shenzhen.192.168.0.35 Ready 15m v1.18.8-aliyun.1 192.168.0.35 CentOS Linux 7 (Core) 3.10.0-1127.19.1.el7.x86_64 docker://19.3.5 +cn-shenzhen.192.168.0.36 Ready 15m v1.18.8-aliyun.1 192.168.0.36 CentOS Linux 7 (Core) 3.10.0-1127.19.1.el7.x86_64 docker://19.3.5 +cn-shenzhen.192.168.0.37 Ready 15m v1.18.8-aliyun.1 192.168.0.37 CentOS Linux 7 (Core) 3.10.0-1127.19.1.el7.x86_64 docker://19.3.5 +``` + +## 部署 KubeSphere + +### 查看 StorageClass + +{{< notice note >}} + +您可以在阿里云容器服务 Kubernetes 集群中使用阿里云云盘存储卷。目前，阿里云 CSI 插件支持通过 PV/PVC 方式挂载云盘，包括静态存储卷和动态存储卷。 + +默认阿里云 ACK 已经为用户创建了不同规格的 StorageClass，可直接使用，但存在最小容量规格限制，详情参考[云盘存储卷使用说明](https://help.aliyun.com/document_detail/134767.html)。 + +{{}} + +连接到 cloudshell 查看 StorageClass 类型 + +```bash +shell@Alicloud:~$ kubectl get sc +NAME PROVISIONER RECLAIMPOLICY VOLUMEBINDINGMODE ALLOWVOLUMEEXPANSION AGE +alicloud-disk-available diskplugin.csi.alibabacloud.com Delete Immediate true 14m +alicloud-disk-efficiency diskplugin.csi.alibabacloud.com Delete Immediate true 14m +alicloud-disk-essd diskplugin.csi.alibabacloud.com Delete Immediate true 14m +alicloud-disk-ssd diskplugin.csi.alibabacloud.com Delete Immediate true 14m +alicloud-disk-topology diskplugin.csi.alibabacloud.com Delete WaitForFirstConsumer true 14m +``` + +容器服务Kubernetes版（ACK）集群默认提供了以下几种StorageClass： + +- alicloud-disk-efficiency：高效云盘。 +- alicloud-disk-ssd：SSD云盘。 +- alicloud-disk-essd：ESSD云盘。 +- alicloud-disk-available：提供高可用选项，优先创建SSD云盘；如果SSD云盘售尽，则创建高效云盘。 +- alicloud-disk-topology: 使用延迟绑定的方式创建云盘。 + +**指定默认StorageClass** + +本次使用alicloud-disk-efficiency，注意申请高效云盘时申请的PV大小不得小于20G。 + +```bash +kubectl patch sc alicloud-disk-efficiency -p '{"metadata": {"annotations": {"storageclass.beta.kubernetes.io/is-default-class": "true"}}}' +``` + +确认配置成功 + +```bash +shell@Alicloud:~$ kubectl get sc +NAME PROVISIONER RECLAIMPOLICY VOLUMEBINDINGMODE ALLOWVOLUMEEXPANSION AGE +alicloud-disk-available diskplugin.csi.alibabacloud.com Delete Immediate true 30m +alicloud-disk-efficiency (default) diskplugin.csi.alibabacloud.com Delete Immediate true 30m +alicloud-disk-essd diskplugin.csi.alibabacloud.com Delete Immediate true 30m +alicloud-disk-ssd diskplugin.csi.alibabacloud.com Delete Immediate true 30m +alicloud-disk-topology diskplugin.csi.alibabacloud.com Delete WaitForFirstConsumer true 30m +``` + + + +### 最小化部署kubesphere + +1.使用 [ks-installer](https://github.com/kubesphere/ks-installer) 在已有的 Kubernetes 集群上来部署 KubeSphere，下载 yaml 文件: + +``` +wget https://github.com/kubesphere/ks-installer/releases/download/v3.0.0/kubesphere-installer.yaml +wget https://github.com/kubesphere/ks-installer/releases/download/v3.0.0/cluster-configuration.yaml +``` + + + +{{< notice warning >}} + +由于阿里云 ACK 高效磁盘最小申请大小为20G，所以挂载的PV申请的容量大小不能小于该值，参考以下配置修改cluster-configuration.yaml。 + +{{}} + + + +部分存储卷 VolumeSize 小于20G,需要手动调整： + +```bash +shell@Alicloud:~$ cat cluster-configuration.yaml | grep VolumeSize + mysqlVolumeSize: 20Gi # MySQL PVC size. + minioVolumeSize: 20Gi # Minio PVC size. + etcdVolumeSize: 20Gi # etcd PVC size. + openldapVolumeSize: 2Gi # openldap PVC size. + elasticsearchMasterVolumeSize: 4Gi # Volume size of Elasticsearch master nodes. + elasticsearchDataVolumeSize: 20Gi # Volume size of Elasticsearch data nodes. + jenkinsVolumeSize: 8Gi # Jenkins volume size. + prometheusVolumeSize: 20Gi # Prometheus PVC size. +``` + +编辑cluster-configuration.yaml文件，调整`openldapVolumeSize、elasticsearchMasterVolumeSize、jenkinsVolumeSize`3个卷大小为20G。 + +执行以下命令部署kubesphere： + +```bash +kubectl apply -f kubesphere-installer.yaml +kubectl apply -f cluster-configuration.yaml +``` + +2.检查安装日志： + +```bash +kubectl logs -n kubesphere-system $(kubectl get pod -n kubesphere-system -l app=ks-install -o jsonpath='{.items[0].metadata.name}') -f +``` + +3.安装完成后，您会看到以下消息： + +```yaml +##################################################### +### Welcome to KubeSphere! ### +##################################################### +Account: admin +Password: P@88w0rd +NOTES： + 1. After logging into the console, please check the + monitoring status of service components in + the "Cluster Management". If any service is not + ready, please wait patiently until all components + are ready. + 2. Please modify the default password after login. +##################################################### +https://kubesphere.io 2020-xx-xx xx:xx:xx +``` + +## 访问 KubeSphere 控制台 + +现在已经安装了 KubeSphere，您可以按照以下步骤访问 KubeSphere 的 Web 控制台。 + +- 切换到 kubesphere-system 命名空间，选择服务，选择 ks-console 点击更新 + + ![ks-console](/images/docs/zh-cn/installing-on-kubernetes/hosted-kubernetes/install-kubesphere-on-ack/ks-console.png) + +- 将 service 类型 `NodePort` 更改为 `LoadBalancer` ，完成后点击更新。 + + ![ack-lb](/images/docs/zh-cn/installing-on-kubernetes/hosted-kubernetes/install-kubesphere-on-ack/ack-lb.png) + +- 获取您的 EXTERNAL-IP。 + + ![ack-lb-ip](/images/docs/zh-cn/installing-on-kubernetes/hosted-kubernetes/install-kubesphere-on-ack/ack-lb-ip.png) + +- 使用 ACK 生成的 external-ip 访问 KubeSphere 的 Web 控制台, 默认帐户和密码（`admin/P@88w0rd`），在集群概述页面中，可以看到如下图所示的仪表板。 + + ![ks-UI](/images/docs/zh-cn/installing-on-kubernetes/hosted-kubernetes/install-kubesphere-on-ack/ks-UI.png) + +## 启用可插拔组件（可选） + +上面的示例演示了默认的最小安装过程，要在 KubeSphere 中启用其他组件，请参阅[启用可插拔组件](../../../pluggable-components/)。 + +{{< notice warning >}} + +由于阿里云 ACK 已经在 kube-system命名空间部署 Metrics-server，请勿开启 KubeSphere metrics-server插件，否则部署失败。 + +{{}} \ No newline at end of file diff --git a/static/images/docs/zh-cn/installing-on-kubernetes/hosted-kubernetes/install-kubesphere-on-ack/ack-cluster.png b/static/images/docs/zh-cn/installing-on-kubernetes/hosted-kubernetes/install-kubesphere-on-ack/ack-cluster.png new file mode 100644 index 000000000..bda9b7156 Binary files /dev/null and b/static/images/docs/zh-cn/installing-on-kubernetes/hosted-kubernetes/install-kubesphere-on-ack/ack-cluster.png differ diff --git a/static/images/docs/zh-cn/installing-on-kubernetes/hosted-kubernetes/install-kubesphere-on-ack/ack-components.png b/static/images/docs/zh-cn/installing-on-kubernetes/hosted-kubernetes/install-kubesphere-on-ack/ack-components.png new file mode 100644 index 000000000..23675a48b Binary files /dev/null and b/static/images/docs/zh-cn/installing-on-kubernetes/hosted-kubernetes/install-kubesphere-on-ack/ack-components.png differ diff --git a/static/images/docs/zh-cn/installing-on-kubernetes/hosted-kubernetes/install-kubesphere-on-ack/ack-kubeconfig.png b/static/images/docs/zh-cn/installing-on-kubernetes/hosted-kubernetes/install-kubesphere-on-ack/ack-kubeconfig.png new file mode 100644 index 000000000..3f51de611 Binary files /dev/null and b/static/images/docs/zh-cn/installing-on-kubernetes/hosted-kubernetes/install-kubesphere-on-ack/ack-kubeconfig.png differ diff --git a/static/images/docs/zh-cn/installing-on-kubernetes/hosted-kubernetes/install-kubesphere-on-ack/ack-lb-ip.png b/static/images/docs/zh-cn/installing-on-kubernetes/hosted-kubernetes/install-kubesphere-on-ack/ack-lb-ip.png new file mode 100644 index 000000000..82d280189 Binary files /dev/null and b/static/images/docs/zh-cn/installing-on-kubernetes/hosted-kubernetes/install-kubesphere-on-ack/ack-lb-ip.png differ diff --git a/static/images/docs/zh-cn/installing-on-kubernetes/hosted-kubernetes/install-kubesphere-on-ack/ack-lb.png b/static/images/docs/zh-cn/installing-on-kubernetes/hosted-kubernetes/install-kubesphere-on-ack/ack-lb.png new file mode 100644 index 000000000..de91ea765 Binary files /dev/null and b/static/images/docs/zh-cn/installing-on-kubernetes/hosted-kubernetes/install-kubesphere-on-ack/ack-lb.png differ diff --git a/static/images/docs/zh-cn/installing-on-kubernetes/hosted-kubernetes/install-kubesphere-on-ack/ack-template.png b/static/images/docs/zh-cn/installing-on-kubernetes/hosted-kubernetes/install-kubesphere-on-ack/ack-template.png new file mode 100644 index 000000000..9b4f87677 Binary files /dev/null and b/static/images/docs/zh-cn/installing-on-kubernetes/hosted-kubernetes/install-kubesphere-on-ack/ack-template.png differ diff --git a/static/images/docs/zh-cn/installing-on-kubernetes/hosted-kubernetes/install-kubesphere-on-ack/ack-worker-config.png b/static/images/docs/zh-cn/installing-on-kubernetes/hosted-kubernetes/install-kubesphere-on-ack/ack-worker-config.png new file mode 100644 index 000000000..c80c1e024 Binary files /dev/null and b/static/images/docs/zh-cn/installing-on-kubernetes/hosted-kubernetes/install-kubesphere-on-ack/ack-worker-config.png differ diff --git a/static/images/docs/zh-cn/installing-on-kubernetes/hosted-kubernetes/install-kubesphere-on-ack/ack-worker-password.png b/static/images/docs/zh-cn/installing-on-kubernetes/hosted-kubernetes/install-kubesphere-on-ack/ack-worker-password.png new file mode 100644 index 000000000..ab12d3356 Binary files /dev/null and b/static/images/docs/zh-cn/installing-on-kubernetes/hosted-kubernetes/install-kubesphere-on-ack/ack-worker-password.png differ diff --git a/static/images/docs/zh-cn/installing-on-kubernetes/hosted-kubernetes/install-kubesphere-on-ack/create-ack-cluster.png b/static/images/docs/zh-cn/installing-on-kubernetes/hosted-kubernetes/install-kubesphere-on-ack/create-ack-cluster.png new file mode 100644 index 000000000..11ae08942 Binary files /dev/null and b/static/images/docs/zh-cn/installing-on-kubernetes/hosted-kubernetes/install-kubesphere-on-ack/create-ack-cluster.png differ diff --git a/static/images/docs/zh-cn/installing-on-kubernetes/hosted-kubernetes/install-kubesphere-on-ack/ks-UI.png b/static/images/docs/zh-cn/installing-on-kubernetes/hosted-kubernetes/install-kubesphere-on-ack/ks-UI.png new file mode 100644 index 000000000..1d24363ab Binary files /dev/null and b/static/images/docs/zh-cn/installing-on-kubernetes/hosted-kubernetes/install-kubesphere-on-ack/ks-UI.png differ diff --git a/static/images/docs/zh-cn/installing-on-kubernetes/hosted-kubernetes/install-kubesphere-on-ack/ks-console-service.png b/static/images/docs/zh-cn/installing-on-kubernetes/hosted-kubernetes/install-kubesphere-on-ack/ks-console-service.png new file mode 100644 index 000000000..20c5b2f56 Binary files /dev/null and b/static/images/docs/zh-cn/installing-on-kubernetes/hosted-kubernetes/install-kubesphere-on-ack/ks-console-service.png differ diff --git a/static/images/docs/zh-cn/installing-on-kubernetes/hosted-kubernetes/install-kubesphere-on-ack/ks-console.png b/static/images/docs/zh-cn/installing-on-kubernetes/hosted-kubernetes/install-kubesphere-on-ack/ks-console.png new file mode 100644 index 000000000..bf35db72d Binary files /dev/null and b/static/images/docs/zh-cn/installing-on-kubernetes/hosted-kubernetes/install-kubesphere-on-ack/ks-console.png differ diff --git a/static/images/docs/zh-cn/installing-on-kubernetes/hosted-kubernetes/install-kubesphere-on-ack/network-and-apiserver.png b/static/images/docs/zh-cn/installing-on-kubernetes/hosted-kubernetes/install-kubesphere-on-ack/network-and-apiserver.png new file mode 100644 index 000000000..c9c9a9976 Binary files /dev/null and b/static/images/docs/zh-cn/installing-on-kubernetes/hosted-kubernetes/install-kubesphere-on-ack/network-and-apiserver.png differ diff --git a/static/images/docs/zh-cn/installing-on-kubernetes/hosted-kubernetes/install-kubesphere-on-ack/standard-template.png b/static/images/docs/zh-cn/installing-on-kubernetes/hosted-kubernetes/install-kubesphere-on-ack/standard-template.png new file mode 100644 index 000000000..15fa464e5 Binary files /dev/null and b/static/images/docs/zh-cn/installing-on-kubernetes/hosted-kubernetes/install-kubesphere-on-ack/standard-template.png differ