kube_cluster 0.3.2 → 0.3.4

data/lib/kube/helm/endpoint.rb

@@ -0,0 +1,75 @@
+# frozen_string_literal: true
+
+module Kube
+  module Helm
+    # Abstracts the differences between Helm chart sources.
+    #
+    # Traditional Helm repos require `helm repo add` before charts can be
+    # referenced, and charts are addressed as "repo-name/chart-name".
+    #
+    # OCI registries need no `repo add` step, and charts are addressed as
+    # the full OCI URI: "oci://host/path/chart-name".
+    #
+    #   endpoint = Kube::Helm::Endpoint.new("https://charts.bitnami.com/bitnami")
+    #   endpoint.oci?           #=> false
+    #   endpoint.requires_add?  #=> true
+    #   endpoint.chart_ref("nginx", repo_name: "bitnami")
+    #   #=> "bitnami/nginx"
+    #
+    #   endpoint = Kube::Helm::Endpoint.new("oci://ghcr.io/my-org/charts")
+    #   endpoint.oci?           #=> true
+    #   endpoint.requires_add?  #=> false
+    #   endpoint.chart_ref("nginx")
+    #   #=> "oci://ghcr.io/my-org/charts/nginx"
+    #
+    class Endpoint
+      attr_reader :url
+
+      def initialize(url)
+        raise ArgumentError, "url must be a String" unless url.is_a?(String)
+        raise ArgumentError, "url must not be empty" if url.strip.empty?
+
+        @url = url.chomp("/")
+      end
+
+      # Is this an OCI registry endpoint?
+      def oci?
+        @url.start_with?("oci://")
+      end
+
+      # Traditional Helm repos require `helm repo add`; OCI registries do not.
+      def requires_add?
+        !oci?
+      end
+
+      # Build the chart reference string Helm expects.
+      #
+      # For OCI:         "oci://host/path/chart-name"
+      # For traditional: "repo-name/chart-name"
+      #
+      # @param chart_name [String] the chart name (e.g. "nginx")
+      # @param repo_name [String, nil] the local repo alias (required for non-OCI)
+      # @return [String]
+      def chart_ref(chart_name, repo_name: nil)
+        if oci?
+          "#{@url}/#{chart_name}"
+        else
+          if repo_name.nil?
+            raise ArgumentError,
+              "repo_name is required for non-OCI endpoints"
+          end
+
+          "#{repo_name}/#{chart_name}"
+        end
+      end
+
+      def to_s
+        @url
+      end
+
+      def ==(other)
+        other.is_a?(Endpoint) && other.url == @url
+      end
+    end
+  end
+end

data/lib/kube/helm/repo.rb

@@ -0,0 +1,121 @@
+# frozen_string_literal: true
+
+require_relative "endpoint"
+require_relative "chart"
+
+module Kube
+  module Helm
+    # Models a Helm chart repository (traditional or OCI).
+    #
+    # Wraps the lifecycle commands (`helm repo add`, `helm repo update`,
+    # `helm repo remove`) and fetches charts for rendering.
+    #
+    # When a +cluster+ is provided, all Helm commands are scoped to that
+    # cluster's kubeconfig.
+    #
+    #   repo = Kube::Helm::Repo.new("bitnami", url: "https://charts.bitnami.com/bitnami")
+    #   chart = repo.fetch("nginx", version: "18.1.0")
+    #   manifest = chart.apply_values({ "replicaCount" => 3 })
+    #
+    #   # One-liner
+    #   manifest = Kube::Helm::Repo
+    #     .new("bitnami", url: "https://charts.bitnami.com/bitnami")
+    #     .fetch("nginx", version: "18.1.0")
+    #     .apply_values({ "replicaCount" => 3 })
+    #
+    class Repo
+      attr_reader :name, :endpoint, :cluster
+
+      # @param name [String] local alias for this repo (e.g. "bitnami")
+      # @param url [String] repository URL (http(s) for traditional, oci:// for OCI)
+      # @param cluster [Kube::Cluster::Instance, nil] optional cluster connection
+      def initialize(name, url:, cluster: nil)
+        unless name.is_a?(String) && !name.strip.empty?
+          raise ArgumentError, "name must be a non-empty String"
+        end
+
+        @name     = name
+        @endpoint = Endpoint.new(url)
+        @cluster  = cluster
+      end
+
+      # Register this repo with the local Helm client.
+      # No-op for OCI registries.
+      #
+      # @return [self]
+      def add
+        if endpoint.requires_add?
+          repo_name = @name
+          repo_url = endpoint.url
+          cmd = helm.call { repo.add.(repo_name).(repo_url) }
+          helm.run(cmd.to_s)
+        end
+        self
+      end
+
+      # Update the local chart index for this repo.
+      # No-op for OCI registries.
+      #
+      # @return [self]
+      def update
+        if endpoint.requires_add?
+          repo_name = @name
+          cmd = helm.call { repo.update.(repo_name) }
+          helm.run(cmd.to_s)
+        end
+        self
+      end
+
+      # Remove this repo from the local Helm client.
+      # No-op for OCI registries.
+      #
+      # @return [self]
+      def remove
+        if endpoint.requires_add?
+          repo_name = @name
+          cmd = helm.call { repo.remove.(repo_name) }
+          helm.run(cmd.to_s)
+        end
+        self
+      end
+
+      # Fetch a chart from this repo.
+      #
+      # Adds and updates the repo, retrieves the Chart.yaml metadata via
+      # `helm show chart`, and returns a Chart object with the ref set
+      # for subsequent helm commands.
+      #
+      # @param chart_name [String] the chart name (e.g. "nginx")
+      # @param version [String, nil] chart version constraint (e.g. "18.1.0")
+      # @return [Chart]
+      def fetch(chart_name, version: nil)
+        add
+        update
+
+        ref = endpoint.chart_ref(chart_name, repo_name: @name)
+
+        cmd = helm.call { show.chart.(ref) }
+        cmd = cmd.version(version) if version
+        yaml_output = helm.run(cmd.to_s)
+
+        data = YAML.safe_load(yaml_output, permitted_classes: [Symbol]) || {}
+        Chart.new(data, ref: ref, cluster: @cluster)
+      end
+
+      # Is this an OCI-backed repo?
+      def oci?
+        endpoint.oci?
+      end
+
+      def to_s
+        "#{@name} (#{endpoint.url})"
+      end
+
+      private
+
+        def helm
+          @cluster&.connection&.helm || Kube::Helm::Instance.new
+        end
+    end
+  end
+end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: kube_cluster
 version: !ruby/object:Gem::Version
