Ubuntu 22.04上规避Docker 23兼容性问题：Kolla-Ansible部署OpenStack Yoga实战指南

当你在Ubuntu 22.04上使用Kolla-Ansible部署OpenStack Yoga时，可能会遇到一个令人头疼的问题：Docker 23版本与Kolla-Ansible的不兼容性。这个问题会导致部署过程中出现KeyError: 'KernelMemory'错误，让整个安装流程戛然而止。本文将深入分析问题根源，并提供一套完整的解决方案，帮助你顺利完成部署。

1. 问题诊断与根源分析

在部署OpenStack Yoga时，很多用户会遇到以下错误日志：

code复制TASK [openstack.kolla.baremetal : Ensure docker containers are running] ********
fatal: [control01]: FAILED! => {"changed": false, "msg": "Error starting container 8f3a8b7c8d1e: 500 Server Error for http+docker://localhost/v1.41/containers/8f3a8b7c8d1e/start: Internal Server Error (\"error while creating mount source path '/var/lib/kolla/volumes/neutron/neutron_server': mkdir /var/lib/kolla/volumes/neutron: permission denied\")"}

更深入的分析会发现，问题的核心在于：

• Docker 23.0.0版本移除了容器配置中的KernelMemory属性
• Kolla-Ansible在Yoga版本中仍然尝试读取这个属性
• 这导致数组下标不存在，引发KeyError异常

关键影响：这个问题不仅影响初始部署，还会在后续添加或删除组件时导致操作失败。

2. 解决方案：强制使用Docker 20.10.*版本

要彻底解决这个问题，我们需要在部署前强制指定安装Docker 20.10.*版本。以下是详细的操作步骤：

2.1 修改Ansible Role配置文件

首先，我们需要修改Kolla-Ansible的baremetal角色配置文件：

bash复制# 备份原始文件
sudo cp /root/.ansible/collections/ansible_collections/openstack/kolla/roles/baremetal/defaults/main.yml /root/.ansible/collections/ansible_collections/openstack/kolla/roles/baremetal/defaults/main.yml.bak

# 修改Docker安装源和版本
sudo sed -i 's/_package: "docker-ce"/_package: "docker-ce=5:20.10*"/g' /root/.ansible/collections/ansible_collections/openstack/kolla/roles/baremetal/defaults/main.yml

2.2 验证Docker版本

执行以下命令验证Docker版本是否正确：

bash复制# 查看Docker版本
docker version --format '{{.Server.Version}}'

预期输出应该是20.10.*格式的版本号。如果显示的是23.x.x，说明配置未生效，需要重新检查前面的步骤。

3. 完整部署流程

现在，我们可以开始完整的OpenStack Yoga部署流程。以下是经过优化的步骤：

3.1 系统准备

1. 更新系统并安装基础依赖：

bash复制sudo apt update
sudo apt install -y git python3-dev libffi-dev gcc libssl-dev python3-venv

2. 创建并激活Python虚拟环境：

bash复制python3 -m venv /opt/kolla-venv
source /opt/kolla-venv/bin/activate

3.2 安装Kolla-Ansible

1. 安装Ansible和Kolla-Ansible：

bash复制pip install 'ansible>=4,<6'
pip install git+https://opendev.org/openstack/kolla-ansible@stable/yoga

2. 准备配置文件：

bash复制sudo mkdir -p /etc/kolla
sudo chown $USER:$USER /etc/kolla
cp -r /opt/kolla-venv/share/kolla-ansible/etc_examples/kolla/* /etc/kolla
cp /opt/kolla-venv/share/kolla-ansible/ansible/inventory/* .

3.3 配置Docker版本

确保已经按照第2章的步骤修改了Docker版本配置。然后安装依赖：

bash复制kolla-ansible install-deps

3.4 部署前检查

1. 生成密码文件：

bash复制kolla-genpwd

2. 修改全局配置文件/etc/kolla/globals.yml：

yaml复制kolla_base_distro: "ubuntu"
network_interface: "eth0"
neutron_external_interface: "eth1"
kolla_internal_vip_address: "10.1.0.250"

3. 运行预检查：

bash复制kolla-ansible -i ./multinode prechecks

3.5 执行部署

bash复制kolla-ansible -i ./multinode deploy

4. 部署后验证与问题排查

部署完成后，需要进行以下验证：

1. 检查所有服务状态：

bash复制kolla-ansible -i ./multinode check

2. 验证Docker容器运行状态：

bash复制docker ps -a

3. 访问Horizon仪表板：

使用VIP地址(如https://10.1.0.250)访问OpenStack仪表板，默认用户名为admin，密码可以在/etc/kolla/passwords.yml中找到。

常见问题排查：

• 如果遇到容器启动失败，检查/var/log/kolla/目录下的日志文件
• 确保所有节点的Docker版本一致
• 检查网络配置是否正确，特别是neutron_external_interface

5. 性能优化建议

成功部署后，可以考虑以下优化措施：

1. Ceph集成：为OpenStack添加分布式存储支持
2. 负载均衡优化：配置Octavia负载均衡器
3. 监控系统：集成Prometheus和Grafana监控
4. 容器优化：调整Docker守护进程参数

bash复制# 示例：调整Docker守护进程配置
sudo tee /etc/docker/daemon.json <<EOF
{
  "log-driver": "json-file",
  "log-opts": {
    "max-size": "100m",
    "max-file": "3"
  },
  "storage-driver": "overlay2"
}
EOF
sudo systemctl restart docker

通过以上步骤，你应该能够在Ubuntu 22.04上成功部署OpenStack Yoga，同时规避Docker 23版本带来的兼容性问题。