feat: stacks and demo supports OCI helmCharts

rust/stackable-cockpit/src/helm.rs

@@ -38,6 +38,40 @@ pub struct ChartRepo {
     pub url: String,
 }
 
+/// The kind of source a chart repo URL refers to.
+///
+/// [Self::Oci] and [Self::Local] don't need special handling, but [Self::Repo]
+/// needs to call `helm::add_repo`.
+///
+/// Note: We don't yet support local repositories, so an error should be emitted
+/// if the source is [Self::Local].
+#[derive(Debug, PartialEq)]
+pub enum ChartSourceKind {
+    /// OCI registry (url starts with `oci://`)
+    Oci,
+
+    /// Traditional index.yaml-based repository (url starts with `http://` or `https://`)
+    Repo,
+
+    /// Local filesystem path (not yet supported)
+    ///
+    /// This is the fallback if not oci or http(s).
+    Local,
+}
+
+impl ChartRepo {
+    /// Determine the kind of chart source based on the URL scheme.
+    pub fn source_kind(&self) -> ChartSourceKind {
+        if self.url.starts_with("oci://") {
+            ChartSourceKind::Oci
+        } else if self.url.starts_with("http://") || self.url.starts_with("https://") {
+            ChartSourceKind::Repo
+        } else {
+            ChartSourceKind::Local
+        }
+    }
+}
+
 #[derive(Debug, Snafu)]
 pub enum Error {
     #[snafu(display("failed to parse URL"))]
@@ -505,3 +539,53 @@ where
 
     serde_yaml::from_str(&index_file_content).context(DeserializeYamlSnafu)
 }
+
+#[cfg(test)]
+mod tests {
+    use super::*;
+
+    #[test]
+    fn source_kind_oci() {
+        let repo = ChartRepo {
+            name: "nifi-operator".to_string(),
+            url: "oci://oci.stackable.tech/sdp-charts".to_string(),
+        };
+        assert_eq!(repo.source_kind(), ChartSourceKind::Oci);
+    }
+
+    #[test]
+    fn source_kind_https_repo() {
+        let repo = ChartRepo {
+            name: "stackable-stable".to_string(),
+            url: "https://repo.stackable.tech/repository/helm-stable".to_string(),
+        };
+        assert_eq!(repo.source_kind(), ChartSourceKind::Repo);
+    }
+
+    #[test]
+    fn source_kind_http_repo() {
+        let repo = ChartRepo {
+            name: "example".to_string(),
+            url: "http://example.com/charts".to_string(),
+        };
+        assert_eq!(repo.source_kind(), ChartSourceKind::Repo);
+    }
+
+    #[test]
+    fn source_kind_relative_path_is_local() {
+        let repo = ChartRepo {
+            name: "local".to_string(),
+            url: "./charts/my-chart".to_string(),
+        };
+        assert_eq!(repo.source_kind(), ChartSourceKind::Local);
+    }
+
+    #[test]
+    fn source_kind_absolute_path_is_local() {
+        let repo = ChartRepo {
+            name: "local".to_string(),
+            url: "/absolute/path/to/chart".to_string(),
+        };
+        assert_eq!(repo.source_kind(), ChartSourceKind::Local);
+    }
+}

rust/stackable-cockpit/src/platform/manifests.rs

@@ -56,6 +56,10 @@ pub enum Error {
         source: helm::Error,
     },
 
+    /// This error indicates that the Helm chart source kind is not supported.
+    #[snafu(display("local Helm chart sources are not yet supported (url: {url})"))]
+    UnsupportedChartSource { url: String },
+
     /// This error indicates that Helm chart options could not be serialized
     /// into YAML.
     #[snafu(display("failed to serialize Helm chart options"))]
@@ -104,12 +108,23 @@ pub trait InstallManifestsExt {
 
                     info!(helm_chart.name, helm_chart.version, "Installing Helm chart",);
 
-                    // Assumption: that all manifest helm charts refer to repos not registries
-                    helm::add_repo(&helm_chart.repo.name, &helm_chart.repo.url).context(
-                        AddHelmRepositorySnafu {
-                            repo_name: helm_chart.repo.name.clone(),
-                        },
-                    )?;
+                    let chart_source = match helm_chart.repo.source_kind() {
+                        helm::ChartSourceKind::Repo => {
+                            helm::add_repo(&helm_chart.repo.name, &helm_chart.repo.url).context(
+                                AddHelmRepositorySnafu {
+                                    repo_name: helm_chart.repo.name.clone(),
+                                },
+                            )?;
+                            &helm_chart.repo.name
+                        }
+                        helm::ChartSourceKind::Oci => &helm_chart.repo.url,
+                        helm::ChartSourceKind::Local => {
+                            return UnsupportedChartSourceSnafu {
+                                url: helm_chart.repo.url.clone(),
+                            }
+                            .fail();
+                        }
+                    };
 
                     // Serialize chart options to string
                     let values_yaml = serde_yaml::to_string(&helm_chart.options)
@@ -119,7 +134,7 @@ pub trait InstallManifestsExt {
                     helm::upgrade_or_install_release_from_repo_or_registry(
                         &helm_chart.release_name,
                         helm::ChartVersion {
-                            chart_source: &helm_chart.repo.name,
+                            chart_source,
                             chart_name: &helm_chart.name,
                             chart_version: Some(&helm_chart.version),
                         },

rust/stackablectl/CHANGELOG.md

@@ -10,9 +10,11 @@ All notable changes to this project will be documented in this file.
 - Add `uninstall` subcommand for `demo`/`stack` commands ([#429]).
 - Add confirmation prompt to `install` subcommand for namespace selection ([#429]).
 - Add `--assume-yes` option for running commands non-interactively ([#429]).
+- Support Helm charts sourced from OCI registries in demo/stack manifests ([#440]).
 
 [#429]: https://github.com/stackabletech/stackable-cockpit/pull/429
 [#438]: https://github.com/stackabletech/stackable-cockpit/pull/438
+[#440]: https://github.com/stackabletech/stackable-cockpit/pull/440
 
 ## [1.4.0] - 2026-03-18