-  version: 0.3.2
+  version: 0.3.4
 platform: ruby
 authors:
 - Nathan K
@@ -65,20 +65,6 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: 1.3.0
-- !ruby/object:Gem::Dependency
-  name: kube_kit
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">"
-      - !ruby/object:Gem::Version
-        version: '0'
-  type: :runtime
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">"
-      - !ruby/object:Gem::Version
-        version: '0'
 - !ruby/object:Gem::Dependency
   name: kube_kubectl
   requirement: !ruby/object:Gem::Requirement
@@ -120,20 +106,58 @@ files:
 - bin/tag-version
 - bin/test
 - docker-compose.yml
+- examples/01-basic-redis-pod/Gemfile
+- examples/01-basic-redis-pod/README.md
+- examples/01-basic-redis-pod/bin/dev
+- examples/01-basic-redis-pod/docker-compose.yml
 - examples/01-basic-redis-pod/manifest.rb
+- examples/01-basic-redis-pod/redis.conf
+- examples/02-manifest-with-middleware/Dockerfile
+- examples/02-manifest-with-middleware/Gemfile
+- examples/02-manifest-with-middleware/README.md
+- examples/02-manifest-with-middleware/bin/dev
+- examples/02-manifest-with-middleware/config.ru
+- examples/02-manifest-with-middleware/docker-compose.yml
+- examples/02-manifest-with-middleware/falcon.rb
 - examples/02-manifest-with-middleware/manifest.rb
 - examples/02-manifest-with-middleware/middleware/labels.rb
 - examples/02-manifest-with-middleware/middleware/namespace.rb
+- examples/02-manifest-with-middleware/registries.yaml
 - examples/02-manifest-with-middleware/templates/config_map.rb
 - examples/02-manifest-with-middleware/templates/deployment.rb
 - examples/02-manifest-with-middleware/templates/horizontal_pod_autoscaler.rb
 - examples/02-manifest-with-middleware/templates/ingress.rb
 - examples/02-manifest-with-middleware/templates/service.rb
+- examples/03-app-with-database/Gemfile
 - examples/03-app-with-database/demo.rb
 - examples/03-app-with-database/helpers.rb
 - examples/03-app-with-database/my_app.rb
 - examples/03-app-with-database/postgresql.rb
 - examples/03-app-with-database/ruby_on_rails.rb
+- examples/04-pod-with-ingress/Dockerfile
+- examples/04-pod-with-ingress/Gemfile
+- examples/04-pod-with-ingress/README.md
+- examples/04-pod-with-ingress/bin/dev
+- examples/04-pod-with-ingress/config.ru
+- examples/04-pod-with-ingress/docker-compose.yml
+- examples/04-pod-with-ingress/falcon.rb
+- examples/04-pod-with-ingress/manifest.rb
+- examples/04-pod-with-ingress/pod_with_ingress.rb
+- examples/04-pod-with-ingress/registries.yaml
+- examples/05-helm-chart-to-manifest/Gemfile
+- examples/05-helm-chart-to-manifest/README.md
+- examples/05-helm-chart-to-manifest/bin/dev
+- examples/05-helm-chart-to-manifest/docker-compose.yml
+- examples/05-helm-chart-to-manifest/manifest.rb
+- examples/06-nginx-with-cert-manager/Gemfile
+- examples/06-nginx-with-cert-manager/README.md
+- examples/06-nginx-with-cert-manager/bin/dev
+- examples/06-nginx-with-cert-manager/docker-compose.yml
+- examples/06-nginx-with-cert-manager/manifest.rb
+- examples/06-nginx-with-cert-manager/resources/namespace.rb
+- examples/06-nginx-with-cert-manager/resources/nginx.rb
+- examples/06-nginx-with-cert-manager/resources/self_signed_issuer.rb
+- examples/README.md
 - flake.lock
 - flake.nix
 - kube_cluster.gemspec
@@ -155,10 +179,15 @@ files:
 - lib/kube/cluster/middleware/stack.rb
 - lib/kube/cluster/resource.rb
 - lib/kube/cluster/resource/dirty_tracking.rb
+- lib/kube/cluster/resource/extensions/README.md
+- lib/kube/cluster/resource/extensions/custom_resource_definition.rb
 - lib/kube/cluster/resource/persistence.rb
 - lib/kube/cluster/version.rb
 - lib/kube/cluster/version.rb.erb
 - lib/kube/errors.rb
+- lib/kube/helm/chart.rb
+- lib/kube/helm/endpoint.rb
+- lib/kube/helm/repo.rb
 homepage: https://github.com/general-intelligence-systems/kube_cluster
 licenses:
 - Apache-2.0