这些脚本处理 CenturyLink Cloud 上 Kubernetes 集群的创建，删除和扩展。

您可以使用单个命令完成所有这些任务。我们已经可以使用 Ansible playbooks 执行这些任务，请参考 这里。

寻求帮助

如果遇到任何问题或需要任何帮助，我们都会帮助您。您可以通过以下任何方式联系我们：

您可以任意选择虚拟机或物理服务器组成集群。

  • 无论虚拟机还是物理服务器均支持 Kubernetes 集群。如果工作节点（minion）使用物理服务器，请使用 –minion_type=bareMetal 标志。
  • 有关物理服务器的更多信息，请访问：https://www.ctl.io/bare-metal/
  • 物理服务仅在 VA1 和 GB3 数据中心提供。
  • 所有13个公有云位置均提供虚拟机

要求

运行这个脚本的要求是：

运行这个脚本的要求是：

  • 一个 Linux 管理主机（在 Ubuntu 和 OSX 测试过）
  • python 2（在 2.7.11 上测试过）
    • pip（安装 Python 2.7.9）
  • git
  • 具有创建新主机权限的 CenturyLink Cloud 帐户
  • 从您的 Linux 主机到 CenturyLink Cloud 的 VPN 连接

脚本安装

满足所有要求后，请按照以下说明运行安装脚本。

1) 克隆这个仓库，并 cd 到这个目录中。

  1. git clone https://github.com/CenturyLinkCloud/adm-kubernetes-on-clc

2) 安装所有要求，包括

  • Ansible
  • CenturyLink Cloud SDK
  • Ansible模块
  1. sudo pip install -r ansible/requirements.txt

3) 从模板创建凭证文件，并使用它来设置您的ENV变量

  1. cp ansible/credentials.sh.template ansible/credentials.sh
  2. vi ansible/credentials.sh
  3. source ansible/credentials.sh
  4.  

4) 使用网络内的虚拟机或 配置连接到 CenturyLink Cloud 网络的 VPN 来从您的机器访问 CenturyLink Cloud 网络。

脚本安装示例：Ubuntu 14 演练

如果您使用的是 Ubuntu 14，方便起见，我们已经提供了一个安装依赖和脚本的分步指导。

  1. # system
  2. apt-get update
  3. apt-get install -y git python python-crypto
  4. curl -O https://bootstrap.pypa.io/get-pip.py
  5. python get-pip.py
  6.  
  7. # installing this repository
  8. mkdir -p ~home/k8s-on-clc
  9. cd ~home/k8s-on-clc
  10. git clone https://github.com/CenturyLinkCloud/adm-kubernetes-on-clc.git
  11. cd adm-kubernetes-on-clc/
  12. pip install -r requirements.txt
  13.  
  14. # getting started
  15. cd ansible
  16. cp credentials.sh.template credentials.sh; vi credentials.sh
  17. source credentials.sh

集群创建

要创建一个新的 Kubernetes 集群，只需运行 kube-up.sh 脚本。以下列出了脚本选项和一些示例的完整列表。

  1. CLC_CLUSTER_NAME=[name of kubernetes cluster]
  2. cd ./adm-kubernetes-on-clc
  3. bash kube-up.sh -c="$CLC_CLUSTER_NAME"

大约需要15分钟来创建集群。一旦脚本完成，它会输出一些命令来帮助您在机器上设置 kubectl 以指向新的集群。

集群创建完成后，会将其配置文件本地保存在您管理主机的以下目录中

  1. > CLC_CLUSTER_HOME=$HOME/.clc_kube/$CLC_CLUSTER_NAME/

