Skip to content

feat(docs/config): add Ironic OVN annotation examples for provisioning network and config update#1553

Closed
vish6760 wants to merge 1 commit into
mainfrom
ironic-ovn-annotations
Closed

feat(docs/config): add Ironic OVN annotation examples for provisioning network and config update#1553
vish6760 wants to merge 1 commit into
mainfrom
ironic-ovn-annotations

Conversation

@vish6760
Copy link
Copy Markdown
Contributor

@vish6760 vish6760 commented Apr 23, 2026

Expand the OVN setup guide with Ironic-specific examples for:

  • multiple bridges including br-pxe
  • bridge-to-port mappings for provisioning VLAN interfaces
  • neutron physnet mappings for the provisioning network

Also correct the port mapping example to use bond0 instead of bond1 so
the examples align with the documented bond configuration.

feat(ironic): bump chart version to 2025.1.4+ed289c1cd

  • Update the helm chart for Ironic service.

refactor(ironic): Simplify db_sync job configuration

  • Removed the explicit ironic-db-init job dependency from the db_sync
    configuration.

@vish6760 vish6760 force-pushed the ironic-ovn-annotations branch 2 times, most recently from 169e219 to 56e9ecb Compare April 24, 2026 04:31
@vish6760 vish6760 changed the title feat(docs): add Ironic OVN annotation examples for provisioning network feat(docs/config): add Ironic OVN annotation examples for provisioning network and config update Apr 24, 2026
and config update

Expand the OVN setup guide with Ironic-specific examples for:
- multiple bridges including br-pxe
- bridge-to-port mappings for provisioning VLAN interfaces
- neutron physnet mappings for the provisioning network

Also correct the port mapping example to use `bond0` instead of `bond1` so
the examples align with the documented bond configuration.

feat(ironic): bump chart version to 2025.1.4+ed289c1cd

- Update the helm chart for Ironic service.

refactor(ironic): Simplify db_sync job configuration

- Removed the explicit ironic-db-init job dependency from the db_sync
configuration.

Signed-off-by: vish6760 <[email protected]>
@vish6760 vish6760 force-pushed the ironic-ovn-annotations branch from 56e9ecb to 9d934e8 Compare April 24, 2026 04:34
| **ovn.openstack.org/int_bridge** | str | `br-int` | The name of the integration bridge that will be used. |
| **ovn.openstack.org/bridges** | str | `br-ex` | Comma separated list of bridges that will be created and plugged into OVS for a given node. |
| **ovn.openstack.org/ports** | str | `br-ex:bond1` | Comma separated list of bridge mappings. Maps values from the **bridges** annotation to physical devices or bonds on a given node. |
| **ovn.openstack.org/bridges** | str | `br-ex,br-pxe` | Comma separated list of bridges that will be created and plugged into OVS for a given node. |
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

this should be moved to a "configure ovn for iconic enablement and not in the standard deployment section as this is not needed for a pure compute (non-ironic) deployment and could confuse non-ironic users when configuring ovn.

| **ovn.openstack.org/bridges** | str | `br-ex` | Comma separated list of bridges that will be created and plugged into OVS for a given node. |
| **ovn.openstack.org/ports** | str | `br-ex:bond1` | Comma separated list of bridge mappings. Maps values from the **bridges** annotation to physical devices or bonds on a given node. |
| **ovn.openstack.org/bridges** | str | `br-ex,br-pxe` | Comma separated list of bridges that will be created and plugged into OVS for a given node. |
| **ovn.openstack.org/ports** | str | `br-ex:bond0,br-pxe:vlanXYZ` | Comma separated list of bridge mappings. Maps values from the **bridges** annotation to physical devices or bonds on a given node. |
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

same as ^^^. It would be better to is "OVN Annotations" became a table/matrix with an ironic-enabled section but defaults to non-ironic settings

| **ovn.openstack.org/bond-options** | str | `bond0:mii-monitor-interval=100,lacp-time=fast` | Comma separated list of additional bond options. Format: `bondname:option1=value1,option2=value2`. Supports MII monitoring, LACP timing, and other OVS bond parameters. |
| **ovn.openstack.org/vlans** | str | `bond0.126:bond0:126:1500` | Comma separated list of host VLAN interfaces that **ovn-setup** should create before attaching ports. Format: `interface_name:parent_interface:vlan_id:mtu`. |
| **ovn.openstack.org/mappings** | str | `physnet1:br-ex` | Comma separated list of neutron mappings. Maps a value that will be used in neutron to a value found in the **ports** or **bonds** annotation. Every provider network name listed in this annotation will have a unique mac address generated per-host. |
| **ovn.openstack.org/mappings** | str | `physnet1:br-ex,physnet2:br-pxe` | Comma separated list of neutron mappings. Maps a value that will be used in neutron to a value found in the **ports** or **bonds** annotation. Every provider network name listed in this annotation will have a unique mac address generated per-host. |
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

same here. create a seperate tabbed table "if you are using ironic, you need to exapnd these to include XYZ" (see openstack-keystone-federation/?h=feder#__tabbed_1_2) for an example

@vish6760
Copy link
Copy Markdown
Contributor Author

vish6760 commented May 8, 2026

These changes will be handled in PR-1581

@vish6760 vish6760 closed this May 8, 2026
@vish6760 vish6760 deleted the ironic-ovn-annotations branch May 13, 2026 00:07
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants