octavia 15.0.0__py3-none-any.whl → 16.0.0__py3-none-any.whl

octavia/tests/unit/network/drivers/neutron/test_allowed_address_pairs.py

@@ -326,6 +326,9 @@ class TestAllowedAddressPairsDriver(base.TestCase):
         lb_mock.id = LB_ID
         vip_mock = mock.MagicMock()
         vip_mock.port_id = VIP_PORT_ID
+        vip_sg = mock.MagicMock()
+        vip_sg.id = uuidutils.generate_uuid()
+        vip_mock.sg_ids = [vip_sg.id]
         security_group_dict = {'id': SG_ID}
         mock_get_sg_name.return_value = TEST_SG_NAME
 
@@ -358,7 +361,7 @@ class TestAllowedAddressPairsDriver(base.TestCase):
         test_driver._update_security_group_rules.assert_called_once_with(
             lb_mock, SG_ID)
         test_driver._add_vip_security_group_to_port.assert_called_once_with(
-            LB_ID, VIP_PORT_ID, SG_ID)
+            LB_ID, VIP_PORT_ID, SG_ID, vip_sg_ids=[vip_sg.id])
 
         # Test by security group name
         test_driver._add_vip_security_group_to_port.reset_mock()
@@ -374,7 +377,60 @@ class TestAllowedAddressPairsDriver(base.TestCase):
         test_driver._update_security_group_rules.assert_called_once_with(
             lb_mock, SG_ID)
         test_driver._add_vip_security_group_to_port.assert_called_once_with(
-            LB_ID, VIP_PORT_ID, SG_ID)
+            LB_ID, VIP_PORT_ID, SG_ID, vip_sg_ids=[vip_sg.id])
+
+    def test_update_aap_port_sg(self):
+        LB_ID = uuidutils.generate_uuid()
+        SG_ID = uuidutils.generate_uuid()
+        VIP_PORT_ID = uuidutils.generate_uuid()
+        VRRP_PORT_ID = uuidutils.generate_uuid()
+        lb_mock = mock.MagicMock()
+        lb_mock.id = LB_ID
+        amp_mock = mock.MagicMock()
+        amp_mock.vrrp_port_id = VRRP_PORT_ID
+        vip_mock = mock.MagicMock()
+        vip_mock.port_id = VIP_PORT_ID
+        vip_sg = mock.MagicMock()
+        vip_sg.id = uuidutils.generate_uuid()
+        vip_mock.sg_ids = [vip_sg.id]
+        security_group_dict = {'id': SG_ID}
+
+        test_driver = allowed_address_pairs.AllowedAddressPairsDriver()
+
+        test_driver._add_vip_security_group_to_port = mock.MagicMock()
+        test_driver._create_security_group = mock.MagicMock()
+        test_driver._get_lb_security_group = mock.MagicMock()
+        test_driver._update_security_group_rules = mock.MagicMock()
+        test_driver._get_lb_security_group.side_effect = [security_group_dict,
+                                                          None]
+
+        # Test security groups disabled
+        test_driver.sec_grp_enabled = False
+
+        test_driver.update_aap_port_sg(lb_mock, amp_mock, vip_mock)
+
+        test_driver._add_vip_security_group_to_port.assert_not_called()
+        test_driver._get_lb_security_group.assert_not_called()
+        test_driver._update_security_group_rules.assert_not_called()
+
+        # Normal path
+        test_driver.sec_grp_enabled = True
+
+        test_driver.update_aap_port_sg(lb_mock, amp_mock, vip_mock)
+
+        test_driver._update_security_group_rules.assert_not_called()
+        test_driver._add_vip_security_group_to_port.assert_called_once_with(
+            LB_ID, VRRP_PORT_ID, SG_ID, vip_sg_ids=[vip_sg.id])
+
+        # No LB SG
+        test_driver._add_vip_security_group_to_port.reset_mock()
+        test_driver._get_lb_security_group.reset_mock()
+        test_driver._update_security_group_rules.reset_mock()
+
+        test_driver.update_aap_port_sg(lb_mock, amp_mock, vip_mock)
+
+        test_driver._update_security_group_rules.assert_not_called()
+        test_driver._add_vip_security_group_to_port.assert_not_called()
 
     def test_plug_aap_port(self):
         lb = dmh.generate_load_balancer_tree()