集群创建：脚本选项

  1. Usage: kube-up.sh [OPTIONS]
  2. Create servers in the CenturyLinkCloud environment and initialize a Kubernetes cluster
  3. Environment variables CLC_V2_API_USERNAME and CLC_V2_API_PASSWD must be set in
  4. order to access the CenturyLinkCloud API
  5.  
  6. All options (both short and long form) require arguments, and must include "="
  7. between option name and option value.
  8.  
  9.      -h (--help)                   display this help and exit
  10.      -c= (--clc_cluster_name=)     set the name of the cluster, as used in CLC group names
  11.      -t= (--minion_type=)          standard -> VM (default), bareMetal -> physical]
  12.      -d= (--datacenter=)           VA1 (default)
  13.      -m= (--minion_count=)         number of kubernetes minion nodes
  14.      -mem= (--vm_memory=)          number of GB ram for each minion
  15.      -cpu= (--vm_cpu=)             number of virtual cps for each minion node
  16.      -phyid= (--server_conf_id=)   physical server configuration id, one of
  17.                                       physical_server_20_core_conf_id
  18.                                       physical_server_12_core_conf_id
  19.                                       physical_server_4_core_conf_id (default)
  20.      -etcd_separate_cluster=yes    create a separate cluster of three etcd nodes,
  21.                                    otherwise run etcd on the master node

集群扩展

要扩展现有的 Kubernetes 集群，运行 add-kube-node.sh 脚本。脚本选项和一些例子的完整列表在 下面 列出。 此脚本必须从创建集群的同一台主机（或者在 ~/.clc_kube/$cluster_name 路径保存了集群 artifact 文件的主机）运行。

  1. cd ./adm-kubernetes-on-clc
  2. bash add-kube-node.sh -c="name_of_kubernetes_cluster" -m=2

集群扩展：脚本选项

  1. Usage: add-kube-node.sh [OPTIONS]
  2. Create servers in the CenturyLinkCloud environment and add to an
  3. existing CLC kubernetes cluster
  4.  
  5. Environment variables CLC_V2_API_USERNAME and CLC_V2_API_PASSWD must be set in
  6. order to access the CenturyLinkCloud API
  7.  
  8.      -h (--help)                   display this help and exit
  9.      -c= (--clc_cluster_name=)     set the name of the cluster, as used in CLC group names
  10.      -m= (--minion_count=)         number of kubernetes minion nodes to add

集群删除

有两种方法可以删除现有的集群：

1) 使用我们的 Python 脚本：

  1. python delete_cluster.py --cluster=clc_cluster_name --datacenter=DC1

2) 使用 CenturyLink Cloud 用户界面。 要删除集群，请登录到 CenturyLink Cloud 控制门户并删除包含该的父服务器组 Kubernetes 集群。 我们希望添加一个脚本化的选项来尽快做到这一点。

例子

在 VA1 中创建名称为 k8s_1，1个 master 节点和3个 worker（在物理机上）的集群

  1. bash kube-up.sh --clc_cluster_name=k8s_1 --minion_type=bareMetal --minion_count=3 --datacenter=VA1

在 VA1 中创建一个名为 k8s_2 的集群，一个在3个虚拟机和6个 worker minion（在虚拟机上）的 HA etcd 集群

  1. bash kube-up.sh --clc_cluster_name=k8s_2 --minion_type=standard --minion_count=6 --datacenter=VA1 --etcd_separate_cluster=yes

在 UC1 中创建一个名为 k8s_3，1个 master 节点和10个具有更高 mem/cpu 的 worker minion（在VM上）的集群：

  1. bash kube-up.sh --clc_cluster_name=k8s_3 --minion_type=standard --minion_count=10 --datacenter=VA1 -mem=6 -cpu=4

集群功能和体系结构

我们使用以下功能配置 Kubernetes 集群：

  • KubeDNS：DNS 解析和服务发现
  • Heapster/InfluxDB：用于 metric 收集。需要 Grafana 和 auto-scaling。
  • Grafana：Kubernetes/Docker metric 面板
  • KubeUI：简单的界面来查看 Kubernetes 状态

  • Kube Dashboard：新的用于与您的集群交互的 Web 界面
    我们使用这些组件创建 Kubernetes 集群：

  • Kubernetes 1.1.7

  • Ubuntu 14.04
  • Flannel 0.5.4
  • Docker 1.9.1-0~trusty
  • Etcd 2.2.2

可选插件

  • 日志记录：我们提供一个集成的集中日志记录 ELK 平台，以便所有 Kubernetes 和 docker 日志被发送到 ELK 堆栈。要安装 ELK 堆栈并配置 Kubernetes 发送日志， 遵循 日志聚合文档。 注意：我们不会默认安装这个，因为它占用的空间并不小。

集群管理

管理 Kubernetes 集群的最广泛使用的工具是命令行 kubectl。 如果您的管理主机上还没有这个二进制文件，可以运行 install_kubectl.sh，这个脚本会将它下载并安装到 /usr/bin/local 中。

