sgcclh/kubespray

Kubespray：生产就绪Kubernetes集群部署工具

!Kubernetes Logo

镜像概述和主要用途

Kubespray是一个基于Ansible的工具，用于自动化部署生产级别的Kubernetes集群。它支持多种部署环境，提供高可用性配置，并允许用户根据需求选择组件（如网络插件），适用于需要快速、可靠部署Kubernetes集群的场景。

若有问题，可加入kubernetes slack的**#kubespray**频道交流。

核心功能和特性

• 多环境支持：可部署在AWS、GCE、Azure、OpenStack或裸金属服务器
• 高可用性：支持构建高可用集群架构
• 可组合性：允许选择网络插件等组件
• 广泛的系统兼容性：支持主流Linux发行版
• 持续集成测试：确保部署流程的稳定性和可靠性

使用场景和适用范围

• 企业内部私有Kubernetes集群部署
• 多云环境下的Kubernetes统一管理
• 开发/测试环境的快速集群搭建
• 生产环境的高可用Kubernetes集群构建

使用方法和配置说明

快速开始

Ansible部署

bash
# 复制示例inventory为自定义inventory
cp -rfp inventory/sample inventory/mycluster

# 使用inventory构建器更新Ansible inventory文件
declare -a IPS=(10.10.1.3 10.10.1.4 10.10.1.5)
CONFIG_FILE=inventory/mycluster/hosts.ini python3 contrib/inventory_builder/inventory.py ${IPS[@]}

# 查看并修改配置参数
cat inventory/mycluster/group_vars/all.yml
cat inventory/mycluster/group_vars/k8s-cluster.yml

# 执行Ansible Playbook部署Kubespray
ansible-playbook -i inventory/mycluster/hosts.ini cluster.yml

Vagrant部署（测试环境）

bash
# 直接运行vagrant up即可
vagrant up

相关文档

• Requirements
• Kubespray对比其他工具
• 快速入门
• Ansible inventory和标签
• 与现有Ansible仓库集成
• 部署数据变量
• DNS栈
• 高可用模式
• 网络插件
• Vagrant安装
• CoreOS引导
• Debian Jessie设置
• 下载的 artifacts
• 云服务提供商
• OpenStack
• AWS
• Azure
• vSphere
• 大规模部署
• 升级基础
• 路线图

支持的Linux发行版

• Container Linux by CoreOS
• Debian Jessie
• Ubuntu 16.04
• CentOS/RHEL 7

注意：不支持基于Upstart/SysV init的操作系统。

支持的组件版本

• https://github.com/kubernetes/kubernetes/releases v1.9.2
• https://github.com/coreos/etcd/releases v3.2.4
• https://github.com/coreos/flannel/releases v0.8.0
• calico v2.5.0
• https://github.com/projectcalico/canal%EF%BC%88%E5%9F%BA%E4%BA%8E%E4%B8%8A%E8%BF%B0calico/flannel%E7%89%88%E6%9C%AC%EF%BC%89
• https://github.com/contiv/install/releases v1.0.3
• weave v2.0.1
• docker v1.13（见说明）
• rkt v1.21.0（见说明2）

说明：Kubernetes不支持较新的Docker版本。kubelet目前会因Docker非标准版本号（不再使用语义化版本）而出现问题。为确保自动更新不会破坏集群，建议使用yum versionlock插件或apt pin等工具固定版本。

说明2：rkt作为Docker的替代方案，仅支持控制平面（etcd和kubelet）。Kubernetes集群工作负载和网络插件相关的系统服务仍使用Docker。此外，单个集群只能部署一种支持的网络插件。

环境要求

• 运行Ansible命令的机器需安装Ansible v2.4（或更高版本）和python-netaddr
• 运行Ansible Playbooks需Jinja 2.9（或更高版本）
• 目标服务器必须能够访问互联网以拉取Docker镜像
• 目标服务器需配置允许IPv4转发
• SSH密钥必须复制到inventory中的所有服务器
• 防火墙未被管理，需自行配置规则；为避免部署问题，建议暂时禁用防火墙

网络插件

可选择以下5种网络插件（默认：calico，Vagrant环境默认使用flannel）：

• flannel：gre/vxlan（二层）网络
• calico：bgp（三层）网络
• https://github.com/projectcalico/canal%EF%BC%9Acalico%E5%92%8Cflannel%E7%9A%84%E7%BB%84%E5%90%88%E6%8F%92%E4%BB%B6
• contiv：支持vlan、vxlan、bgp和Cisco SDN网络，可应用防火墙策略、隔离多网络容器及将Pod桥接到物理网络
• weave：轻量级容器覆盖网络，无需外部K/V数据库集群（请参考weave的故障排除文档）

网络插件通过变量kube_network_plugin定义，也可选择使用云服务提供商内置网络。另请参考网络检查工具。

社区文档和资源

• kubernetes.io/docs/getting-started-guides/kubespray/
• https://github.com/gregbkr/kubernetes-kargo-logging-monitoring%EF%BC%88@gregbkr%EF%BC%89
• https://rsmitty.github.io/Terraform-Ansible-Kubernetes/%EF%BC%88@rsmitty%EF%BC%89
• 使用Kubespray部署Kubernetes集群（视频）

基于Kubespray的工具和项目

• https://github.com/digitalrebar/provision/blob/master/doc/integrations/ansible.rst
• https://github.com/openstack/fuel-ccp-installer
• https://github.com/kubernetes-incubator/kubespray/tree/master/contrib/terraform

CI测试

!Gitlab Logo

![Build graphs]([***]

CI/端到端测试由Google（GCE）、DigitalOcean、teuto.net（OpenStack）赞助。详情请参见测试矩阵。