@@ -940,47 +996,6 @@ class TestAllowedAddressPairsDriver(base.TestCase):
         mock_unplug_network.assert_called_once_with(
             lb.amphorae[0].compute_id, subnet.network_id)
 
-    def test_plug_network_when_compute_instance_cant_be_found(self):
-        net_id = t_constants.MOCK_NOVA_INTERFACE.net_id
-        network_attach = self.driver.compute.attach_network_or_port
-        network_attach.side_effect = exceptions.NotFound(
-            resource='Instance not found', id=1)
-        self.assertRaises(network_base.AmphoraNotFound,
-                          self.driver.plug_network,
-                          t_constants.MOCK_COMPUTE_ID, net_id)
-
-    def test_plug_network_when_network_cant_be_found(self):
-        net_id = t_constants.MOCK_NOVA_INTERFACE.net_id
-        network_attach = self.driver.compute.attach_network_or_port
-        network_attach.side_effect = nova_exceptions.NotFound(
-            404, message='Network not found')
-        self.assertRaises(network_base.NetworkException,
-                          self.driver.plug_network,
-                          t_constants.MOCK_COMPUTE_ID, net_id)
-
-    def test_plug_network_when_interface_attach_fails(self):
-        net_id = t_constants.MOCK_NOVA_INTERFACE.net_id
-        network_attach = self.driver.compute.attach_network_or_port
-        network_attach.side_effect = TypeError
-        self.assertRaises(network_base.PlugNetworkException,
-                          self.driver.plug_network,
-                          t_constants.MOCK_COMPUTE_ID, net_id)
-
-    def test_plug_network(self):
-        net_id = t_constants.MOCK_NOVA_INTERFACE.net_id
-        network_attach = self.driver.compute.attach_network_or_port
-        network_attach.return_value = t_constants.MOCK_NOVA_INTERFACE
-        oct_interface = self.driver.plug_network(
-            t_constants.MOCK_COMPUTE_ID, net_id)
-        exp_ips = [fixed_ip.get('ip_address')
-                   for fixed_ip in t_constants.MOCK_NOVA_INTERFACE.fixed_ips]
-        actual_ips = [fixed_ip.ip_address
-                      for fixed_ip in oct_interface.fixed_ips]
-        self.assertEqual(exp_ips, actual_ips)
-        self.assertEqual(t_constants.MOCK_COMPUTE_ID,
-                         oct_interface.compute_id)
-        self.assertEqual(net_id, oct_interface.network_id)
-
     def test_unplug_network_when_compute_port_cant_be_found(self):
         net_id = t_constants.MOCK_NOVA_INTERFACE.net_id
         list_ports = self.driver.network_proxy.ports
@@ -1071,7 +1086,8 @@ class TestAllowedAddressPairsDriver(base.TestCase):
         fake_rules = [
             {'id': 'rule-80', 'port_range_max': 80, 'protocol': 'tcp',
              'remote_ip_prefix': '10.0.101.0/24'},
-            {'id': 'rule-22', 'port_range_max': 22, 'protocol': 'tcp'}
+            {'id': 'rule-22', 'port_range_max': 22, 'protocol': 'tcp'},
+            {'id': 'rule-None', 'port_range_max': 22},
         ]
         list_rules = self.driver.network_proxy.security_group_rules
         list_rules.return_value = fake_rules
