aboutsummaryrefslogtreecommitdiff
path: root/doc/source/reference/networking
AgeCommit message (Collapse)AuthorFilesLines
2026-09-17Remove leftover mention of Linux bridge driverPierre Riteau1-4/+4
This reference was missed during the removal of the Linux bridge mechanism driver [1]. [1] https://review.opendev.org/c/openstack/kolla-ansible/+/962278 Change-Id: Iff92e75a594a4888cf4cd179d7ac5de46e5c7f09 Signed-off-by: Pierre Riteau <pierre@stackhpc.com> (cherry picked from commit bf02dd405a084ffd680bc5a835b8ab48e76485f6)
2026-04-17Merge "Implement neutron-ovn-vpn-agent"Zuul1-15/+26
2026-04-17Implement neutron-ovn-vpn-agentMaximilian Stinsky1-15/+26
This patch implements vpnaas for OVN environments. It deploys a standalone neutron-ovn-vpn-agent on neutron nodes. The container no longer requires 'privileged: true'. Running as the 'neutron' user with specific kernel capabilities ensures the agent can manage network namespaces and interfaces without full privileges. Added capabilities: - NET_ADMIN # manage interfaces, IPs, routing, firewall - SYS_ADMIN # create/manage network namespaces - SYS_PTRACE # allow 'ip netns exec' attach to processes - DAC_OVERRIDE # bypass file read/write restrictions - DAC_READ_SEARCH # allow directory traversal and file read - SETPCAP # retain capabilities for privileged ops Added security options: - apparmor=unconfined # disable AppArmor confinement - seccomp=unconfined # disable seccomp filtering - label=disable # disable SELinux/labeling Depends-On: https://review.opendev.org/c/openstack/kolla/+/924302 Closes-Bug: #2048392 Change-Id: I961b1407ae1402d146f0c09924df8e007e331af5 Signed-off-by: Joachim de Groot <joachim.de.groot@menzel-it.net> Signed-off-by: Piotr Milewski <vurmil@gmail.com>
2026-04-12Fix: Update outdated documentationPiotr Milewski6-28/+18
Change-Id: I5dc53f74afd9a5b565201dc9d3039d82cb65dabc Signed-off-by: Piotr Milewski <vurmil@gmail.com>
2026-03-04ovn-db: add support for ovn-northd extra command-line argumentsAntony Messerli1-0/+9
Adds the ovn_northd_cmdline_extras variable to allow operators to pass additional command-line arguments to the ovn-northd daemon. This enables customization of performance-related parameters such as thread count (--n-threads), parallel build (--use-parallel-build), and inactivity probe timeout (--inactivity-probe). The implementation follows the established cmdline_extras pattern used throughout kolla-ansible for services like Prometheus exporters. Closes-Bug: #2142316 Change-Id: I870034da10f80ff2208bbad529fa7de9a2548c06 Signed-off-by: Antony Messerli <antony@mes.ser.li>
2025-11-06Replace Redis with ValkeyGrzegorz Koper1-3/+3
This change replaces Redis with Valkey, which is non-existent on Rocky Linux 10 / CentOS Stream 10 due to licensing issues. Co-Authored-By: Bartosz Bezak <bartosz@stackhpc.com> Co-Authored-By: Michal Nasiadka <mnasiadka@gmail.com> Change-Id: Ifcc6ec6e943c20867d969b0bdb0e4cbac53eea1e Signed-off-by: Grzegorz Koper <grzegorzk@stackhpc.com> Signed-off-by: Bartosz Bezak <bartosz@stackhpc.com> Signed-off-by: Michal Nasiadka <mnasiadka@gmail.com>
2025-10-30Merge "Enable Neutron agent wrappers by default"Zuul1-1/+1
2025-10-30Merge "Run neutron-ovn-metadata-agent haproxy processes in separate containers"Zuul1-2/+3
2025-10-29Enable Neutron agent wrappers by defaultBartosz Bezak1-1/+1
Neutron agent wrappers are now enabled by default. Wrapper containers restart DHCP, L3, and related agents without having to respawn the main service containers, which reduces dataplane disruptions during upgrades and restarts. Operators who need the previous behaviour can set ``neutron_agents_wrappers`` to ``"no"`` in ``/etc/kolla/globals.yml``. Change-Id: I755e3dfcd326f7c1c05c1e9275dda93753db5873 Signed-off-by: Bartosz Bezak <bartosz@stackhpc.com>
2025-10-29Run neutron-ovn-metadata-agent haproxy processes in separate containersMaximilian Stinsky1-2/+3
Follow up on Iaa1e687152db8351bc0e9b10e66f412860ac13a5 This patch implements the same experimental feature of running processes in seperated containers to the neutron-ovn-metadata-agent Co-Authored-By: Bartosz Bezak <bartosz@stackhpc.com> Depends-On: https://review.opendev.org/c/openstack/kolla/+/960726 Change-Id: If42aa11735bee963afc33d2e06541e1d9aab0515 Signed-off-by: Maximilian Stinsky <maximilian.stinsky-damke@wiit.cloud> Signed-off-by: Bartosz Bezak <bartosz@stackhpc.com>
2025-10-08ovn-db: Add OVN_NB_DB and OVN_SB_DB env variablesMichal Nasiadka1-0/+7
It will make running ovn-nbctl and ovn-sbctl working on all nodes irrespective of their cluster role. Excerpt from ovn-nbctl: --db database The OVSDB database remote to contact. If the OVN_NB_DB en‐ vironment variable is set, its value is used as the de‐ fault. Otherwise, the default is unix:/ovnnb_db.sock, but this default is unlikely to be useful outside of single-ma‐ chine OVN test environments. Closes-Bug: #2116313 Change-Id: I85f7bfd0aaa6f2d426ddb28950acbbca9d385aac Signed-off-by: Michal Nasiadka <mnasiadka@gmail.com>
2025-10-02Move to for Rocky Linux 10Michal Nasiadka1-1/+1
CephAdm, Octavia, OVN and NFV jobs are not added here, because these rely on Valkey/Redis available. Ironic jobs are not added, because ipxe.efi is not packaged in EL10 and needs a followup patch. Let's Encrypt jobs are also not added, due to ssl certificate validation errors. Depends-On: https://review.opendev.org/c/openstack/kolla/+/956554 Depends-On: https://review.opendev.org/c/openstack/ansible-collection-kolla/+/961237 Change-Id: I51823808c4e4ac08ae8f080aacf6a3759589571d Signed-off-by: Michal Nasiadka <mnasiadka@gmail.com>
2025-06-03Fix docs rendering errors.Michael Still3-33/+33
I was reading https://docs.openstack.org's version of the kolla-ansible advanced configuration guide and noticed some RST rendering errors. This patch corrects those errors so that the page renders correctly. Change-Id: I330678d8971d286e67f115eace1cb606d30433b6
2025-04-30Run ML2/OVS agents processes in separate containersMichal Nasiadka1-0/+15
It's an experimental feature, disabled by default (but enabled by default in our CI). It's based on TripleO ,,version'' that was their fix for the linked bug. Closes-Bug: #1891469 Depends-On: https://review.opendev.org/c/openstack/kolla/+/946215 Change-Id: Iaa1e687152db8351bc0e9b10e66f412860ac13a5
2025-03-20ovn: Add support for OVN SB RelayMichal Nasiadka1-0/+27
Add support for deploying OVN SB relays [1]. This is enabled by default to improve large scale scenarios. Default mechanism deploys one relay group per 50 ovn-controller hosts and uses random but idempotent method to choose a relay for a given host. neutron-server and Octavia will connect directly to SB cluster, not via the relays. kolla-ansible check subcommand does not support ,,iterated'' containers for now - but will be introduced in a subsequent patch. [1]: https://docs.ovn.org/en/latest/tutorials/ovn-ovsdb-relay.html Co-Authored-By: Krzysztof Tomaszewski <ktomaszewski@cloudferro.com> Depends-On: https://review.opendev.org/c/openstack/kolla/+/928898 Change-Id: Id7d6973668d8b2b194913b533f8cb756c6708536
2025-02-19docs: Correct typo in variable nameamithkotu1-2/+2
This commit addresses a typo in the documentation where the variable "neutron_physical_network" was incorrectly used. The correct variable name is "neutron_physical_networks", which reflects the actual value used in the code. Closes-Bug: #2088062 Change-Id: I5d4a7895d54aebcf0612e72d315defeda37bb178
2024-12-18Docs update - kolla-ansible cli parametersJakub Darmach1-2/+2
With rewrite of kolla-ansible CLI to Python in I9749b320d4f5eeec601a055b597dfa7d8fb97ce2 the order of parameters have to be: `kolla-ansible <action> <arguments>` Change-Id: I1bd4a7f96f77c34fb46ca21f37023dddf73e8f05 Closes-bug: 2087920
2024-09-18Merge "Fix octavia-interface timeout"Zuul1-0/+18
2024-07-17Fix octavia-interface timeoutVictor Chembaev1-0/+18
Added Restart=on-failure policy to octavia-interface systemd unit Added octavia_interface_wait_timeout variable to control TimeoutStartSec in octavia-interface systemd unit Change-Id: I9de6c27131ce78e85aac56ea5d91d9740fd58354 Closes-Bug: 2067036
2024-06-19Add support for customising Neutron physical network namesMark Goddard1-5/+36
Previously Kolla Ansible hard-coded Neutron physical networks starting at physnet1 up to physnetN, matching the number of interfaces in neutron_external_interface and bridges in neutron_bridge_name. Sometimes we may want to customise the physical network names used. This may be to allow for not all hosts having access to all physical networks, or to use more descriptive names. For example, in an environment with a separate physical network for Ironic provisioning, controllers might have access to two physical networks, while compute nodes have access to one. This change adds a neutron_physical_networks variable, making it possible to customise the Neutron physical network names used for the OVS, OVN, Linux bridge and OVS DPDK plugins. The default behaviour is unchanged. Change-Id: Ib5b8ea727014964919c6b3bd2352bac4a4ac1787
2024-04-29Re-add the neutron-fwaashowardlee1-1/+20
neutron-fwaas has become active again Depends-On: https://review.opendev.org/c/openstack/kolla/+/914855 Change-Id: Ie5a7b2da9a351e8f47a1ae830bb2fee0a8e35e38
2024-04-22CI: Add codespell to pep8Michal Nasiadka2-2/+2
Fix existing spelling errors Change-Id: Ie689cf5a344aaa630a4860448b09242333a8e119
2024-01-30Fix neutron DNS integrationMichal Arbet2-1/+61
This patch basically does a simple thing, on the basis of a variable neutron_dns_integration it enables/disables DNS integration. There is also precheck added which checks whether dns_domain in neutron.conf has a non-default value if DNS integration is enabled as this is requirement. [1] https://docs.openstack.org/neutron/latest/admin/config-dns-int.html [2] https://docs.openstack.org/neutron/latest/admin/config-dns-int-ext-serv.html#config-dns-int-ext-serv Closes-Bug: #2049503 Change-Id: I90f0f8dcec6fa0112179f050d96e9d9db5956cf8
2023-09-21Add option for extra kernel modules in neutron roleBartosz Bezak1-0/+22
Closes-Bug: #2036741 Change-Id: Ib448d04e43dff78e344064161beadae917c41206
2023-08-17Merge "Add support for checking Octavia cert expiration"Zuul1-0/+10
2023-07-28Fix L3 agent docs typoJake Hutchinson1-1/+1
Change-Id: I149bc646d2e5fb1e32be9c94c6a8d75fd92893e1
2023-05-30Correct [pci] syntax in Nova SRIOV documentationMatt Crees1-2/+2
The ``[pci]`` options in the Nova SRIOV documentation are incorrect. ``alias`` is a JSON object but mentioned as a list of object here. ``through_whitelist`` is deprecated [1] in favour of ``device_spec``. [1] https://docs.openstack.org/nova/2023.1/configuration/config.html#id116 Closes-Bug: #2019985 Change-Id: I4f9bce297bc3385f9749e4221f4721c1841700a1
2023-05-19neutron: Add neutron-ovn-agent supportMichal Nasiadka1-0/+9
Depends-On: https://review.opendev.org/c/openstack/neutron/+/878535 Change-Id: I05d8b29b59a7de76da488f68775547a8f0f11d0f
2023-04-27Add support for checking Octavia cert expirationMatt Crees1-0/+10
Adds a flag ``kolla-ansible octavia-certificates --check-expiry <days>`` to the ``octavia-certificates`` command to check if the certificates will expire within a given number of days. Change-Id: I869b8afd85fe282d823ecf3593aa22f94a61b2a0
2023-01-25Merge "Adding optional delay between l3 agent restarts"Zuul1-0/+30
2023-01-23Adding optional delay between l3 agent restartsAlex-Welsh1-0/+30
This change serialises the neutron l3 agent restart process and adds a user configurable delay between restarts. This can prevent connectivity loss due to all agents being restarted at the same time. Routers increase the recovery time, making this issue more prevalent. Change-Id: I3be0ebfa12965e6ae32d1b5f13f8fd23c3f52b8c
2023-01-16Fix issue with genconfig and octavia_auto_configureWill Szumski1-0/+4
Makes sure the facts required to generate octavia.conf are available when using genconfig. This change also ensures that the necessary tasks run when using Ansible check mode. Closes-Bug: #1987299 Change-Id: Ib8fbee2d3abdcfd2eae0f9b3e9b69eeb0e3086e0
2022-11-14docs: Octavia OVN providerMark Goddard1-23/+45
Change-Id: Ib3dba0a3741d918a189edfa43041207a59392f07
2022-10-18Update RHEL family informationMarcin Juszkiewicz1-1/+1
Some time ago we dropped RHEL as one of possible options. During 'Zed' cycle we added Rocky Linux 9 as alternative to CentOS Stream 9. This change updates some mentions of both. Change-Id: I9ed93efcb7d1ff97b1c7d8342db8252aba2a9887
2022-03-30neutron: add ssh keyMichal Nasiadka1-0/+11
This key can be used by users in networking-generic-switch scenario instead of adding cleartext password in ml2_conf.ini. Change-Id: I10003e6526a55a97f22678ab81c411e4645c5157
2022-03-24Merge "designate: allow designate_ns_record to be a list"Zuul1-1/+2
2022-03-24designate: allow designate_ns_record to be a listMichał Nasiadka1-1/+2
In most real world deployments, there will be multiple backend DNS servers, allow to specify all of them for the pool configuration. Change-Id: Ic9737d0446a807891b429f080ae1bf048a3c8e4a
2022-01-26Merge "openvswitch: add option to set hw offload"Zuul1-0/+7
2022-01-20openvswitch: add option to set hw offloadMichal Nasiadka1-0/+7
Change-Id: I8bf5453c6943fd2ad8912e5d80af179296ada894
2021-12-20[docs] Mark init-runonce properlyRadosław Piliszek1-0/+10
This is a docs amendment to let users know that calling init-runonce is not a required deployment step and it may not work for them if they modified the defaults. Change-Id: Ia3922b53d91a1a820447fec6a8074b941edc2ee9
2021-10-20docs: Improve info about neutron external interfaceMark Goddard3-31/+58
Change-Id: I3a9c49c73a932b3d5ceed65c92190e5d72e27bbb Closes-Bug: #1626259
2021-07-21Fix variable names in Octavia documentationPierre Riteau1-5/+5
The variable octavia_amphora_flavor should be octavia_amp_flavor. The variable for customising network and subnet was only mentioned in the example. Change-Id: I3ba5a7ccc2c810fea12bc48584c064738e5aa35e
2021-06-14Merge "Add ability to use the Neutron packet logging framework"Zuul1-0/+48
2021-05-11Add ability to use the Neutron packet logging frameworkFlorian LEDUC1-0/+48
* Enables the Neutron packet logging framework for OVS (https://docs.openstack.org/neutron/latest/admin/config-logging.html). * Adds a toggle variable "enable_neutron_packet_logging" Change-Id: Ica3594cdac634b496949a06ed813dccd18090af4 Implements: blueprint neutron-log-service-plugin
2021-04-19[doc] introduce octavia tenant management networkwuchunyang1-0/+18
Change-Id: I713f6fafe328e060a71dbb584e61603e547deaf6
2021-03-09Merge "Add Neutron DHCP agent to OVN networking setup"Zuul1-0/+12
2021-02-23Add Neutron DHCP agent to OVN networking setupPiotr Parczewski1-0/+12
This commit adds possibility to deploy Neutron's DHCP agents in OVN networking scenario. Co-Authored-By: Michał Nasiadka <mnasiadka@gmail.com> Change-Id: I073d04319b510182f5c1478e728c0c5bcc8799f1
2021-02-03Add IPv6 configuration options to Octavia management networkCarsten Koester1-0/+3
If the Octavia/Amphora management network is created by Kolla, support setting the IP address family and IPv6 address/RA mode. Closes-Bug: 1913409 Change-Id: I9f2ef2196654c91596cb5c4b3c157bcee267226a
2021-01-27[docs] Unify project's naming conventionPiotr Parczewski2-2/+2
There are inconsitencies across the documentation and the source code files when it comes to project's name (Kolla Ansible vs. Kolla-Ansible). This commit aims at unifying it so that the naming becomes consistent everywhere. Change-Id: I903b2e08f5458b1a1abc4af3abefe20b66c23a54
2020-12-16[doc] Fix a typo in dpdk docwu.chunyang1-1/+1
docs site cann't render it correctly without the space. see: https://docs.openstack.org/kolla-ansible/latest/reference/networking/dpdk.html trivial fix Change-Id: I3ebea8c1ab76f2aaac80f3e2f7a84cd69c018ae6