kube_cluster 0.7.0 → 0.9.0

data/lib/kube/cluster/standard/custom_resource_definition.rb

@@ -0,0 +1,82 @@
+# frozen_string_literal: true
+
+require "bundler/setup"
+require "kube/cluster"
+
+module Kube
+  module Cluster
+    module Standard
+      class CustomResourceDefinition < Kube::Cluster['CustomResourceDefinition']
+        def initialize(
+          kind:, group:, version: 'v1', scope: 'Namespaced',
+          short_names: [], categories: [], schema: nil, &block
+        )
+
+          plural   = kind.downcase.pluralize
+          singular = kind.downcase
+
+          schema ||= {
+            type: 'object',
+            'x-kubernetes-preserve-unknown-fields': true
+          }
+
+          super() {
+            metadata.name = "#{plural}.#{group}"
+
+            spec.group          = group
+            spec.names.kind     = kind
+            spec.names.listKind = "#{kind}List"
+            spec.names.plural   = plural
+            spec.names.singular = singular
+            spec.names.shortNames = short_names unless short_names.empty?
+            spec.names.categories = categories  unless categories.empty?
+            spec.scope          = scope
+            spec.versions = [{
+              name:         version,
+              served:       true,
+              storage:      true,
+              subresources: { status: {} },
+              schema: {
+                openAPIV3Schema: schema
+              }
+            }]
+
+            instance_exec(&block) if block
+          }
+
+          api_version = "#{group}/#{version}"
+          Kube::Schema.register(
+            kind,
+            schema:      {
+              'type' => 'object',
+              'properties' => {
+                'apiVersion' => { 'type' => 'string' },
+                'kind'       => { 'type' => 'string' },
+                'metadata'   => { 'type' => 'object' },
+                'spec'       => { 'type' => 'object', 'x-kubernetes-preserve-unknown-fields' => true },
+                'status'     => { 'type' => 'object', 'x-kubernetes-preserve-unknown-fields' => true }
+              },
+              'x-kubernetes-preserve-unknown-fields' => true
+            },
+            api_version: api_version
+          )
+        end
+      end
+    end
+  end
+end
+
+test do
+  describe "CustomResourceDefinition" do
+    it "initializes without error" do
+      Kube::Cluster::Standard::CustomResourceDefinition
+        .new(
+          kind: "Widget",
+          group: "example.com",
+        )
+        .to_yaml
+        .is_a?(String)
+        .should == true
+    end
+  end
+end

data/lib/kube/cluster/standard/daemon_set.rb

@@ -0,0 +1,70 @@
+# frozen_string_literal: true
+
+require 'kube/cluster'
+require 'kube/cluster/standard/env_processing'
+require 'kube/cluster/standard/volume_processing'
+
+module Kube
+  module Cluster
+    module Standard
+      class DaemonSet < Kube::Cluster['DaemonSet']
+        def initialize(
+          name:,
+          image:,
+          env: {},
+          volume_mounts: {},
+          command: nil,
+          service_account: nil,
+          node_selector: nil,
+          tolerations: nil,
+          host_pid: false,
+          &block
+        )
+          processed_env     = EnvProcessing.process(env)
+          processed_volumes = VolumeProcessing.process(volume_mounts)
+
+          super() {
+            metadata.name   = name
+            metadata.labels = { 'app' => name }
+
+            spec.selector.matchLabels = { 'app' => name }
+
+            spec.template.metadata.labels        = { 'app' => name }
+            spec.template.spec.serviceAccountName = service_account || name
+
+            container = {
+              name:  name,
+              image: image,
+              env:   processed_env
+            }
+            container[:command] = command if command
+            container[:volumeMounts] = processed_volumes[:volume_mounts] unless processed_volumes[:volume_mounts].empty?
+
+            spec.template.spec.containers = [container]
+            spec.template.spec.volumes = processed_volumes[:volumes] unless processed_volumes[:volumes].empty?
+            spec.template.spec.hostPID = true if host_pid
+            spec.template.spec.nodeSelector = node_selector if node_selector
+            spec.template.spec.tolerations = tolerations if tolerations
+
+            instance_exec(&block) if block
+          }
+        end
+      end
+    end
+  end
+end
+
+test do
+  describe "DaemonSet" do
+    it "initializes without error" do
+      Kube::Cluster::Standard::DaemonSet
+        .new(
+          name: "my-daemon",
+          image: "busybox",
+        )
+        .to_yaml
+        .is_a?(String)
+        .should == true
+    end
+  end
+end

data/lib/kube/cluster/standard/eso/external_secret.rb

