Juju Charm - Open Virtual Network - Central components
Go to file
Martin Kalcok 360b63bf3c Remove jammy-antelope test bundle
This combination is no longer run by CI.

Change-Id: If9709b1f0eb679d0d0afb927fb32614ae515d13b
2024-04-22 15:27:54 +02:00
src Remove jammy-antelope test bundle 2024-04-22 15:27:54 +02:00
unit_tests Add ovn cert nrpe check 2023-08-23 13:03:17 +01:00
.gitignore Remove the charm artifact from the repository 2022-03-16 11:19:10 +00:00
.gitreview Add gerrit and zuul bits 2019-10-18 13:03:57 +02:00
.stestr.conf Initial commit of charm skeleton 2019-08-21 11:02:42 +02:00
.travis.yml Fix remote clustering after moving local addr code to interface 2019-10-11 13:58:59 +02:00
.zuul.yaml Add Antelope support 2023-03-21 00:04:17 +00:00
LICENSE Initial commit of charm skeleton 2019-08-21 11:02:42 +02:00
README.md Fix DB connection configuration for ``ovn-northd`` 2019-10-25 09:52:05 +02:00
bindep.txt Add Kinetic and Zed support 2022-09-21 16:49:58 +00:00
charmcraft.yaml Remove Lunar (23.04) support. 2024-04-22 13:42:46 +02:00
metadata.yaml Update to build using charmcraft 2022-02-15 14:51:59 +00:00
osci.yaml Pin charmcraft to 2.2/stable 2024-04-18 11:47:06 +01:00
pylintrc Add ovn cert nrpe check 2023-08-23 13:03:17 +01:00
rebuild Fix use of ``openstack-release`` to determine codename 2022-02-24 08:04:17 +01:00
rename.sh Update to build using charmcraft 2022-02-15 14:51:59 +00:00
requirements.txt Add Kinetic and Zed support 2022-09-21 16:49:58 +00:00
test-requirements.txt Add Kinetic and Zed support 2022-09-21 16:49:58 +00:00
tox.ini Add ovn cert nrpe check 2023-08-23 13:03:17 +01:00

README.md

Overview

The ovn-central charm provides the Northbound and Southbound OVSDB Databases and the Open Virtual Network (OVN) central control daemon (ovn-northd). It is used in conjunction with either the ovn-chassis subordinate charm or the ovn-dedicated-chassis principle charm.

Note: The OVN charms are supported starting with OpenStack Train.

Usage

The OpenStack Base bundle gives an example of how you can deploy OpenStack and OVN with Vault to automate certificate lifecycle management.

OVN makes use of Public Key Infrastructure (PKI) to authenticate and authorize control plane communication. The charm therefore requires a Certificate Authority to be present in the model as represented by the certificates relation.

Refer to Open Virtual Network (OVN) in the OpenStack Charms Deployment Guide for details, including deployment steps.

Note: The ovn-central charm requires a minimum of three units to operate.

Network spaces

This charm supports the use of Juju network spaces.

By binding the ovsdb, ovsdb-cms and ovsdb-peer endpoints you can influence which interface will be used for communication with consumers of the Southbound DB, Cloud Management Systems (CMS) and cluster internal communication.

juju deploy -n 3 --series focal \
    --bind "''=oam-space ovsdb=data-space" \
    ovn-central

OVN RBAC and securing the OVN services

The charm enables RBAC in the OVN Southbound database by default. The RBAC feature enforces authorization of individual chassis connecting to the database, and also restricts database operations.

In the event of an individual chassis being compromised, RBAC will make it more difficult to leverage database access for compromising other parts of the network.

Note: Due to how RBAC is implemented in ovsdb-server the charm opens up a separate listener at port 16642 for connections from ovn-northd.

The charm automatically enables the firewall and will allow traffic from its cluster peers to port 6641, 6643, 6644 and 16642. CMS clients will be allowed to talk to port 6641.

Anyone will be allowed to connect to port 6642.

Deferred service events

Operational or maintenance procedures applied to a cloud often lead to the restarting of various OpenStack services and/or the calling of certain charm hooks. Although normal, such events can be undesirable due to the service interruptions they can cause.

The deferred service events feature provides the operator the choice of preventing these service restarts and hook calls from occurring, which can then be resolved at a more opportune time.

See the Deferred service events page in the OpenStack Charms Deployment Guide for an in-depth treatment of this feature.

Bugs

Please report bugs on Launchpad.

For general questions please refer to the OpenStack Charm Guide.