Deploy OpenStack designate with kolla-ansible

Blog
Search…
Blog
Welcome to egonzalez blog
Hacking
Index
OpenStack
Docker and DevOps
Index
Deploy OpenStack designate with kolla-ansible
During Ocata release, OpenStack DNS-as-a-Service (Designate) support was implemented in OpenStack kolla project.
This post will guide you through a basic deployment and tests of designate service.
Install required dependencies and tools for kolla-ansible and designate.
1
# yum install -y epel-release
2
# yum install -y python-pip python-devel libffi-devel gcc openssl-devel ansible ntp wget bind-utils
3
# pip install -U pip
Copied!
Install Docker and downgrade to 1.12.6. At the time of writing this post libvirt had issues to connect with D-Bus due SElinux issues with Docker 1.13.
1
# curl -sSL https://get.docker.io | bash
2
# yum downgrade docker-engine-1.12.6 docker-engine-selinux-1.12.6
3
# yum install -y python-docker-py
Copied!
Configure Docker daemon to allow insecure-registry (Use the IP where your remote registry will be located).
1
# mkdir -p /etc/systemd/system/docker.service.d
2
# tee /etc/systemd/system/docker.service.d/kolla.conf <<-'EOF'
3
[Service]
4
ExecStart=
5
ExecStart=/usr/bin/dockerd --insecure-registry 172.28.128.3:4000
6
MountFlags=shared
7
EOF
Copied!
Reload systemd daemons and start/stop/disable/enable the following services.
1
# systemctl daemon-reload
2
# systemctl stop libvirtd
3
# systemctl disable libvirtd
4
# systemctl enable ntpd docker
5
# systemctl start ntpd docker
Copied!
Download Ocata registry created in tarballs.openstack.org, skip this step if images used are custom builds or downloaded from DockerHub. 
Create kolla registry from downloaded tarball.
1
# wget https://tarballs.openstack.org/kolla/images/centos-binary-registry-ocata.tar.gz
2
# mkdir /opt/kolla_registry
3
# sudo tar xzf centos-binary-registry-ocata.tar.gz -C /opt/kolla_registry
4
# docker run -d -p 4000:5000 --restart=always -v /opt/kolla_registry/:/var/lib/registry --name registry registry:2
Copied!
Install kolla-ansible.
1
# pip install kolla-ansible
2
# cp -r /usr/share/kolla-ansible/etc_examples/kolla /etc/kolla/
3
# cp /usr/share/kolla-ansible/ansible/inventory/* .
Copied!
Configure kolla globals.yml configuration file with the following content. 
Change values when necessary (IP addresses, interface names). 
This is a sample minimal configuration.
1
# vi /etc/kolla/globals.yml
2
---
3
kolla_internal_vip_address: "172.28.128.10"
4
kolla_base_distro: "centos"
5
kolla_install_type: "binary"
6
docker_registry: "172.28.128.3:4000"
7
docker_namespace: "lokolla"
8
network_interface: "enp0s8"
9
neutron_external_interface: "enp0s9"
Copied!
Configure designate options in globals.yml. 
dns_interface must be network reachable from nova instances if internal DNS resolution is needed.
1
enable_designate: "yes"
2
dns_interface: "enp0s8"
3
designate_backend: "bind9"
4
designate_ns_record: "sample.openstack.org"
Copied!
Configure inventory, add the nodes in their respective groups.
1
# vi ~/multinode
Copied!
Generate passwords.
1
# kolla-genpwd
Copied!
Ensure the environment is ready to deploy with prechecks. Until prechecks does not succeed do not start deployment. Fix what is necessary.
1
# kolla-ansible prechecks -i ~/multinode
Copied!
Pull Docker images on the servers, this can be skipped because will be made in deploy step, but doing it first will ensure all the nodes have the images you need and will minimize the deployment time.
1
# kolla-ansible pull -i ~/multinode
Copied!
Deploy kolla-ansible and do a woot for kolla ;)
1
# kolla-ansible deploy -i ~/multinode
Copied!
Create credentials file and source it.
1
# kolla-ansible post-deploy -i ~/multinode
2
# source /etc/kolla/admin-openrc.sh
Copied!
Check that all containers are running and none of them are restarting or exiting.
1
# docker ps -a --filter status=exited --filter status=restarting
2
CONTAINER ID        IMAGE               COMMAND             CREATED             STATUS              PORTS               NAMES
Copied!
Install required python clients
1
# pip install python-openstackclient python-designateclient python-neutronclient
Copied!
Execute a base OpenStack configuration (public and internal networks, cirros image). 
Do no execute this script if custom networks are going to be used.
1
# sh /usr/share/kolla-ansible/init-runonce
Copied!
Create a sample designate zone.
1
# openstack zone create --email [email protected] sample.openstack.org.
2
+----------------+--------------------------------------+
3
| Field          | Value                                |
4
+----------------+--------------------------------------+
5
| action         | CREATE                               |
6
| attributes     |                                      |
7
| created_at     | 2017-02-22T13:14:39.000000           |
8
| description    | None                                 |
9
| email          | [email protected]           |
10
| id             | 4a44b0c9-bd07-4f5c-8908-523f453f269d |
11
| masters        |                                      |
12
| name           | sample.openstack.org.                |
13
| pool_id        | 85d18aec-453e-45ae-9eb3-748841a1da12 |
14
| project_id     | 937d49af6cfe4ef080a79f9a833d7c7d     |
15
| serial         | 1487769279                           |
16
| status         | PENDING                              |
17
| transferred_at | None                                 |
18
| ttl            | 3600                                 |
19
| type           | PRIMARY                              |
20
| updated_at     | None                                 |
21
| version        | 1                                    |
22
+----------------+--------------------------------------+
Copied!
Configure designate sink to make use of the previously created zone, sink will need zone_id to automatically create neutron and nova records into designate.
1
# mkdir -p /etc/kolla/config/designate/designate-sink/
2
# vi /etc/kolla/config/designate/designate-sink.conf
3
[handler:nova_fixed]
4
zone_id = 4a44b0c9-bd07-4f5c-8908-523f453f269d
5
[handler:neutron_floatingip]
6
zone_id = 4a44b0c9-bd07-4f5c-8908-523f453f269d
Copied!
After configure designate-sink.conf, reconfigure designate to make use of this configuration.
1
# kolla-ansible reconfigure -i ~/multinode --tags designate
Copied!
List networks.
1
# neutron net-list
2
+--------------------------------------+----------+----------------------------------+--------------------------------------------------+
3
| id                                   | name     | tenant_id                        | subnets                                          |
4
+--------------------------------------+----------+----------------------------------+--------------------------------------------------+
5
| 3b56c605-5a01-45be-9ed6-e4c3285e4366 | demo-net | 937d49af6cfe4ef080a79f9a833d7c7d | 7f28f050-77b2-426e-b963-35b682077993 10.0.0.0/24 |
6
| 6954d495-fb8c-4b0b-98a9-9672a7f65b7c | public1  | 937d49af6cfe4ef080a79f9a833d7c7d | 9bd9feca-40a7-4e82-b912-e51b726ad746 10.0.2.0/24 |
7
+--------------------------------------+----------+----------------------------------+--------------------------------------------------+
Copied!
Update the network with a dns_domain.
1
# neutron net-update 3b56c605-5a01-45be-9ed6-e4c3285e4366 --dns_domain sample.openstack.org.
2
Updated network: 3b56c605-5a01-45be-9ed6-e4c3285e4366
Copied!
Ensure dns_domain is properly applied.
1
# neutron net-show 3b56c605-5a01-45be-9ed6-e4c3285e4366
2
+---------------------------+--------------------------------------+
3
| Field                     | Value                                |
4
+---------------------------+--------------------------------------+
5
| admin_state_up            | True                                 |
6
| availability_zone_hints   |                                      |
7
| availability_zones        | nova                                 |
8
| created_at                | 2017-02-22T13:13:06Z                 |
9
| description               |                                      |
10
| dns_domain                | sample.openstack.org.                |
11
| id                        | 3b56c605-5a01-45be-9ed6-e4c3285e4366 |
12
| ipv4_address_scope        |                                      |
13
| ipv6_address_scope        |                                      |
14
| mtu                       | 1450                                 |
15
| name                      | demo-net                             |
16
| port_security_enabled     | True                                 |
17
| project_id                | 937d49af6cfe4ef080a79f9a833d7c7d     |
18
| provider:network_type     | vxlan                                |
19
| provider:physical_network |                                      |
20
| provider:segmentation_id  | 27                                   |
21
| revision_number           | 6                                    |
22
| router:external           | False                                |
23
| shared                    | False                                |
24
| status                    | ACTIVE                               |
25
| subnets                   | 7f28f050-77b2-426e-b963-35b682077993 |
26
| tags                      |                                      |
27
| tenant_id                 | 937d49af6cfe4ef080a79f9a833d7c7d     |
28
| updated_at                | 2017-02-22T13:25:16Z                 |
29
+---------------------------+--------------------------------------+
Copied!
Create a new instance in the previously updated network.
1
# openstack server create \
2
    --image cirros \
