ocboot 是 OneCloud bootstrap 的简写，能够快速的在 Centos7 机器上搭建部署 OneCloud 服务。
ocboot 依赖 ansible-playbook 部署 onecloud 服务，可以在单节点使用 local 的方式部署，也可以在多个节点使用 ssh 的方式同时部署。
- 操作系统: Centos 7.x
- 最低配置要求: 4核8G
- 软件: ansible
- 能够 ssh 免密登录待部署机器
ocboot 使用 ansible 来部署服务，所以请先在自己的系统上安装 ansible ，可以使用发型版自带的包管理工具安装，或者直接使用 pip 安装。
# centos install ansible
$ yum install -y ansible
# archlinux install ansible
$ pacman -S ansible
# others
$ pip install ansible$ git clone https://github.com/yunionio/ocboot.git
$ cd ./ocboot & pip install -r ./requirements.txtocboot 的运行方式很简单，只需要按自己机器的规划写好 yaml 配置文件，然后执行 ./ocboot.py install 脚本，便会调用 ansible-playbook 在对应的机器上部署服务。
ocboot 可以很简单的在一台机器上部署 all in one 环境，也可以同时在多台机器上部署大规模集群，以下举例说明使用方法和配置文件的编写。
假设已经准备好了 1 台 Centos 7 机器，它的 ip 是 10.127.10.158，我想在这台机器上 allinone 安装 OneCloud v3.4.15 版本。
# 编写 config-allinone.yml 文件
$ cat <<EOF >./config-allinone.yml
# mariadb_node 表示需要部署 mariadb 服务的节点
mariadb_node:
# 待部署节点 ip
hostname: 10.127.10.158
# 待部署节点登录用户
user: root
# mariadb 的用户
db_user: root
# mariadb 用户密码
db_password: your-sql-password
# primary_master_node 表示运行 k8s 和 onecloud 服务的节点
primary_master_node:
hostname: 10.127.10.158
user: root
# onecloud 版本
onecloud_version: v3.4.15
# 数据库连接地址
db_host: 10.127.10.158
# 数据库用户
db_user: root
# 数据库密码
db_password: your-sql-password
# k8s 控制节点的 ip
controlplane_host: 10.127.10.158
# k8s 控制节点的端口
controlplane_port: "6443"
# onecloud 登录用户
onecloud_user: demo
# onecloud 登录用户密码
onecloud_user_password: demo@123
# 该节点作为 OneCloud 私有云计算节点
as_host: true
EOF
# 开始部署
$ ./ocboot.py install ./config-allinone.yml
....
# 部署完成后会有如下输出，表示运行成功
# 浏览器打开 https://10.127.10.158
# 使用 demo/demo@123 用户密码登录就能访问前端界面
Initialized successfully!
Web page: https://10.127.10.158
User: demo
Password: demo@123假设已经准备好了 4 台 Centos 7 机器，它的 ip 是 10.127.10.156-160，各个节点做出以下的规划：
- k8s master 节点: 10.127.10.156-158
- 其中 156 作为第一个部署的主节点并且运行 mariadb
- 这 3 个节点都可以调度运行 onecloud 控制服务
- k8s worker 节点: 10.127.10.159-160
- 这 2 个节点可以作为 onecloud 私有云计算节点
# 根据规划编写 config-nodes.yml 文件
$ cat <<EOF >./config-nodes.yml
mariadb_node:
hostname: 10.127.10.156
user: root
db_user: root
db_password: your-sql-password
primary_master_node:
onecloud_version: v3.4.15
hostname: 10.127.10.156
user: root
db_host: 10.127.10.156
db_user: root
db_password: your-sql-password
controlplane_host: 10.127.10.156
controlplane_port: "6443"
master_nodes:
hosts:
- hostname: 10.127.10.157
user: root
- hostname: 10.127.10.158
user: root
controlplane_host: 10.127.10.156
controlplane_port: "6443"
as_controller: true
worker_nodes:
hosts:
- hostname: 10.127.10.159
user: root
- hostname: 10.127.10.160
user: root
controlplane_host: 10.127.10.156
controlplane_port: "6443"
as_host: true
EOF
# 开始部署
$ ./ocboot.py install ./config-nodes.yml假设准备好了 3 台 CentOS7 机器，以及 1 台 Mariadb/MySQL 的机器，规划如下：
| role | ip | interface | note |
|---|---|---|---|
| k8s primary | 10.127.90.101 | eth0 | - |
| k8s master 1 | 10.127.90.102 | eth0 | - |
| k8s master 2 | 10.127.90.103 | eth0 | - |
| k8s VIP | 10.127.190.10 | - | - |
| DB | 10.127.190.11 | - | pswd="0neC1oudDB#", port=3306 |
# 填充变量，生成配置
DB_IP="10.127.190.11"
DB_PORT=3306
DB_PSWD="0neC1oudDB#"
DB_USER=root
K8S_VIP=10.127.190.10
PRIMARY_INTERFACE="eth0"
PRIMARY_IP=10.127.90.101
MASTER_1_INTERFACE="eth0"
MASTER_1_IP=10.127.90.102
MASTER_2_INTERFACE="eth0"
MASTER_2_IP=10.127.90.103
cat > config-k8s-ha.yml <<EOF
primary_master_node:
use_local: true
user: root
onecloud_version: "v3.6.16"
db_host: $DB_IP
db_user: "$DB_USER"
db_password: "$DB_PSWD"
db_port: "$DB_PORT"
skip_docker_config: true
image_repository: registry.cn-beijing.aliyuncs.com/yunionio
ha_using_local_registry: false
node_ip: "$PRIMARY_IP"
ip_autodetection_method: "can-reach=$PRIMARY_IP"
controlplane_host: $K8S_VIP
controlplane_port: "6443"
as_host: true
high_availability: true
use_ee: false
enable_minio: true
registry_mirrors:
- https://lje6zxpk.mirror.aliyuncs.com
insecure_registries:
- $PRIMARY_IP:5000
host_networks: "$PRIMARY_INTERFACE/br0/$PRIMARY_IP"
master_nodes:
controlplane_host: $K8S_VIP
controlplane_port: "6443"
as_controller: true
as_host: true
ntpd_server: "$PRIMARY_IP"
registry_mirrors:
- https://lje6zxpk.mirror.aliyuncs.com
high_availability: true
hosts:
- user: root
hostname: "$MASTER_1_IP"
host_networks: "$MASTER_1_INTERFACE/br0/$MASTER_1_IP"
- user: root
hostname: "$MASTER_2_IP"
host_networks: "$MASTER_2_INTERFACE/br0/$MASTER_2_IP"
EOF
# 开始部署
$ ./ocboot.py install ./config-k8s-ha.yml添加节点也很简单，只需要按照自己的规划，在已有的 config 里面添加对应的节点 ssh 登录 ip 和用户，然后再重复执行 ./ocboot.py install config.yml 即可。
# 执行升级
$ ./ocboot.py upgrade <PRIMARY_HOST> v3.6.9
# 查看升级可选参数
$ ./ocboot.py upgrade -h
usage: ocboot.py upgrade [-h] [--user SSH_USER] [--key-file SSH_PRIVATE_FILE] [--port SSH_PORT] [--as-bastion]
FIRST_MASTER_HOST VERSION
positional arguments:
FIRST_MASTER_HOST onecloud cluster primary master host, e.g., 10.1.2.56
VERSION onecloud version to be upgrade
optional arguments:
-h, --help show this help message and exit
--user SSH_USER, -u SSH_USER
primary master host ssh user (default: root)
--key-file SSH_PRIVATE_FILE, -k SSH_PRIVATE_FILE
primary master ssh private key file (default: /home/lzx/.ssh/id_rsa)
--port SSH_PORT, -p SSH_PORT
primary master host ssh port (default: 22)
--as-bastion, -B use primary master node as ssh bastion host to run ansible