fpco/kubespray

Kubespray 镜像文档

!Kubernetes Logo

镜像概述和主要用途

Kubespray镜像提供Ansible剧本和角色，用于在多种环境中部署生产就绪的Kubernetes集群。支持云平台（AWS、GCE、Azure等）和裸机部署，具备高可用性和可定制性，适用于需要快速搭建企业级K8s集群的场景。

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

核心功能和特性

• 多平台支持：可部署于AWS、GCE、Azure、OpenStack、vSphere或裸机环境
• 高可用性：支持构建高可用集群
• 可组合性：可选择网络插件等组件
• 广泛兼容性：支持主流Linux发行版
• 持续集成测试：确保部署稳定性

支持的Linux发行版

• Container Linux by CoreOS
• Debian（Jessie、Stretch、Wheezy）
• Ubuntu 16.04
• CentOS/RHEL 7
• Fedora/CentOS Atomic
• openSUSE Leap 42.3/Tumbleweed

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

支持的组件版本

• https://github.com/kubernetes/kubernetes/releases v1.9.5
• https://github.com/coreos/etcd/releases v3.2.4
• https://github.com/coreos/flannel/releases v0.10.0
• calico v2.6.8
• 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/cilium/cilium v1.0.0-rc8
• https://github.com/contiv/install/releases v1.1.7
• weave v2.2.1
• docker v17.03（见注）
• rkt v1.21.0（见注2）

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

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

系统要求

• Ansible环境：运行Ansible命令的机器需安装Ansible v2.4+和python-netaddr
• Jinja版本：需Jinja 2.9+以运行Ansible剧本
• 网络访问：目标服务器需能访问互联网以拉取Docker镜像
• IPv4转发：目标服务器需配置允许IPv4转发
• SSH密钥：需将SSH密钥复制到所有 inventory 中的服务器
• 防火墙配置：不管理防火墙，需自行配置规则；部署期间建议关闭防火墙避免问题
• 权限提升：若从非root用户运行kubespray，需在目标服务器配置正确的权限提升方法，并指定ansible_become标志或--become/-b命令参数

网络插件

支持6种网络插件（默认：calico，Vagrant环境默认flannel），通过变量kube_network_plugin指定：

• 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
• cilium：三层/四层网络（同时支持七层应用协议的安全防护），通过动态插入BPF字节码到Linux内核实现安全服务、网络和可见性逻辑
• contiv：支持vlan、vxlan、bgp和Cisco SDN网络，可应用防火墙策略、隔离多网络容器、将Pod桥接到物理网络
• weave：轻量级容器覆盖网络，无需外部K/V数据库集群（参考weave故障排除文档）

也可选择使用云提供商内置网络。另见网络检查器。

快速开始

使用Ansible部署

bash
# 复制 inventory/sample 为 inventory/mycluster
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[@]}

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

# 使用Ansible剧本部署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设置
• openSUSE设置
• 下载的 artifacts
• 云提供商
• OpenStack
• AWS
• Azure
• vSphere
• 大规模部署
• 升级基础
• 路线图

社区文档和资源

• 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）赞助，详见测试矩阵。