3
    --flavor m1.tiny \
4
    --key-name mykey \
5
    --nic net-id=3b56c605-5a01-45be-9ed6-e4c3285e4366 \
6
    demo1
Copied!
Once the instance is ACTIVE, check the IP associated.
1
# openstack server list
2
+--------------------------------------+-------+--------+-------------------+------------+
3
| ID                                   | Name  | Status | Networks          | Image Name |
4
+--------------------------------------+-------+--------+-------------------+------------+
5
| d483e4ee-58c2-4e1e-9384-85174630428e | demo1 | ACTIVE | demo-net=10.0.0.3 | cirros     |
6
+--------------------------------------+-------+--------+-------------------+------------+
Copied!
List records in the designate zone.
As you can see there is a record in designate associated with the instance IP.
1
# openstack recordset list sample.openstack.org.
2
+--------------------------------------+----------------------------------+------+-------------------------------------------+--------+--------+
3
| id                                   | name                             | type | records                                   | status | action |
4
+--------------------------------------+----------------------------------+------+-------------------------------------------+--------+--------+
5
| 4f70531e-c325-4ffd-a8d3-8172bd5163b8 | sample.openstack.org.            | SOA  | sample.openstack.org.                     | ACTIVE | NONE   |
6
|                                      |                                  |      | admin.sample.openstack.org. 1487770304    |        |        |
7
|                                      |                                  |      | 3586 600 86400 3600                       |        |        |
8
| a9a09c5f-ccf1-4b52-8400-f36e8faa9549 | sample.openstack.org.            | NS   | sample.openstack.org.                     | ACTIVE | NONE   |
9
| aa6cd25d-186e-425b-9153-699d8b0811de | 10-0-0-3.sample.openstack.org.   | A    | 10.0.0.3                                  | ACTIVE | NONE   |
10
| 713650a5-a45e-470b-9539-74e110b15115 | demo1.None.sample.openstack.org. | A    | 10.0.0.3                                  | ACTIVE | NONE   |
11
| 6506e6f6-f535-45eb-9bfb-4ac1f16c5c9b | demo1.sample.openstack.org.      | A    | 10.0.0.3                                  | ACTIVE | NONE   |
12
+--------------------------------------+----------------------------------+------+-------------------------------------------+--------+--------+
Copied!
Validate that designate resolves the DNS record. 
You can use designate mDNS service or directly to bind9 servers to validate the test.
1
# dig +short -p 5354 @172.28.128.3 demo1.sample.openstack.org. A
2
10.0.0.3
3
# dig +short -p 53 @172.28.128.3 demo1.sample.openstack.org. A
4
10.0.0.3
Copied!
If you find any issue with designate in kolla-ansible or kolla, please fill a bug https://bugs.launchpad.net/kolla-ansible/+filebug​
Regards, Eduardo Gonzalez
OpenStack tacker and service function chaining sfc with kolla
OpenStack keystone zero downtime upgrade process newton to ocata
Last modified 1yr ago
Copy link