@@ -0,0 +1,96 @@
+# frozen_string_literal: true
+
+require "bundler/setup"
+require "kube/cluster"
+
+module Kube
+  module Cluster
+    module Standard
+      module ESO
+        class ExternalSecret < Kube::Cluster['ExternalSecret']
+          # Returned by .template — carries the secret ref and template value.
+          # When the env hash is processed, the key becomes both the env var name
+          # and the secret template data key.
+          TemplateRef = Struct.new(:secret, :template_value)
+
+          # Returned by .key — carries the secret ref and key name.
+          # When the volume_mounts hash is processed, this tells the volume
+          # processing layer to mount a single key from the secret as a file.
+          KeyRef = Struct.new(:secret, :key_name)
+
+          attr_reader :secret_name
+
+          def initialize(name:, store:, remote_key:, keys: nil, deletion_policy: nil, &block)
+            @secret_name = name
+            @remote_key = remote_key
+            @_template_data = {}
+            @_remote_properties = {}
+            @_keys = keys
+            @_deletion_policy = deletion_policy
+
+            super() do
+              metadata.name = name
+              spec.refreshInterval = '1h'
+              spec.secretStoreRef = { kind: 'ClusterSecretStore', name: store }
+
+              target = { name: name, creationPolicy: 'Owner' }
+              target[:deletionPolicy] = deletion_policy if deletion_policy
+              spec.target = target
+
+              if keys
+                spec.data = keys.map do |secret_key, property|
+                  { secretKey: secret_key, remoteRef: { key: remote_key, property: property } }
+                end
+              end
+
+              instance_exec(&block) if block
+            end
+          end
+
+          # Returns a TemplateRef. The env hash processor calls .register!
+          # on the ref to wire up the template data and remote properties.
+          def template(template_string)
+            TemplateRef.new(self, template_string)
+          end
+          alias with_template template
+
+          # Returns a KeyRef for mounting a single key from this secret as a file.
+          # The volume processing layer uses this to generate the volume and mount.
+          def key(key_name)
+            KeyRef.new(self, key_name)
+          end
+
+          # Called by env processing to register a template entry.
+          def register_template!(env_key, template_string)
+            @_template_data[env_key] = template_string
+
+            template_string.scan(/\{\{\s*\.(\w+)\s*\}\}/) do |match|
+              @_remote_properties[match[0]] = true
+            end
+
+            @data.spec.target.template = { data: @_template_data }
+            @data.spec.data = @_remote_properties.keys.map do |prop|
+              { secretKey: prop, remoteRef: { key: @remote_key, property: prop } }
+            end
+          end
+        end
+      end
+    end
+  end
+end
+
+test do
+  describe "ESO::ExternalSecret" do
+    it "initializes without error" do
+      Kube::Cluster::Standard::ESO::ExternalSecret
+        .new(
+          name: "my-external-secret",
+          store: "my-cluster-store",
+          remote_key: "secret/data/my-app",
+        )
+        .to_yaml
+        .is_a?(String)
+        .should == true
+    end
+  end
+end

data/lib/kube/cluster/standard/forgejo/helm.rb

@@ -0,0 +1,64 @@
+# frozen_string_literal: true
+
+require "bundler/setup"
+require "kube/cluster"
+
+module Kube
+  module Cluster
+    module Standard
+      module Forgejo
+        class Helm < Kube::Cluster["HelmChart"]
+
+          CHART_VERSION = "16.2.1"
+
+          def initialize(
+            domain:,
+            chart_version: CHART_VERSION,
+            target_namespace: "default",
+            storage_size: "200Gi",
+            storage_class: "local-path",
+            node_selector: nil,
+            &block
+          )
+            super {
+              metadata.name = "forgejo"
+              metadata.namespace = "kube-system"
+              spec.version = chart_version
+              spec.chart = "oci://codeberg.org/forgejo-contrib/forgejo"
+              spec.targetNamespace = target_namespace
+              spec.valuesContent = <<~YAML
+                gitea:
+                  config:
+                    server:
+                      ROOT_URL: https://#{domain}/
+                      DOMAIN: #{domain}
+                      SSH_DOMAIN: #{domain}
+                persistence:
+                  enabled: true
+                  size: #{storage_size}
+                  storageClass: #{storage_class}
+                #{node_selector ? "nodeSelector:\n  kubernetes.io/hostname: #{node_selector}" : ""}
+              YAML
+
+              instance_exec(&block) if block
+            }
+          end
+        end
+      end
+    end
+  end
+end
+
+test do
+  describe "Forgejo::Helm" do
+    it "initializes without error" do
+      Kube::Cluster::Standard::Forgejo::Helm
+        .new(
+          domain: "git.facebook.com"
+        )
+        .to_yaml
+        .is_a?(String)
+        .should == true
+    end
+  end
+end

