Add dual-stack IP config for internal NICs

- Add dual-stack VPC private address configuration type and include it
  in the shared NetworkInterface type.
- Add database model support for reading / writing the dual-stack NIC
  type to the database, handling serialization into optional fields.
- Update all the callsites to handle the new dual-stack-aware type.
- Add a bunch of conversions for the APIs which rely on that new type,
  of which there are many. This also adds the conversions and older
  types into the `sled-agent-types` crate, so they can be used in a few
  places that don't directly depend on the `sled-agent-api` crate
  itself, notably reconfigurator and `nexus-inventory`.
- Update the sled-agent reconciler to deserialize previous versions of
  its sled-configuration ledgers, convert them, and write them out again
  as the new versions.
- Updates the OPTE `PortManager` type with the new dual-stack support.
  This is only for private IP addresses, though. We still need some work
  to support OPTE ports with dual stack external addresses. This is
  about half of #9247, the VPC-private part.
- Closes #9246

Author: bnaecker

common/src/api/internal/shared.rs renamed to common/src/api/internal/shared/mod.rs

@@ -4,6 +4,7 @@
 
 //! Types shared between Nexus and Sled Agent.
 
+use super::nexus::HostIdentifier;
 use crate::{
     address::NUM_SOURCE_NAT_PORTS,
     api::external::{self, BfdMode, ImportExportPolicy, Name, Vni},
@@ -21,60 +22,11 @@ use std::{
 use strum::EnumCount;
 use uuid::Uuid;
 
-use super::nexus::HostIdentifier;
-
-/// The type of network interface
-#[derive(
-    Clone,
-    Copy,
-    Debug,
-    Eq,
-    PartialEq,
-    Ord,
-    PartialOrd,
-    Deserialize,
-    Serialize,
-    JsonSchema,
-    Hash,
-    Diffable,
-)]
-#[serde(tag = "type", rename_all = "snake_case")]
-pub enum NetworkInterfaceKind {
-    /// A vNIC attached to a guest instance
-    Instance { id: Uuid },
-    /// A vNIC associated with an internal service
-    Service { id: Uuid },
-    /// A vNIC associated with a probe
-    Probe { id: Uuid },
-}
+pub mod network_interface;
 
-/// Information required to construct a virtual network interface
-#[derive(
-    Clone,
-    Debug,
-    Deserialize,
-    Serialize,
-    JsonSchema,
-    PartialEq,
-    Eq,
-    PartialOrd,
-    Ord,
-    Hash,
-    Diffable,
-)]
-pub struct NetworkInterface {
-    pub id: Uuid,
-    pub kind: NetworkInterfaceKind,
-    pub name: Name,
-    pub ip: IpAddr,
-    pub mac: external::MacAddr,
-    pub subnet: IpNet,
-    pub vni: Vni,
-    pub primary: bool,
-    pub slot: u8,
-    #[serde(default)]
-    pub transit_ips: Vec<IpNet>,
-}
+// Re-export latest version of all NIC-related types.
+pub use network_interface::NetworkInterfaceKind;
+pub use network_interface::v2::*;
 
 /// An IP address and port range used for source NAT, i.e., making
 /// outbound network connections from guests or services.
@@ -776,7 +728,7 @@ impl TryFrom<&[ipnetwork::IpNetwork]> for IpAllowList {
 
 /// A VPC route resolved into a concrete target.
 #[derive(
-    Clone, Debug, Deserialize, Serialize, JsonSchema, PartialEq, Eq, Hash,
+    Clone, Copy, Debug, Deserialize, Serialize, JsonSchema, PartialEq, Eq, Hash,
 )]
 pub struct ResolvedVpcRoute {
     pub dest: IpNet,
@@ -973,12 +925,12 @@ impl JsonSchema for DatasetKind {
     }
 
     fn json_schema(
-        gen: &mut schemars::gen::SchemaGenerator,
+        generator: &mut schemars::gen::SchemaGenerator,
     ) -> schemars::schema::Schema {
         // The schema is a bit more complicated than this -- it's either one of
         // the fixed values or a string starting with "zone/" -- but this is
         // good enough for now.
-        let mut schema = <String>::json_schema(gen).into_object();
+        let mut schema = <String>::json_schema(generator).into_object();
         schema.metadata().description = Some(
             "The kind of dataset. See the `DatasetKind` enum \
              in omicron-common for possible values."

common/src/api/internal/shared/network_interface/mod.rs

@@ -0,0 +1,39 @@
+// This Source Code Form is subject to the terms of the Mozilla Public
+// License, v. 2.0. If a copy of the MPL was not distributed with this
+// file, You can obtain one at https://mozilla.org/MPL/2.0/.
+
+//! Shared network-interface types.
+
+use daft::Diffable;
+use schemars::JsonSchema;
+use serde::Deserialize;
+use serde::Serialize;
+use uuid::Uuid;
+
+pub mod v1;
+pub mod v2;
+
+/// The type of network interface
+#[derive(
+    Clone,
+    Copy,
+    Debug,
+    Eq,
+    PartialEq,
+    Ord,
+    PartialOrd,
+    Deserialize,
+    Serialize,
+    JsonSchema,
+    Hash,
+    Diffable,
+)]
+#[serde(tag = "type", rename_all = "snake_case")]
+pub enum NetworkInterfaceKind {
+    /// A vNIC attached to a guest instance
+    Instance { id: Uuid },
+    /// A vNIC associated with an internal service
+    Service { id: Uuid },
+    /// A vNIC associated with a probe
+    Probe { id: Uuid },
+}

common/src/api/internal/shared/network_interface/v1.rs

@@ -0,0 +1,46 @@
+// This Source Code Form is subject to the terms of the Mozilla Public
+// License, v. 2.0. If a copy of the MPL was not distributed with this
+// file, You can obtain one at https://mozilla.org/MPL/2.0/.
+
+//! Network interface types version 1
+
+use std::net::IpAddr;
+
+use crate::api::external;
+use crate::api::external::Name;
+use crate::api::external::Vni;
+use crate::api::internal::shared::NetworkInterfaceKind;
+use daft::Diffable;
+use oxnet::IpNet;
+use schemars::JsonSchema;
+use serde::Deserialize;
+use serde::Serialize;
+use uuid::Uuid;
+
+/// Information required to construct a virtual network interface
+#[derive(
+    Clone,
+    Debug,
+    Deserialize,
+    Serialize,
+    JsonSchema,
+    PartialEq,
+    Eq,
+    PartialOrd,
+    Ord,
+    Hash,
+    Diffable,
+)]
+pub struct NetworkInterface {
+    pub id: Uuid,
+    pub kind: NetworkInterfaceKind,
+    pub name: Name,
+    pub ip: IpAddr,
+    pub mac: external::MacAddr,
+    pub subnet: IpNet,
+    pub vni: Vni,
+    pub primary: bool,
+    pub slot: u8,
+    #[serde(default)]
+    pub transit_ips: Vec<IpNet>,
+}