@@ -1557,7 +1573,8 @@ class TestAllowedAddressPairsDriver(base.TestCase):
             'fixed_ips': [{'ip_address': IP_ADDRESS1,
                            'subnet_id': SUBNET1_ID}],
             'security_groups': [],
-            'qos_policy_id': QOS_POLICY_ID})
+            'qos_policy_id': QOS_POLICY_ID,
+            'binding_vnic_type': constants.VNIC_TYPE_NORMAL})
 
         reference_port_dict = {'admin_state_up': ADMIN_STATE_UP,
                                'device_id': t_constants.MOCK_DEVICE_ID,

octavia/tests/unit/network/drivers/neutron/test_base.py

@@ -85,28 +85,28 @@ class TestBaseNeutronNetworkDriver(base.TestCase):
         self.driver.network_proxy.update_port.assert_has_calls([
             mock.call(t_constants.MOCK_PORT_ID, **expected_aap_dict)])
 
-    def test__add_security_group_to_port(self):
-        self.driver._add_security_group_to_port(
-            t_constants.MOCK_SECURITY_GROUP_ID, t_constants.MOCK_PORT_ID)
+    def test__update_security_groups(self):
+        self.driver._update_security_groups(
+            [t_constants.MOCK_SECURITY_GROUP_ID], t_constants.MOCK_PORT_ID)
         expected_sg_dict = {
             'security_groups': [
                 t_constants.MOCK_SECURITY_GROUP_ID]}
         self.driver.network_proxy.update_port.assert_has_calls([
             mock.call(t_constants.MOCK_PORT_ID, **expected_sg_dict)])
 
-    def test__add_security_group_to_port_with_port_not_found(self):
+    def test__update_security_groups_with_port_not_found(self):
         self.driver.network_proxy.update_port.side_effect = (
             os_exceptions.ResourceNotFound)
         self.assertRaises(
             network_base.PortNotFound,
-            self.driver._add_security_group_to_port,
+            self.driver._update_security_groups,
             t_constants.MOCK_SECURITY_GROUP_ID, t_constants.MOCK_PORT_ID)
 
-    def test__add_security_group_to_port_with_other_exception(self):
+    def test__update_security_groups_with_other_exception(self):
         self.driver.network_proxy.update_port.side_effect = IOError
         self.assertRaises(
             network_base.NetworkException,
-            self.driver._add_security_group_to_port,
+            self.driver._update_security_groups,
             t_constants.MOCK_SECURITY_GROUP_ID, t_constants.MOCK_PORT_ID)
 
     def test__get_ports_by_security_group(self):

octavia/tests/unit/network/drivers/noop_driver/test_driver.py

@@ -15,6 +15,7 @@ from unittest import mock
 
 from oslo_utils import uuidutils
 
+from octavia.common import constants
 from octavia.db import models
 from octavia.network import data_models as network_models
 from octavia.network.drivers.noop_driver import driver
@@ -32,7 +33,16 @@ class TestNoopNetworkDriver(base.TestCase):
 
     def setUp(self):
         super().setUp()
-        self.driver = driver.NoopNetworkDriver()
+        self.mock_engine = mock.MagicMock()
+        with mock.patch('octavia.network.drivers.noop_driver.driver.'
+                        'create_engine') as mock_create_engine:
+            mock_create_engine.return_value = self.mock_engine
+            with mock.patch('octavia.network.drivers.noop_driver.'
+                            'driver.event'):
+                self.driver = driver.NoopNetworkDriver()
+            mock_create_engine.assert_called_once_with(
+                'sqlite:////tmp/octavia-network-noop.db')
+
         self.port = mock.MagicMock()
         self.port_id = 88
         self.port_name = 'port1'
@@ -40,12 +50,12 @@ class TestNoopNetworkDriver(base.TestCase):
         self.network_id = self.FAKE_UUID_3
         self.network_name = 'net1'
         self.device_id = self.FAKE_UUID_4
-        self.ip_address = "10.0.0.2"
+        self.ip_address = "192.0.2.2"
         self.load_balancer = models.LoadBalancer()
         self.load_balancer.id = self.FAKE_UUID_2
 
         self.vip = models.Vip()
-        self.vip.ip_address = "10.0.0.1"
+        self.vip.ip_address = "192.0.2.1"
         self.vip.subnet_id = uuidutils.generate_uuid()
         self.vip.port_id = uuidutils.generate_uuid()
         self.amphora_id = self.FAKE_UUID_1
@@ -61,15 +71,15 @@ class TestNoopNetworkDriver(base.TestCase):
         self.amphora1.compute_id = self.compute_id
         self.amphora1.vrrp_port_id = uuidutils.generate_uuid()
         self.amphora1.ha_port_id = uuidutils.generate_uuid()
-        self.amphora1.vrrp_ip = '10.0.1.10'
-        self.amphora1.ha_ip = '10.0.1.11'
+        self.amphora1.vrrp_ip = '192.0.2.10'
+        self.amphora1.ha_ip = '192.0.2.11'
         self.amphora2 = models.Amphora()
         self.amphora2.id = uuidutils.generate_uuid()
         self.amphora2.compute_id = self.compute2_id
         self.amphora2.vrrp_port_id = uuidutils.generate_uuid()
         self.amphora2.ha_port_id = uuidutils.generate_uuid()
-        self.amphora2.vrrp_ip = '10.0.2.10'
-        self.amphora2.ha_ip = '10.0.2.11'
+        self.amphora2.vrrp_ip = '192.0.2.20'
+        self.amphora2.ha_ip = '192.0.2.21'
         self.load_balancer.amphorae = [self.amphora1, self.amphora2]
         self.load_balancer.vip = self.vip
         self.subnet = mock.MagicMock()
@@ -95,6 +105,14 @@ class TestNoopNetworkDriver(base.TestCase):
                          self.driver.driver.networkconfigconfig[(
                              self.load_balancer.id, self.vip.ip_address)])
 