data/lib/kube/cluster/standard/gateway_api/http_route.rb

@@ -0,0 +1,33 @@
+# frozen_string_literal: true
+
+require "bundler/setup"
+require "kube/cluster"
+
+module Kube
+  module Cluster   
+    module Standard
+      module GatewayApi
+        #class HTTPRoute < Kube::Cluster::Manifest
+        #end
+      end
+    end
+  end
+end
+
+test do
+  #describe "GatewayApi::HTTPRoute" do
+  #  it "initializes without error" do
+  #    Kube::Cluster::Standard::GatewayApi::HTTPRoute
+  #      .new(
+  #        name: nil,
+  #        hostname: nil,
+  #        service: nil,
+  #        namespace: nil,
+  #        port: nil,
+  #      )
+  #      .to_yaml
+  #      .is_a?(String)
+  #      .should == true
+  #  end
+  #end
+end

data/lib/kube/cluster/standard/job.rb

@@ -0,0 +1,50 @@
+# frozen_string_literal: true
+
+require "bundler/setup"
+require "kube/cluster"
+
+module Kube
+  module Cluster
+    module Standard
+      class Job < Kube::Cluster["Secret"]
+        def initialize(name:, image:, env: {}, command: nil, backoff_limit: 3, ttl: 300, &block)
+          processed_env = EnvProcessing.process(env)
+
+          super() do
+            metadata.name = name
+
+            spec.backoffLimit = backoff_limit
+            spec.ttlSecondsAfterFinished = ttl
+            spec.template.spec.restartPolicy = 'OnFailure'
+
+            container = {
+              name: name,
+              image: image,
+              env: processed_env
+            }
+            container[:command] = command if command
+
+            spec.template.spec.containers = [container]
+
+            instance_exec(&block) if block
+          end
+        end
+      end
+    end
+  end
+end
+
+test do
+  describe "Job" do
+    it "initializes without error" do
+      Kube::Cluster::Standard::Job
+        .new(
+          name: "my-job",
+          image: "nixery.dev/cowsay", # nixery.dev is pretty sick, mate!
+        )
+        .to_yaml
+        .is_a?(String)
+        .should == true
+    end
+  end
+end

data/lib/kube/cluster/standard/kube_virt/virtual_machine.rb

@@ -0,0 +1,36 @@
+# frozen_string_literal: true
+
+require "bundler/setup"
+require "kube/cluster"
+
+module Kube
+  module Cluster
+    module Standard
+      module KubeVirt
+        class VirtualMachine < Kube::Cluster['VirtualMachine']
+          def initialize(name:, &block)
+            super() {
+              metadata.name = name
+              spec.template.metadata.labels = { 'kubevirt.io/domain' => name }
+              instance_exec(&block) if block
+            }
+          end
+        end
+      end
+    end
+  end
+end
+
+test do
+  describe "KubeVirt::VirtualMachine" do
+    it "initializes without error" do
+      Kube::Cluster::Standard::KubeVirt::VirtualMachine
+        .new(
+          name: "my-virtual-machine"
+        )
+        .to_yaml
+        .is_a?(String)
+        .should == true
+    end
+  end
+end

data/lib/kube/cluster/standard/meta_controller/composite_controller.rb

@@ -0,0 +1,80 @@
+# frozen_string_literal: true
+
+# TEMPORARILY DISABLED: metacontroller.k8s.io CRDs (CompositeController) are not
+# registered in kube_schema, so subclassing the kind raises at load time and
+# aborts `require "kube/cluster"`. Commented out until the schema is registered.
+=begin
+require "bundler/setup"
+require "kube/cluster"
+
+module Kube
+  module Cluster   
+    module Standard
+      module MetaController
+        class CompositeController < Kube::Cluster['CompositeController'] 
+          def initialize(
+            name:, webhook_url:,
+            resync_period: 30, parent_resource:, child_resources: {}, &block
+          )
+
+            resolved_parent   = resolve_ref(parent_resource)
+            resolved_children = resolve_hash(child_resources)
+    
+            super() {
+              metadata.name = "#{name}-composite-controller"
+              
+              spec.generateSelector    = true
+              spec.resyncPeriodSeconds = resync_period
+              spec.hooks.sync.webhook  = { url: webhook_url }
+              spec.parentResource      = resolved_parent
+              spec.childResources      = resolved_children
+              
+              instance_exec(&block) if block
+            } 
+          end
+          
+          private
+          
+            def resolve_ref(ref)
+              if ref.is_a?(Hash)
+                ref
+              else
+                if ref.is_a?(Class)
+                  klass = ref
+                else
+                  klass = ref.class
+                end
+
+                {
+                  apiVersion: klass.defaults['apiVersion'],
+                  resource:   klass.defaults['kind'].downcase.pluralize
+                } 
+              end 
+            end
+            
+            def resolve_hash(hash)
+              hash.map do |klass, options|
+                resolve_ref(klass).merge(options || {})
+              end
+            end
+        end 
+      end
+    end
+  end
+end
+
+test do
+  describe "MetaController::CompositeController" do
+    it "initializes without error" do
+      Kube::Cluster::Standard::MetaController::CompositeController
+        .new(
+          name: nil,
+          webhook_url: nil,
+        )
+        .to_yaml
+        .is_a?(String)
+        .should == true
+    end
+  end
+end
+=end

