Home

K2HR3 OpenStack Notification Listener

K2HR3 OpenStack Notification Listener (k2hr3_osnl) is a program to synchronize the information of OpenStack instances with K2HR3. Here is the data synchronization flow.

• When booting an instance
  • cloud-init will add the instance information to K2HR3
• When deleting an instance
  • k2hr3_osnl will delete the information from K2HR3

Here is how k2hr3_osnl works in details::

• OpenStack nova and neutron emit the deleted instance information to a message queue server.
• k2hr3_osnl receives the deleted instance information from the message queue server.
• The information contains the instance unique id, the hostname and the IP address of the deleted instance.
• k2hr3_osnl invokes K2HR3 RESTful HTTP API with the request parameters that contains the deleted instance information.
• K2HR3 will delete the instance information.

See the https://k2hr3-osnl.readthedocs.io/en/latest/usage.html for details.

FAQ

See the FAQ page.

Tell me the recommended environment for k2hr3_osnl

we tested the k2hr3_osnl in the following environments.

• Linux
  • Debian-9, Fedora-28(29), CentOS-7, Ubuntu-18.04
• OpenStack
  • OpenStack Rocky
• MessageQueue
  • RabbitMQ 3.6.5
• Python
  • Python 3.5 or 3.x higher

Tell me the OpenStack Notification messages formats and the oslo.messaging drivers settings.

See the following pages. You might need to change OpenStack neutron settings(especially the oslo.messaging driver setting).

• The messaging formats of OpenStack nova, neutron
  • https://k2hr3-osnl.readthedocs.io/en/latest/usage.html#parsing-a-message-from-openstack-neutron
  • https://k2hr3-osnl.readthedocs.io/en/latest/usage.html#parsing-versioned-messages-from-openstack-nova
• oslo.messaging
  • https://k2hr3-osnl.readthedocs.io/en/latest/usage.html#listening-to-openstack-service-backend

AntPickax

AntPickax is an open source team in Yahoo Japan Corporation.