一.kolla-ansible 源码的目录结构
kolla-ansible是从kolla项目分离出来的一个可交付的项目，kolla-ansible负责部署容器化的openstack各个服务和基础设施组件。kolla是用于构建docker镜像
[root@openstack01 ansible]# tree -L 2
.
├── action_plugins //actions_plugins目录下存放的是kolla-ansible自定义的ansible插件
│ ├── merge_configs.py //在playbook内通过使用merge_config来合并配置文件模板，生成openstack各服务的配置文件
│ ├── merge_configs.pyc
│ ├── merge_configs.pyo
│ ├── merge_yaml.py
│ ├── merge_yaml.pyc
│ └── merge_yaml.pyo
├── bifrost.yml
├── certificates.yml
├── destroy.yml
├── group_vars
│ └── all.yml //all.yml文件作为ansible的变量文件，定义了各类配置信息。比如：配置文件路径，网卡，IP，端口号，各服务的开启等。与global.yml文件的差别就是，部分的配置已经在global.yml文件内做了定义，global.yml具有更高优先级
├── inventory //inventory目录下存放的是主机清单
│ ├── all-in-one //all-in-one用于单节点的环境下，指定要部署的主机和该主机的角色
│ └── multinode //multinode用于多节点环境，指定要部署的主机和该主机的角色
├── kolla-host.yml
├── library //kolla-ansible自定义的ansible模块
│ ├── bslurp.py //从远程节点获取文件，并分发到更多节点
│ ├── bslurp.pyc
│ ├── bslurp.pyo
│ ├── kolla_container_facts.py //获取容器的facts信息
│ ├── kolla_container_facts.pyc
│ ├── kolla_container_facts.pyo
│ ├── kolla_docker.py //通过调用docker.py来驱动docker，进行启动容器，删除容器的操作
│ ├── kolla_docker.pyc
│ ├── kolla_docker.pyo
│ ├── kolla_toolbox.py //用于调用kolla_toolbox容器内定义的ansible模块
│ ├── kolla_toolbox.pyc
│ ├── kolla_toolbox.pyo
│ ├── merge_configs.py
│ ├── merge_configs.pyc
│ ├── merge_configs.pyo
│ ├── merge_yaml.py
│ ├── merge_yaml.pyc
│ └── merge_yaml.pyo
├── mariadb_recovery.yml
├── post-deploy.yml
├── roles //在实际的业务使用中，不同的业务需要不同的playbook文件，很难维护，这里ansible采用role的方式对playbook进行目录的结构化处理
│ ├── aodh
│ ├── barbican
│ ├── baremetal
│ ├── bifrost
│ ├── blazar
│ ├── ceilometer
│ ├── ceph
│ ├── ceph_pools.yml
│ ├── certificates
│ ├── chrony
│ ├── cinder
│ ├── cloudkitty
│ ├── collectd
│ ├── common
│ ├── congress
│ ├── designate
│ ├── destroy
│ ├── elasticsearch
│ ├── etcd
│ ├── freezer
│ ├── glance
│ ├── gnocchi
│ ├── grafana
│ ├── haproxy
│ ├── heat
│ ├── horizon
│ ├── influxdb
│ ├── ironic
│ ├── iscsi
│ ├── karbor
│ ├── keystone
│ ├── kibana
│ ├── kuryr
│ ├── magnum
│ ├── manila
│ ├── mariadb
│ ├── memcached
│ ├── mistral
│ ├── mongodb
│ ├── multipathd
│ ├── murano
│ ├── neutron
│ ├── nova
│ ├── nova-hyperv
│ ├── octavia
│ ├── opendaylight
│ ├── openvswitch
│ ├── ovs-dpdk
│ ├── panko
│ ├── prechecks
│ ├── qdrouterd
│ ├── rabbitmq
│ ├── rally
│ ├── redis
│ ├── sahara
│ ├── searchlight
│ ├── senlin
│ ├── skydive
│ ├── solum
│ ├── stop
│ ├── swift
│ ├── tacker
│ ├── telegraf
│ ├── tempest
│ ├── trove
│ ├── vitrage
│ ├── vmtp
│ ├── watcher
│ └── zun
├── site.retry
├── site.yml //roles引用的入口文件
└── stop.yml
二. kolla-ansible代码roles目录分析
这里以roles目录下的neutron目录为例进行说明：
[root@openstack01 roles]# tree neutron -L 1
neutron
├── defaults
├── handlers
├── meta
├── tasks
└── templates
roles/neutron目录下有5个文件夹：
- default： 定义了部署neutron各服务的各类参数
- handlers：定义了启动neutron各服务容器的操作
- meta：定义了部署neutron的依赖
- tasks：部署neutron的各playbook
- templates：neutron各服务配置文件的模板
三. neutron目录下的文件分析
[root@openstack01 roles]# tree neutron/
neutron/
├── defaults
│ └── main.yml //作为当前role的变量文件，定义了关于neutron以及neutron各服务的相关参数
├── handlers
│ └── main.yml //创建，启动neutron各服务容器的playbook,但handlers只能在被触发的情况下才会去执行相关被触发的task
├── meta
│ └── main.yml //指定neutron这个role的依赖，从main.yml内容看出实际是依赖于common这个role，也就是在执行neutron的task前，会先去common这个role下执行相关task
├── tasks
│ ├── bootstrap_service.yml //将会启动bootstrap引导容器，用于解决neutron服务所需的依赖配置，在完成后，这些引导容器将被自动删除
│ ├── bootstrap.yml //为neutron创建数据库及数据库用户等
│ ├── check.yml
│ ├── config-neutron-fake.yml
│ ├── config.yml //通过模板为neutron的各个服务生成配置文件
│ ├── deploy.yml
│ ├── ironic-check.yml
│ ├── main.yml //入口执行文件
│ ├── precheck.yml
│ ├── pull.yml
│ ├── reconfigure.yml
│ ├── register.yml
│ └── upgrade.yml
└── templates //templates目录下存放着很多j2格式的文件，他们都是neutron各服务的配置文件模板，这些模板将被config.yml根据需要生成为各服务的配置文件
├── bgp_dragent.ini.j2
├── dhcp_agent.ini.j2
├── dnsmasq.conf.j2
├── fwaas_driver.ini.j2
├── l3_agent.ini.j2
├── lbaas_agent.ini.j2
├── metadata_agent.ini.j2
├── ml2_conf.ini.j2
├── ml2_conf_xenapi.ini.j2
├── neutron-bgp-dragent.json.j2
├── neutron.conf.j2
├── neutron-dhcp-agent.json.j2
├── neutron-l3-agent.json.j2
├── neutron-l3-agent-wrapper.sh.j2
├── neutron-lbaas-agent.json.j2
├── neutron_lbaas.conf.j2
├── neutron-linuxbridge-agent.json.j2
├── neutron-metadata-agent.json.j2
├── neutron-openvswitch-agent.json.j2
├── neutron-openvswitch-agent-xenapi.json.j2
├── neutron-server.json.j2
├── neutron-sriov-agent.json.j2
├── neutron-vpnaas-agent.json.j2
├── neutron-vpnaas-agent-wrapper.sh.j2
├── neutron_vpnaas.conf.j2
├── nsx.ini.j2
├── sriov_agent.ini.j2
└── vpnaas_agent.ini.j2
四. kolla-ansible部署过程代码调用
执行kolla-anisble -i multinode deploy 时调用如下：
执行的命令如下：
这里我们解析下CMD命令：
ansible-playbook -i multinode -e @/etc/kolla/globals.yml -e @/etc/kolla/passwords.yml -e CONFIG_DIR=/etc/kolla -e action=deploy /usr/share/kolla-ansible/ansible/site.yml
其中INVENTORY参数表示multinode文件，主要是指定主机角色 CONFIG_OPTS指定globals.yml,passwords.yml，配置文件目录，主要是指定一些配置相关。EXTRA_OPTS主要是指定执行的动作，PLAYBOOK为roles的入口文件site.yml
因此调用的过程也就是：
kolla-ansible -i multinode deploy ---->调用/usr/share/kolla-ansible/ansible/site.yml ---->根据site.yml文件的task调用执行各role