data/lib/kube/cluster/standard/meta_controller/decorator_controller.rb

@@ -0,0 +1,79 @@
+# frozen_string_literal: true
+
+# TEMPORARILY DISABLED: metacontroller.k8s.io CRDs (DecoratorController) are not
+# registered in kube_schema, so subclassing the kind raises at load time and
+# aborts `require "kube/cluster"`. Commented out until the schema is registered.
+=begin
+require "bundler/setup"
+require "kube/cluster"
+
+module Kube
+  module Cluster   
+    module Standard
+      module MetaController
+        class DecoratorController < Kube::Cluster['DecoratorController'] 
+          def initialize(
+            name:, webhook_url:,
+            resync_period: 30, resources: {}, attachments: {}, &block
+          )
+
+            resolved_resources   = resolve_hash(resources)
+            resolved_attachments = resolve_hash(attachments)
+
+            super() {
+              metadata.name = name
+
+              spec.resources           = resolved_resources
+              spec.attachments         = resolved_attachments
+              spec.resyncPeriodSeconds = resync_period
+              spec.hooks.sync.webhook  = { url: webhook_url }
+
+              instance_exec(&block) if block
+            }
+          end
+
+          private
+
+            def resolve_ref(ref)
+              if ref.is_a?(Hash)
+                ref
+              else
+                if ref.is_a?(Class)
+                  klass = ref
+                else
+                  klass = ref.class
+                end
+
+                {
+                  apiVersion: klass.defaults['apiVersion'],
+                  resource:   klass.defaults['kind'].downcase.pluralize
+                }
+              end 
+            end
+
+            def resolve_hash(hash)
+              hash.map do |klass, options|
+                resolve_ref(klass).merge(options || {})
+              end
+            end
+        end
+      end
+    end
+  end
+end
+
+test do
+  describe "MetaController::DecoratorController" do
+    it "initializes without error" do
+      Kube::Cluster::Standard::MetaController::DecoratorController
+        .new(
+          name: nil,
+          webhook_url: nil,
+        )
+        .to_yaml
+        .is_a?(String)
+        .should == true
+    end
+  end
+end
+=end

data/lib/kube/cluster/standard/persistent_volume_claim.rb

@@ -0,0 +1,37 @@
+# frozen_string_literal: true
+
+require "bundler/setup"
+require "kube/cluster"
+
+module Kube
+  module Cluster
+    module Standard
+      class PersistentVolumeClaim < Kube::Cluster["PersistentVolumeClaim"]
+        def initialize(name:, storage:, access_modes: ["ReadWriteOnce"], storage_class: nil, &block)
+          super() {
+            metadata.name = name
+            spec.accessModes = access_modes
+            spec.storageClassName = storage_class if storage_class
+            spec.resources = { requests: { storage: storage } }
+            instance_exec(&block) if block_given?
+          }
+        end
+      end
+    end
+  end
+end
+
+test do
+  describe "PersistentVolumeClaim" do
+    it "initializes without error" do
+      Kube::Cluster::Standard::PersistentVolumeClaim
+        .new(
+          name: "my-volume",
+          storage: "25Gi",
+        )
+        .to_yaml
+        .is_a?(String)
+        .should == true
+    end
+  end
+end

data/lib/kube/cluster/version.rb

@@ -2,6 +2,6 @@
 
 module Kube
   module Cluster
-    VERSION = "0.7.0"
+    VERSION = "0.9.0"
   end
 end

data/lib/kube/cluster.rb

@@ -3,6 +3,7 @@
 require "bundler/setup"
 require "scampi"
 require "kube/schema"
+require "active_support/core_ext/string/inflections"
 
 require_relative "../kube/errors"
 require_relative "cluster/version"