+    def test_update_aap_port_sg(self):
+        self.driver.update_aap_port_sg(self.load_balancer, self.amphora1,
+                                       self.vip)
+        self.assertEqual((self.load_balancer, self.vip, self.amphora1,
+                          'update_aap_port_sg'),
+                         self.driver.driver.networkconfigconfig[(
+                             self.amphora1.id, self.vip.ip_address)])
+
     def test_unplug_vip(self):
         self.driver.unplug_vip(self.load_balancer, self.vip)
         self.assertEqual((self.load_balancer, self.vip,
@@ -102,12 +120,6 @@ class TestNoopNetworkDriver(base.TestCase):
                          self.driver.driver.networkconfigconfig[(
                              self.load_balancer.id, self.vip.ip_address)])
 
-    def test_plug_network(self):
-        self.driver.plug_network(self.compute_id, self.network_id)
-        self.assertEqual((self.compute_id, self.network_id, 'plug_network'),
-                         self.driver.driver.networkconfigconfig[(
-                             self.compute_id, self.network_id)])
-
     def test_unplug_network(self):
         self.driver.unplug_network(self.compute_id, self.network_id)
         self.assertEqual((self.compute_id, self.network_id, 'unplug_network'),
@@ -115,39 +127,40 @@ class TestNoopNetworkDriver(base.TestCase):
                              self.compute_id, self.network_id)])
 
     def test_get_plugged_networks(self):
