一、 基础环境准备

1：虚拟机版本

本环境中使用的是centos7,9,内核版本为3.10.0-1160

安装docker

yum install docker-ce

启动docker服务

systemctl start docker 

2：安装pip命令

由于最小化安装的系统没有pip命令，需要手动安装，如下：

[root@kolla ~]# yum install python-pip

rpm –qa| grep pip查询已经安装的pip包

更新pip版本，之后安装其他其他软件时会提示pip版本低，可以先提前更新，如下：
注意pip版本，版本太高会引发问题
pip install --upgrade 'pip<20'

3：下载kolla的源码包以及openstack各个模块的源码包

openstack源码包如下：
下载地址https://tarballs.opendev.org/openstack/。选择需要的模块下载即可

确认kolla源码包，如下：
进入kolla目录，确认目前分支是stable/train，如下：
如果不是，使用git  checkout  stable/train命令切换分支
或者下载的时候直接-b指定分支下载，如下：
git clone https://github.com/openstack/kolla -b stable/train

4：更新ca证书文件

安装软件过程部分包要访问https等网站，部分网站根证书已更新，系统内证书有过期。

yum install ca-certificates

使用如下命令更新系统内部证书。
update-ca-trust
编辑/etc/pip.conf文件，添加如下内容：
添加pip源信任证书文件

创建软链接：

Kola-build时需要ssl认证: ln -s /etc/pki/tls/certs/ca-bundle.crt /usr/lib/python2.7/site-packages/pip/_vendor/certifi/cacert.pem

5：安装kolla-build环境

切换到kolla目录，执行如下命令安装pip包。

pip install --ignore-installed  -c https://opendev.org/openstack/requirements/raw/branch/stable/train/upper-constraints.txt -r requirements.txt
指定-c，否则 默认安装master版本的pip源

以上错误可忽略
执行python setup.py install，安装kolla-build命令

出现以上错误，说明系统系统setuptools版本低，需要升级，执行如下命令：
pip install --upgrade setuptools

再一次执行python setup.py install命令正常安装，如下：


Kolla-build命令可正常使用,如下：

6：部署docker registry

Kolla-build的镜像方便之后打包需要上传到的registry

1：从docker hub官方网站下载registry镜像

docker pull registry

2：启动registry容器

docker run -d -v /opt/registry:/var/lib/registry -p 5000:5000 --restart=always --name registry registry：latest

3：配置私有仓库地址

编辑/etc/docker/daemon.json文件

重启docker服务：

systemctl restart docker

4：查看registry的中的镜像

因为目前还未上传镜像，所以为空

二、 kolla-build构建镜像

1：编辑配置文件

1：编辑kolla-build.conf文件

install-type：选择从源码包安装
push： 是否上传到registry
registry: registry仓库地址
tag: 指定镜像标签
profiles： 定义指定安装的组件
keystone-base: 模块配置
type；源码安装方式，已经下载源码，选择local
location：源码存放位置，文件格式为.tar.gz

2：编辑template-override.conf文件

在此文件中会指定使用的pip源，如下：

2：镜像构建

1：开始构建

执行如下命令直接构建镜像，如下：

kolla-build --config-file kolla-build.conf --logs-dir /opt/ --template-override template-override.conf

接下来有一段较长的镜像构建时间，如果出现异常中断，可重复执行。依赖于 docker 的 Build Cache 功能，能为重跑追回不少时间。

2：查看构建好的镜像

等待build完成之后，可以使用docker images 命令查看

查看registry中上传的镜像，如下：

curl 127.0.0.1:5000/v2/_catalog

可以使用如下命令将registry目录打包：

3：镜像层级

Kolla 构建的镜像一般有四层，Docker 的镜像分层结构更有利于抽象环境依赖集，降低依赖包重复率，提高镜像传输率

•	base image：提供一个最基本的操作系统环境，几乎是所有镜像的基础。
•	openstack-base image：所有 OpenStack 服务镜像的基础，安装了 Service 层级的依赖集。
•	<project>-base image：某个项目的基础，安装了 Project 层级的依赖集。
•	<service>-image：一个具体 Service 的特异依赖集，设置了服务启动入口

三、kolla-ansible使用

1：kolla-ansible的安装

下载安装包：

可以从https://tarballs.opendev.org/openstack/kolla-ansible/下载，目前环境中使用的kolla-ansible版本是9.1.0,,可选择下载相应的tar.gz的安装包。
git clone https://github.com/openstack/kolla-ansible -b stable/train 

本次使用的tar.gz的安装包。上传系统进行解压,tar –zxvf kolla-ansible-9.1.0.tar.gz
如下

进入kolla-ansible-9.1.0目录，安装kolla-ansible环境

pip install -r requirements.txt

安装kolla-ansible

python setup.py install

pip查看kolla-ansible

2：kolla-ansible的配置

1：配置主机清单文件

拷贝文件至root目录
/usr/share/kolla-ansible/ansible/inventory目录下有两个文件all-in-one和multinode。
可根据自己的环境选择，本次选择的是multinode

编辑multinode文件

2：配置global以及密码文件

进入/usr/share/kolla-ansible/etc_examples/kolla目录下，拷贝文件至/etc/kolla目录（没有新建即可），如下：

生成密码文件（默认passwords.yml为空）：

配置global.yml文件vim /etc/kola/global.yml

kolla_base_distro: "centos"
kolla_install_type: "source"
openstack_release: "train"
kolla_internal_vip_address: "192.168.88.132"
docker_registry: "192.168.88.129:5000"
docker_namespace: "kolla"
network_interface: "eth0"
neutron_external_interface: "eth1"
enable_ceph: "yes"
enable_cinder: "yes"
glance_backend_ceph: "yes"
cinder_backend_ceph: "{{ enable_ceph }}"
其他值默认皆可，可根据需求开启
##########################################################
openstack_release：需要与镜像的 Tag 一致，否则部署时找不到镜像。
network_interface：指定管理网接口
neutron_external_interface：指定业务网卡
kolla_internal_vip_address：指定 HAProxy 虚拟 IP，单点部署可以弃用 HAProxy enable_haproxy: "no"

3：为磁盘打标签

此版本中kolla-ansible默认ceph使用的bluestore，因此使用如下命令为磁盘打标签

parted /dev/sdb -s -- mklabel gpt mkpart KOLLA_CEPH_OSD_BOOTSTRAP_BS 1 -1

4：部署openstack

检测配置是否配置正确
kolla-ansible -i /root/multinode prechecks
开始部署
kolla-ansible -i /root/multimode deploy
生成环境变量
kolla-ansible post-deploy