public inbox for pve-devel@lists.proxmox.com
 help / color / mirror / Atom feed
From: Gabriel Goller <g.goller@proxmox.com>
To: Wolfgang Bumiller <w.bumiller@proxmox.com>
Cc: pve-devel@lists.proxmox.com
Subject: Re: [pve-devel] [PATCH proxmox-perl-rs v2 2/4] fabrics: add function to get status of fabric
Date: Mon, 25 Aug 2025 13:39:48 +0200	[thread overview]
Message-ID: <lzfbdyxqkjekdfvo2nywp6izxys5lsp2m6tuxagzxsnj7djqom@tpvixhxemawz> (raw)
In-Reply-To: <yaik2igsmqhbq3w6xobggou5ypuxbu2wiezamyk76tpylo4w2b@4mjpjge3z3et>

On 25.08.2025 10:11, Wolfgang Bumiller wrote:
>On Fri, Aug 22, 2025 at 11:00:36AM +0200, Gabriel Goller wrote:
>> Add a function to get the status of a fabric. This is the status which
>> will then be inserted into the pvestatd daemon and returned through the
>> resources api. In order the generate the HashMap of statuses for all
>> fabrics we need to read the fabric config and execute a vtysh (frr)
>> command to get the routes of the corresponding fabric. If there is at
>> least one route which is related to the fabric, the fabric is considered
>> "ok".
>>
>> Signed-off-by: Gabriel Goller <g.goller@proxmox.com>
>> ---
>>  pve-rs/src/bindings/sdn/fabrics.rs | 194 +++++++++++++++++++++++++++++
>>  1 file changed, 194 insertions(+)
>>
>> diff --git a/pve-rs/src/bindings/sdn/fabrics.rs b/pve-rs/src/bindings/sdn/fabrics.rs
>> index 1dc8bf4320e6..3f70d421e582 100644
>> --- a/pve-rs/src/bindings/sdn/fabrics.rs
>> +++ b/pve-rs/src/bindings/sdn/fabrics.rs
>> @@ -9,8 +9,10 @@ pub mod pve_rs_sdn_fabrics {
>>      use std::fmt::Write;
>>      use std::net::IpAddr;
>>      use std::ops::Deref;
>> +    use std::process::Command;
>>      use std::sync::Mutex;
>>
>> +    use anyhow::Context;
>>      use anyhow::Error;
>>      use openssl::hash::{MessageDigest, hash};
>>      use serde::{Deserialize, Serialize};
>> @@ -578,4 +580,196 @@ pub mod pve_rs_sdn_fabrics {
>>
>>          Ok(interfaces)
>>      }
>> +
>> +    /// This module contains status-related structs that represent Routes and Neighbors for all
>> +    /// protocols
>> +    pub mod status {
>
>^ This seems to be a helper module which does not contain any
>perlmod/perl specifics.
>I'd argue it's time to start a `crate::sdn` module outside of the
>`bindings` submodule for this.
>
>The `bindings` module should become rather more lean in the future and
>focus mostly on the perl/rust interaction.

Umm do I understand you correctly that you want to have something like
this:

     src/
     ├─ bindings/
     │  ├─ sdn/
     │  │  ├─ fabrics.rs
     ├─ sdn/
     │  ├─ status.rs

?

IMO we could move all the status stuff out to
crate::bindings::sdn::status. But I don't know about separating all the
types, conversion methods and actual perl methods -- I'd rather keep all
the perl-facing stuff in the same file.

>> +        use std::collections::{HashMap, HashSet};
>> +
>> +        use serde::Serialize;
>> +
>> +        use proxmox_frr::de::{self};
>> +        use proxmox_ve_config::sdn::fabric::{
>> +            FabricConfig,
>> +            section_config::{fabric::FabricId, node::Node as ConfigNode},
>> +        };
>> +
>> +        /// Protocol
>> +        #[derive(Debug, Serialize, Clone, Copy)]
>> +        pub enum Protocol {
>> +            /// Openfabric
>> +            Openfabric,
>> +            /// OSPF
>> +            Ospf,
>> +        }
>> +
>> +        /// The status of a fabric.
>> +        #[derive(Debug, Serialize)]
>> +        pub enum FabricStatus {
>> +            /// The fabric exists and has a route
>> +            #[serde(rename = "ok")]
>> +            Ok,
>> +            /// The fabric does not exist or doesn't distribute any routes
>> +            #[serde(rename = "not ok")]
>> +            NotOk,
>> +        }
>> +
>> +        /// Status of a fabric.
>> +        ///
>> +        /// Check if there are any routes, if yes, then the status is ok, otherwise not ok.
>
>^ Not sure how this describes the *struct*, though ;-)

Oops, this slipped through, should have been somewhere else.

>> +        #[derive(Debug, Serialize)]
>> +        pub struct Status {
>> +            #[serde(rename = "type")]
>> +            ty: String,
>> +            status: FabricStatus,
>> +            protocol: Protocol,
>> +            sdn: FabricId,
>> +            sdn_type: String,
>> +        }
>> +
>> +        /// Parsed routes for all protocols
>> +        ///
>> +        /// These are the routes parsed from the json output of:
>> +        /// `vtysh -c 'show ip route <protocol> json'`.
>> +        #[derive(Debug, Serialize)]
>> +        pub struct RoutesParsed {
>> +            /// All openfabric routes in FRR
>> +            pub openfabric: de::Routes,
>> +            /// All ospf routes in FRR
>> +            pub ospf: de::Routes,
>> +        }
>> +
>> +        impl TryInto<HashMap<FabricId, Status>> for RoutesParsed {
>> +            type Error = anyhow::Error;
>> +
>> +            fn try_into(self) -> Result<HashMap<FabricId, Status>, Self::Error> {
>> +                let hostname = proxmox_sys::nodename();
>> +
>> +                // to associate a route to a fabric, we get all the interfaces which are associated
>> +                // with a fabric on this node and compare them with the interfaces on the route.
>> +                let raw_config = std::fs::read_to_string("/etc/pve/sdn/fabrics.cfg")?;
>
>^ I'm really not a fan of doing file I/O in a TryInto implementation.
>These are still supposed to be "simple"[1].
>
>Better make this a method.
>
>[1] https://doc.rust-lang.org/std/convert/trait.TryFrom.html

Yup, I agree, changed all the TryInto impls to functions `get_routes`,
`get_neighbors` and `get_status`.

Also fixed all the other stuff below.

Thanks for the review!


_______________________________________________
pve-devel mailing list
pve-devel@lists.proxmox.com
https://lists.proxmox.com/cgi-bin/mailman/listinfo/pve-devel

  parent reply	other threads:[~2025-08-25 11:40 UTC|newest]

Thread overview: 25+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2025-08-22  9:00 [pve-devel] [PATCH manager/network/proxmox{-ve-rs, -perl-rs} v2 00/12] Add fabric status view Gabriel Goller
2025-08-22  9:00 ` [pve-devel] [PATCH proxmox-ve-rs v2 1/2] frr: make room for deserialization structs Gabriel Goller
2025-08-22  9:00 ` [pve-devel] [PATCH proxmox-ve-rs v2 2/2] frr: add deserialization types for openfabric and ospf Gabriel Goller
2025-08-22  9:00 ` [pve-devel] [PATCH proxmox-perl-rs v2 1/4] pve: fabrics: update proxmox-frr import path Gabriel Goller
2025-08-22  9:00 ` [pve-devel] [PATCH proxmox-perl-rs v2 2/4] fabrics: add function to get status of fabric Gabriel Goller
2025-08-25  8:11   ` Wolfgang Bumiller
2025-08-25  8:25     ` Wolfgang Bumiller
2025-08-25 11:39     ` Gabriel Goller [this message]
2025-08-25 14:37       ` Wolfgang Bumiller
2025-08-25 15:33         ` Gabriel Goller
2025-08-26  7:55           ` Wolfgang Bumiller
2025-08-26  8:29             ` Gabriel Goller
2025-08-22  9:00 ` [pve-devel] [PATCH proxmox-perl-rs v2 3/4] fabrics: add function to get all routes distributed by the fabrics Gabriel Goller
2025-08-25  8:22   ` Wolfgang Bumiller
2025-08-25 11:40     ` Gabriel Goller
2025-08-22  9:00 ` [pve-devel] [PATCH proxmox-perl-rs v2 4/4] fabrics: add function to get all neighbors of the fabric Gabriel Goller
2025-08-25  8:28   ` Wolfgang Bumiller
2025-08-25 11:41     ` Gabriel Goller
2025-08-22  9:00 ` [pve-devel] [PATCH pve-network v2 1/3] fabrics: add fabrics status to SDN::status function Gabriel Goller
2025-08-22  9:00 ` [pve-devel] [PATCH pve-network v2 2/3] fabrics: add api endpoint to return fabrics routes Gabriel Goller
2025-08-22  9:00 ` [pve-devel] [PATCH pve-network v2 3/3] fabrics: add api endpoint to return fabric neighbors Gabriel Goller
2025-08-22  9:00 ` [pve-devel] [PATCH pve-manager v2 1/3] pvestatd: add fabrics status to pvestatd Gabriel Goller
2025-08-22  9:00 ` [pve-devel] [PATCH pve-manager v2 2/3] fabrics: add resource view for fabrics Gabriel Goller
2025-08-22  9:00 ` [pve-devel] [PATCH pve-manager v2 3/3] permissions: differentiate between zone and fabric paths Gabriel Goller
2025-08-26  9:52 ` [pve-devel] [PATCH manager/network/proxmox{-ve-rs, -perl-rs} v2 00/12] Add fabric status view Gabriel Goller

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to=lzfbdyxqkjekdfvo2nywp6izxys5lsp2m6tuxagzxsnj7djqom@tpvixhxemawz \
    --to=g.goller@proxmox.com \
    --cc=pve-devel@lists.proxmox.com \
    --cc=w.bumiller@proxmox.com \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox
Service provided by Proxmox Server Solutions GmbH | Privacy | Legal