-        self.driver.get_plugged_networks(self.compute_id)
+        interface_db_mock = mock.MagicMock()
+        interface_db_mock.port_id = self.port_id
+        interface_db_mock.network_id = self.network_id
+        interface_db_mock.compute_id = self.compute_id
+        interface_db_mock.vnic_type = constants.VNIC_TYPE_NORMAL
+
+        fixed_ips_db_mock = mock.MagicMock()
+        fixed_ips_db_mock.port_id = self.port_id
+        fixed_ips_db_mock.subnet_id = self.subnet_id
+        fixed_ips_db_mock.ip_address = self.ip_address
+
+        # mock out the sqlite db calls
+        connect_mock = mock.MagicMock()
+        connection_mock = mock.MagicMock()
+        self.mock_engine.connect.return_value = connect_mock
+        connect_mock.__enter__.return_value = connection_mock
+
+        connection_mock.execute.side_effect = [[interface_db_mock],
+                                               [fixed_ips_db_mock]]
+
+        result = self.driver.get_plugged_networks(self.compute_id)
+
         self.assertEqual((self.compute_id, 'get_plugged_networks'),
                          self.driver.driver.networkconfigconfig[(
                              self.compute_id)])
 
-    def test_plug_unplug_and_get_plugged_networks(self):
-        amphora = mock.MagicMock()
-        amphora.compute_id = uuidutils.generate_uuid()
-        network = self.driver.plug_network(amphora.compute_id,
-                                           self.network_id)
-        self.assertEqual(
-            network,
-            network_models.Interface(
-                id=mock.ANY,
-                compute_id=amphora.compute_id,
-                network_id=self.network_id,
-                fixed_ips=[],
-                port_id=mock.ANY
-            ))
-        networks = self.driver.get_plugged_networks(amphora.compute_id)
-        self.assertEqual(
-            networks,
-            [network_models.Interface(
-                id=mock.ANY,
-                compute_id=amphora.compute_id,
-                network_id=self.network_id,
-                fixed_ips=[],
-                port_id=mock.ANY
-            )])
-        self.driver.unplug_network(amphora.compute_id,
-                                   self.network_id)
-        networks = self.driver.get_plugged_networks(amphora.compute_id)
-        self.assertEqual([], networks)
+        expected_fixed_ips = [network_models.FixedIP(
+            subnet_id=self.subnet_id, ip_address=self.ip_address)]
+        expected_interfaces = [network_models.Interface(
+            compute_id=self.compute_id, network_id=self.network_id,
+            port_id=self.port_id, fixed_ips=expected_fixed_ips,
+            vnic_type=constants.VNIC_TYPE_NORMAL)]
+
+        self.assertEqual(expected_interfaces, result)
 
     def test_update_vip(self):
         self.driver.update_vip(self.load_balancer)

{octavia-15.0.0.data → octavia-16.0.0.data}/data/share/octavia/diskimage-create/tox.ini

@@ -4,7 +4,6 @@ envlist = bashate,docs,build,test
 
 [testenv]
 basepython = python3
-envdir = {toxworkdir}/venv
 setenv = VIRTUAL_ENV={envdir}
 passenv =
     http_proxy

{octavia-15.0.0.dist-info → octavia-16.0.0.dist-info}/AUTHORS

@@ -102,6 +102,7 @@ Hongbin Lu <hongbin.lu@huawei.com>
 Ian Wienand <iwienand@redhat.com>
 Ihar Hrachyshka <ihrachys@redhat.com>
 Ildar Iskhakov <iiskhako@cisco.com>
+Ilia Kerbs <ikerbs@protonmail.com>
 Itzik Brown <itzikb@redhat.com>
 Jacky Hu <hudayou@hotmail.com>
 James Arendt <james.arendt@hp.com>
@@ -192,6 +193,7 @@ Sean McGinnis <sean.mcginnis@gmail.com>
 Selvakumar S <selvakumar.s2@hp.com>
 Sergey Belous <sbelous@mirantis.com>
 Sergey Kraynev <sergejyit@gmail.com>
+Seunghun Lee <seunghun@stackhpc.com>
 ShangXiao <shangxiaobj@inspur.com>
 Shashank Kumar Shankar <shashank.kumar.shankar@intel.com>
 Sherif Abdelwahab <sherif.abdelwahab@hp.com>
