ocboot 能够快速的在 CentOS 7 、Kylin V10、Debian 10等机器上搭建部署 Cloudpods 服务。
ocboot 依赖 ansible-playbook 部署 cloudpods 服务，可以在单节点使用 local 的方式部署，也可以在多个节点使用 ssh 的方式同时部署。
- 操作系统: Centos 7.x 、Kylin V10、Debian 10
- 最低配置要求: 4 核 8G
- 软件: ansible-2.9.25
- 能够 ssh 免密登录待部署机器
ocboot 使用 ansible 来部署服务，所以请先在自己的系统上安装 ansible ，可以使用发型版自带的包管理工具安装，或者直接使用 pip 安装。
# centos install ansible
$ yum install -y epel-release git python3-pip
$ python3 -m pip install --upgrade pip setuptools wheel
$ python3 -m pip install --upgrade ansible
# kylin install ansible
$ yum install -y git python3-pip
$ python3 -m pip install --upgrade pip setuptools wheel
$ python3 -m pip install --upgrade ansible
# archlinux install ansible
$ pacman -S python3-pip
$ python3 -m pip install --upgrade pip setuptools wheel
$ python3 -m pip install --upgrade ansible
# others
$ python3 -m pip install --upgrade pip setuptools wheel
$ python3 -m pip install --upgrade 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 环境，也可以同时在多台机器上部署大规模集群，以下举例说明使用方法和配置文件的编写。
- All in One 安装：在 CentOS 7 或 Debian 10 等发行版里搭建全功能 Cloudpods 服务，可以快速体验内置私有云和多云管理的功能。
- 多节点高可用安装：在生产环境中使用高可用的方式部署 Cloudpods 服务，包括内置私有云和多云管理的功能。
添加节点使用 add-node 子命令把节点加入到已有集群。
# 比如把节点 192.168.121.61 加入到已有集群 192.168.121.21
$ ./ocboot.py add-node 192.168.121.21 192.168.121.61
# 可以一次添加多个节点，格式如下
$ ./ocboot.py add-node $PRIMARY_IP $node1_ip $node2_ip ... $nodeN_ip
# 把 $node_ip ssh 端口 2222 的节点加入到 $PRIMARY_IP ssh 端口 4567 的集群
$ ./ocboot.py add-node --port 4567 --node-port 2222 $PRIMARY_IP $node_ip
# 查看 add-node 命令帮助信息
$ ./ocboot.py add-node --help具体操作可参考文档：添加节点。
添加节点使用 add-lbagent 子命令把运行 lb agent 服务的节点加入到已有集群。
# 比如把节点 192.168.121.62 加入到已有集群 192.168.121.21
$ ./ocboot.py add-lbagent 192.168.121.21 192.168.121.62
# 可以一次添加多个节点，格式如下
$ ./ocboot.py add-lbagent $PRIMARY_IP $node1_ip $node2_ip ... $nodeN_ip
# 把 $node_ip ssh 端口 2222 的节点加入到 $PRIMARY_IP ssh 端口 4567 的集群
$ ./ocboot.py add-lbagent --port 4567 --node-port 2222 $PRIMARY_IP $node_ip具体操作可参考文档：部署Lbagent。
升级节点参考文档：升级服务。
备份流程会备份当前系统的配置文件（config.yml） 以及使用 mysqldump 来备份数据库。
usage: ocboot.py backup [-h] [--backup-path BACKUP_PATH] [--light] config
positional arguments:
config config yaml file
optional arguments:
-h, --help show this help message and exit
--backup-path BACKUP_PATH
backup path, default: /opt/backup
--light ignore yunionmeter and yunionlogger database; ignore
tables start with 'opslog' and 'task'.下面详细介绍各个参数的作用和注意事项。
config是必选参数，即，需要备份的配置文件名称，例如config-allinone.yml, config-nodes.yml, config-k8s-ha.yml，以及使用快速安装时会生成的config-allinone-current.yml，因此备份命令不对配置文件名称作假设，需由使用者自行输入配置文件名称。--backup-path这个参数记录备份的目标目录。备份的内容包括配置文件（几k级别），以及mysqldump命令备份的数据库文件临时文件：onecloud.sql，然后会将该文件压缩为onecloud.sql.tgz，并删除临时文件。用户需确保/opt/backup目录存在且可写且磁盘空间足够。--light这个选项用来做精简备份，原理是在备份过程中，忽略掉一些尺寸较大的特定文件，主要是账单、操作日志等相关的文件。默认保留。- 备份后的配置文件名称为
config.yml。 - 备份的流程全部采用命令行参数接受输入，备份过程中无交互。因此支持
crontab方式自动备份。但备份程序本身不支持版本rotate，用户可以使用logrotate之类的工具来做备份管理。
-
Q: 备份时提示缺
MySQLdb包怎么办？ -
A：在centos上，可以执行如下命令来安装（其他os发行版请酌情修改，或联系客服）：
sudo yum install -y mariadb-devel python3-devel sudo yum groupinstall -y "Development Tools" sudo pip3 install mysqlclient -
Q: 怎样查看、手工解压备份文件？
-
A：备份文件默认用户名为:
/opt/backup/onecloud.sql.gz, 预览、手工解压的方式如下：# 预览该文件： gunzip --stdout /opt/backup/onecloud.sql.gz | less # 解压，同时保留源文件： gunzip --stdout /opt/backup/onecloud.sql.gz > /opt/backup/onecloud.sql # 有些高版本的gunzip 提供 -k/--keep 选项，来保存源文件。可以直接执行： gunzip -k /opt/backup/onecloud.sql.gz
恢复是备份的逆操作，流程包括：
- 解压备份好的数据库文件；
- 依照用户输入，或者在本机安装
mariadb-server，并导入数据库；或者将备份的数据库 source 到指定的数据库中。 - 根据之前备份好的
config.yml，结合用户输入（当前机器ip、worker node ips、master node ips），来重新生成 config.yml，然后提示用户重新安装云管系统。
usage: ocboot.py restore [-h] [--backup-path BACKUP_PATH]
[--install-db-to-localhost]
[--master-node-ips MASTER_NODE_IPS]
[--master-node-as-host]
[--worker-node-ips WORKER_NODE_IPS]
[--worker-node-as-host] [--mysql-host MYSQL_HOST]
[--mysql-user MYSQL_USER]
[--mysql-password MYSQL_PASSWORD]
[--mysql-port MYSQL_PORT]
primary_ip
positional arguments:
primary_ip primary node ip
optional arguments:
-h, --help show this help message and exit
--backup-path BACKUP_PATH
backup path, default=/opt/backup
--install-db-to-localhost
use this option when install local db
--master-node-ips MASTER_NODE_IPS
master nodes ips, seperated by comma ','
--master-node-as-host
use this option when use master nodes as host
--worker-node-ips WORKER_NODE_IPS
worker nodes ips, seperated by comma ','
--worker-node-as-host
use this option when use worker nodes as host
--mysql-host MYSQL_HOST
mysql host; not needed if set --install-db-to-
localhost
--mysql-user MYSQL_USER
mysql user, default: root; not needed if set
--install-db-to-localhost
--mysql-password MYSQL_PASSWORD
mysql password; not needed if set --install-db-to-
localhost
--mysql-port MYSQL_PORT
mysql port, default: 3306; not needed if set
--install-db-to-localhost-
primary_ip为必填项，作为位置参数传入。 -
--backup-path，默认值为/opt/backup。 -
--install-db-to-localhost，是否在本机（primary节点） 安装数据库。默认为否。如果选择了--install-db-to-localhost，则会在本机安装数据(mariadb-server的稳定版)，并自动赋予下列参数以默认值：-
--mysql-host=127.0.0.1 --mysql-user=root --mysql-password=<继承备份文件里 mysql 的密码> --mysql-port=3306
-
-
--mysql-host以及其他同类选项：不安装数据库，直接复用给定数据库。注意：--install-db-to-localhost参数与--mysql-*系列参数互斥，只能选择其中一种，要么本机安装数据库，要么给定具体参数。 -
--master-node-ips同时安装master节点。该参数是以半角逗号分隔的ip列表。适用于多节点模式。 -
--master-node-as-host安装master节点时，将其作为host节点。 -
--worker-node-ips、--worker-node-as-host，作用同上，如其名。
为了避免因为环境依赖产生的问题，我们也提供了使用容器来部署，由于部署过程中有重启容器引擎的操作，故使用容器时只能以远程的方式部署(即部署的目标机器和运行 ocboot 容器的机器不能是同一台)。使用容器时，只需要配置好 ssh 免密登录，按需创建配置文件，以及安装好 docker 即可开始部署。
查看命令
# Allinone install
$ ./run-in-docker.sh <IP>
$ ./run-in-docker.sh install config-allinone.yml
# Multiple nodes install
$ ./run-in-docker.sh install config-nodes.yml
# High availability install
$ ./run-in-docker.sh install config-k8s-ha.yml
# Add node
$ ./run-in-docker.sh add-node <PRIMARY_HOST> <NODE_IP1> <NODE_IP2> ... <NODE_IPN>
# Upgrade node
$ ./run-in-docker.sh upgrade <PRIMARY_HOST> v3.8.13