该脚本要求定义环境变量 CLC_CLUSTER_NAME

install_kubectl.sh 也写一个配置文件，它将嵌入必要的特定集群的身份验证证书。 配置文件会写到 ${CLC_CLUSTER_HOME}/kube 目录

  1. export KUBECONFIG=${CLC_CLUSTER_HOME}/kube/config
  2. kubectl version
  3. kubectl cluster-info

以编程方式访问集群

可以使用本地存储的客户端证书来访问 apiserver。例如，您可能希望使用任何 Kubernetes API 客户端库 ，并以您选择的编程语言对您的 Kubernetes 集群进行编程。

为了演示如何使用这些本地存储的证书，我们提供了以下例子，使用 `curl 通过 https 与主 apiserver 进行通信：

  1. curl \
  2.    --cacert ${CLC_CLUSTER_HOME}/pki/ca.crt  \
  3.    --key ${CLC_CLUSTER_HOME}/pki/kubecfg.key \
  4.    --cert ${CLC_CLUSTER_HOME}/pki/kubecfg.crt  https://${MASTER_IP}:6443

但请注意，这不适用于 OSX 版本的 curl 二进制文件。

使用浏览器访问集群

我们在 Kubernetes 上安装两个 UI。原来的 KubeUI 和 新的 Kube dashboard。 当你创建一个集群时，脚本应该输出这些接口 URL ，像这样：

KubeUI is running at https://${MASTER_IP}:6443/api/v1/namespaces/kube-system/services/kube-ui/proxy.

kubernetes-dashboard is running at https://${MASTER_IP}:6443/api/v1/namespaces/kube-system/services/kubernetes-dashboard/proxy.

关于用户界面身份验证的注意事项：集群设置为使用基本用户 admin 的身份验证。打在网址 https://${MASTER_IP}:6443 需要接受 apiserver 的自签名证书，然后提交管理员密码文件，位于：

> ${CLC_CLUSTER_HOME}/kube/admin_password.txt

配置文件

各种配置文件被写入主目录 CLC_CLUSTER_HOME 下的 .clc_kube/${CLC_CLUSTER_NAME} 几个子目录中。 你可以使用这些文件从您创建集群的位置以外的机器访问集群。

  • config/: Ansible变量文件，包含描述主控和主控主机的参数
  • hosts/: 主机文件列出了可靠的剧本的访问信息
  • kube/: kubectl 配置文件，以及管理员访问 Kubernetes API 的基本认证密码
  • pki/: 在集群中启用 TLS 通信的公共基础设施文件
  • ssh/: 用于 root 访问主机的 SSH 密钥

kubectl 使用例子

kubectl 有很多功能。下面是一些例子

列出所有名称空间中的现有 node、Pod、service 等等，或者只列出一个：

  1. kubectl get nodes
  2. kubectl get --all-namespaces services
  3. kubectl get --namespace=kube-system replicationcontrollers

Kubernetes API 服务器在 web URL 上提供服务，通过校验客户证书保护这些 URL 。 如果你在本地运行一个 kubectl 代理，kubectl 将会提供必要的证书并通过 http 服务于本地。

  1. kubectl proxy -p 8001

然后，您可以在浏览器中访问像 http://127.0.0.1:8001/api/v1/namespaces/kube-system/services/kube-ui/proxy/ 这样的 URL 而不需要客户端证书。

哪些 Kubernetes 特性在 CenturyLink Cloud 上不起作用

这些是在 CenturyLink Cloud 上不起作用的已知项，但可以在其他云上工作：

  • 目前没有 LoadBalancer 类型的支持服务。我们正在积极努力，希望在2016年4月左右发布这些变化。
  • 目前，CenturyLink Cloud 不支持持久性存储卷。但是，客户可以使用自己选中的持久存储。我们自己使用 Gluster。

Ansible 文件

如果你想了解更多有关我们 Ansible 文件的信息，请 阅读此文件

更多信息

有关管理和使用 Kubernetes 集群的更多详细信息，请参阅 Kubernetes 文档。

译者：zhangqx2010 / 原文链接

K8S中文社区微信公众号

原文: http://docs.kubernetes.org.cn/807.html