@@ -213,6 +215,7 @@ Thobias Salazar Trevisan <thobiast@gmail.com>
 Thomas Bechtold <tbechtold@suse.com>
 Thomas Goirand <zigo@debian.org>
 Tin Lam <tl3438@att.com>
+Tobias Urdin <tobias.urdin@binero.com>
 Tobias Urdin <tobias.urdin@binero.se>
 Tom Weininger <tweining@redhat.com>
 Tony Breeds <tony@bakeyournoodle.com>

octavia-16.0.0.dist-info/METADATA

@@ -0,0 +1,156 @@
+Metadata-Version: 2.1
+Name: octavia
+Version: 16.0.0
+Summary: OpenStack Octavia Scalable Load Balancer as a Service
+Home-page: https://docs.openstack.org/octavia/latest/
+Author: OpenStack
+Author-email: openstack-discuss@lists.openstack.org
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Environment :: OpenStack
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: Information Technology
+Classifier: Intended Audience :: System Administrators
+Classifier: License :: OSI Approved :: Apache Software License
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Requires-Python: >=3.9
+License-File: LICENSE
+License-File: AUTHORS
+Requires-Dist: alembic >=0.9.6
+Requires-Dist: cotyledon >=1.3.0
+Requires-Dist: pecan >=1.3.2
+Requires-Dist: pbr >=3.1.1
+Requires-Dist: SQLAlchemy >=1.2.19
+Requires-Dist: SQLAlchemy-Utils >=0.30.11
+Requires-Dist: futurist >=1.2.0
+Requires-Dist: requests >=2.23.0
+Requires-Dist: rfc3986 >=1.2.0
+Requires-Dist: keystoneauth1 >=3.4.0
+Requires-Dist: keystonemiddleware >=9.5.0
+Requires-Dist: WebOb >=1.8.2
+Requires-Dist: stevedore >=1.20.0
+Requires-Dist: openstacksdk >=0.103.0
+Requires-Dist: oslo.config >=6.8.0
+Requires-Dist: oslo.context >=2.22.0
+Requires-Dist: oslo.db[mysql] >=8.4.0
+Requires-Dist: oslo.i18n >=3.20.0
+Requires-Dist: oslo.log >=4.3.0
+Requires-Dist: oslo.messaging >=14.1.0
+Requires-Dist: oslo.middleware >=4.0.1
+Requires-Dist: oslo.policy >=3.7.0
+Requires-Dist: oslo.reports >=1.18.0
+Requires-Dist: oslo.serialization >=2.28.1
+Requires-Dist: oslo.upgradecheck >=1.3.0
+Requires-Dist: oslo.utils >=4.7.0
+Requires-Dist: psutil >=5.7.1
+Requires-Dist: pyasn1 !=0.2.3,>=0.1.8
+Requires-Dist: pyasn1-modules >=0.0.6
+Requires-Dist: python-barbicanclient >=4.5.2
+Requires-Dist: python-glanceclient >=2.8.0
+Requires-Dist: python-novaclient >=9.1.0
+Requires-Dist: python-cinderclient >=3.3.0
+Requires-Dist: WSME >=0.8.0
+Requires-Dist: Jinja2 >=2.10
+Requires-Dist: taskflow >=5.9.0
+Requires-Dist: castellan >=0.16.0
+Requires-Dist: tenacity >=5.0.4
+Requires-Dist: distro >=1.2.0
+Requires-Dist: jsonschema >=3.2.0
+Requires-Dist: octavia-lib >=3.8.0
+Requires-Dist: setproctitle >=1.1.10
+Requires-Dist: python-dateutil >=2.7.0
+Requires-Dist: Flask !=0.11,>=0.10
+Requires-Dist: cryptography >=42.0.0
+Requires-Dist: gunicorn >=19.9.0
+Requires-Dist: Werkzeug >=0.14.1
+Requires-Dist: pyroute2 >=0.5.14 ; (sys_platform!='win32')
+Provides-Extra: etcd
+Requires-Dist: etcd3gw >=2.4.1 ; extra == 'etcd'
+Provides-Extra: redis
+Requires-Dist: redis >=3.4.0 ; extra == 'redis'
+Provides-Extra: test
+Requires-Dist: hacking <6.2.0,>=6.1.0 ; extra == 'test'
+Requires-Dist: requests-mock >=1.2.0 ; extra == 'test'
+Requires-Dist: coverage !=4.4,>=4.0 ; extra == 'test'
+Requires-Dist: fixtures >=3.0.0 ; extra == 'test'
+Requires-Dist: flake8-import-order <0.19.0,>=0.18.0 ; extra == 'test'
+Requires-Dist: python-subunit >=1.0.0 ; extra == 'test'
+Requires-Dist: oslotest >=3.2.0 ; extra == 'test'
+Requires-Dist: pylint >=2.5.3 ; extra == 'test'
+Requires-Dist: testrepository >=0.0.18 ; extra == 'test'
+Requires-Dist: testtools >=2.2.0 ; extra == 'test'
+Requires-Dist: testresources >=2.0.0 ; extra == 'test'
+Requires-Dist: testscenarios >=0.4 ; extra == 'test'
+Requires-Dist: doc8 >=0.6.0 ; extra == 'test'
+Requires-Dist: bandit !=1.6.0,>=1.1.0 ; extra == 'test'
+Requires-Dist: tempest >=23.0.0 ; extra == 'test'
+Requires-Dist: sphinx !=2.1.0,>=2.0.0 ; extra == 'test'
+Requires-Dist: bashate >=0.5.1 ; extra == 'test'
+Requires-Dist: WebTest >=2.0.26 ; extra == 'test'
+Provides-Extra: zookeeper
+Requires-Dist: kazoo >=2.6.0 ; extra == 'zookeeper'
+Requires-Dist: zake >=0.1.6 ; extra == 'zookeeper'
+
+========================
+Team and repository tags
+========================
+
+.. image:: https://governance.openstack.org/tc/badges/octavia.svg
+    :target: https://governance.openstack.org/tc/reference/tags/index.html
+
+.. Change things from this point on
+
+=======
+Octavia
+=======
+
+.. image:: https://img.shields.io/pypi/v/octavia.svg
+    :target: https://pypi.org/project/octavia/
+    :alt: Latest Version
+
+Octavia is an operator-grade open source scalable load balancer for use in
+large OpenStack deployments.
+
+Octavia provides the load balancing API for OpenStack. It supports multiple
+"provider drivers" that implement load balancing, including the "amphora"
+reference driver included with Octavia.
+
+Octavia is distributed under the terms of the Apache License, Version 2.0.
+The full terms and conditions of this license are detailed in the LICENSE
+file.
+
+Project resources
+~~~~~~~~~~~~~~~~~
+
+Developer documentation for the Octavia project is available at
+https://docs.openstack.org/octavia/latest/
+
+Release notes for the Octavia project are available at
+https://docs.openstack.org/releasenotes/octavia/
+
+The project source code repository is located at
+https://opendev.org/openstack/octavia
+
+Project status, bugs, and requests for feature enhancements are tracked on
+https://launchpad.net/octavia
+
+For more information on project direction and guiding principles for
+contributors, please see the CONSTITUTION.rst file in this directory, or
+specifications in the specs/ sub-directory.
+
+The project roadmap is available at
+https://wiki.openstack.org/wiki/Octavia/Roadmap
+
+External Resources
+~~~~~~~~~~~~~~~~~~
+
+* Octavia Wiki: https://wiki.openstack.org/wiki/Octavia
+
+* For help on usage and hacking of Octavia, please send an email to
+  OpenStack-dev Mailing List <mailto:openstack-discuss@lists.openstack.org>
+  with **[Octavia]** tag.
+