matsuri 0.1.0 → 0.3.0

data/tests/example/platform/pods/checkout.rb

@@ -0,0 +1,27 @@
+# Checkout runs on its dedicated pool where one exists. The container
+# carries no image and no resources: a deployment operator owns the tag
+# and an in-place autoscaler owns the sizing. The stack seeds both at
+# creation.
+Matsuri.define :pod, 'checkout' do
+  include Acme::Pods::Healthcheck
+
+  let(:labels) { { 'app' => 'checkout' } }
+
+  # Node selection is per-environment: local clusters have no dedicated
+  # pool, so the scheduling vocabulary stays out entirely.
+  case Matsuri.environment
+  when 'checkout_staging'
+    include Acme::Nodes::Dedicated
+    let(:dedicated_key) { 'checkout' }
+    let(:node_selector) { dedicated_node_selector }
+    let(:tolerations)   { [dedicated_toleration] }
+  end
+
+  let(:volumes) { [] }
+  let(:container) do
+    {
+      name:           'checkout',
+      readinessProbe: readiness_probe
+    }
+  end
+end

data/tests/example/platform/services/billing-web.rb

@@ -0,0 +1,6 @@
+# Selects on the same labels the deployment selects on, by asking the
+# deployment rather than restating them.
+Matsuri.define :service, 'billing-web' do
+  let(:port_num) { 8000 }
+  let(:selector) { deployment('billing-web').match_labels }
+end

data/tests/example/platform/services/checkout-web.rb

@@ -0,0 +1,4 @@
+Matsuri.define :service, 'checkout-web' do
+  let(:port_num) { 8000 }
+  let(:selector) { deployment('checkout-web').match_labels }
+end

data/tests/example/platform/stacks/billing.rb

@@ -0,0 +1,8 @@
+# Classic delivery: matsuri owns every field and converges by
+# client-side apply. One management promise, in this sequence.
+Matsuri.define :stack, 'billing' do
+  needs :config_map, 'cacerts'
+  needs :config_map, 'billing-settings'
+  needs :deployment, 'billing-web'
+  needs :service,    'billing-web'
+end

data/tests/example/platform/stacks/checkout.rb

@@ -0,0 +1,19 @@
+# Server-side delivery: matsuri manages the fields it declares and
+# cedes the rest. The seeds complete the create payload only — the
+# first converge routes through the seeding protocol (seeded create,
+# declared apply, cede), then the deployment operator takes the image,
+# the HPA takes the count, and the in-place autoscaler takes sizing.
+Matsuri.define :stack, 'checkout' do
+  needs :deployment, 'checkout-web'
+  needs :service,    'checkout-web'
+
+  present :on_create, match_deployments(seed_replicas(2))
+  present :on_create, match_deployments(seed_image('registry.acme.io/checkout:boot'))
+  present :on_create, match_deployments(seed_resources(requests: { cpu: '250m', memory: '256Mi' }))
+
+  # Both regimes declare in persistence normal form: an empty value is a
+  # ceded field, never an ownership claim, so the create's echo equals
+  # the declaration and co-ownership holds.
+  present :on_create, prune_empty
+  present :on_apply,  prune_empty
+end

data/tests/k8s/save-config/deployment-declared.yaml

@@ -0,0 +1,19 @@
+# The ongoing apply payload: the declaration with the seeded field absent.
+# Don't-clobber is structural — replicas is simply not here to send.
+apiVersion: apps/v1
+kind: Deployment
+metadata:
+  name: save-config-probe
+  namespace: matsuri-probes
+spec:
+  selector:
+    matchLabels:
+      app: save-config-probe
+  template:
+    metadata:
+      labels:
+        app: save-config-probe
+    spec:
+      containers:
+        - name: pause
+          image: registry.k8s.io/pause:3.9

data/tests/k8s/save-config/deployment-seeded.yaml

@@ -0,0 +1,20 @@
+# The create payload: the declaration plus the seeded replicas. Sent once,
+# by create, without --save-config.
+apiVersion: apps/v1
+kind: Deployment
+metadata:
+  name: save-config-probe
+  namespace: matsuri-probes
+spec:
+  replicas: 3
+  selector:
+    matchLabels:
+      app: save-config-probe
+  template:
+    metadata:
+      labels:
+        app: save-config-probe
+    spec:
+      containers:
+        - name: pause
+          image: registry.k8s.io/pause:3.9

data/tests/k8s/save-config/namespace.yaml

@@ -0,0 +1,4 @@
+apiVersion: v1
+kind: Namespace
+metadata:
+  name: matsuri-probes

data/tests/k8s/ssa/declared-bumped.yaml

@@ -0,0 +1,22 @@
+# The first ordinary deploy after creation: same declaration, one
+# declared value changed. Probes whether the ongoing manager can change
+# its own fields cleanly while still omitting the seeds.
+apiVersion: apps/v1
+kind: Deployment
+metadata:
+  name: seed-via-create
+  namespace: matsuri-probes
+spec:
+  selector:
+    matchLabels:
+      app: seed-via-create
+  template:
+    metadata:
+      labels:
+        app: seed-via-create
+    spec:
+      containers:
+        - name: pause
+          env:
+            - name: DECLARED
+              value: two

data/tests/k8s/ssa/declared.yaml

@@ -0,0 +1,22 @@
+# The ongoing declaration: image and replicas are seeds, so the payload
+# omits both — the container entry rides on its name key alone. Fields
+# not sent are never contested; that is the whole seeds+SSA bet.
+apiVersion: apps/v1
+kind: Deployment
+metadata:
+  name: seed-via-create
+  namespace: matsuri-probes
+spec:
+  selector:
+    matchLabels:
+      app: seed-via-create
+  template:
+    metadata:
+      labels:
+        app: seed-via-create
+    spec:
+      containers:
+        - name: pause
+          env:
+            - name: DECLARED
+              value: one

data/tests/k8s/ssa/namespace.yaml

@@ -0,0 +1,4 @@
+apiVersion: v1
+kind: Namespace
+metadata:
+  name: matsuri-probes

data/tests/k8s/ssa/seed-via-create.yaml

@@ -0,0 +1,24 @@
+# Seed via create: the declaration plus the seeded image and replicas,
+# sent once by an imperative create. Seeded = declared + seeds; both
+# come from the same definition, so shared fields agree by construction.
+apiVersion: apps/v1
+kind: Deployment
+metadata:
+  name: seed-via-create
+  namespace: matsuri-probes
+spec:
+  replicas: 3
+  selector:
+    matchLabels:
+      app: seed-via-create
+  template:
+    metadata:
+      labels:
+        app: seed-via-create
+    spec:
+      containers:
+        - name: pause
+          image: registry.k8s.io/pause:3.9
+          env:
+            - name: DECLARED
+              value: one

metadata

@@ -1,43 +1,168 @@
 --- !ruby/object:Gem::Specification
 name: matsuri
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.3.0
 platform: ruby
 authors:
 - Ho-Sheng Hsiao
-autorequire: 
-bindir: exe
+bindir: bin
 cert_chain: []
-date: 2015-09-14 00:00:00.000000000 Z
+date: 1980-01-01 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
-  name: bundler
+  name: base64
+  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: thor
+  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: mixlib-shellout
+  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: mixlib-config
+  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: rlet
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.10'
-  type: :development
+        version: 0.7.0
+  type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.10'
+        version: 0.7.0
+- !ruby/object:Gem::Dependency
+  name: map
+  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: hashdiff
+  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: rainbow
+  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: unit
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.5.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.5.0
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '2.4'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '2.4'
 - !ruby/object:Gem::Dependency
   name: rake
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '10.0'
+        version: '13.0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '10.0'
+        version: '13.0'
 - !ruby/object:Gem::Dependency
   name: rspec
   requirement: !ruby/object:Gem::Requirement
@@ -54,27 +179,173 @@ dependencies:
         version: '0'
 description: Framework and toolkit to build a dev environment using Docker and Kubernetes
 email:
-- hosh@shopapps.co
-executables: []
+- ho-sheng.hsiao@solace.health
+executables:
+- console
+- matsuri
+- setup
 extensions: []
 extra_rdoc_files: []
 files:
+- ".envrc"
 - ".gitignore"
 - ".rspec"
-- ".travis.yml"
+- ".rubocop.yml"
+- AGENTS.md
+- CHANGELOG.md
 - Gemfile
 - LICENSE
 - README.md
 - Rakefile
 - bin/console
+- bin/matsuri
 - bin/setup
+- docs/acceptors.md
+- docs/boot.md
+- docs/design/acceptors.md
+- docs/design/boot.md
+- docs/design/ssa.md
+- docs/design/stacks.md
+- docs/diff.md
+- docs/known-issues.md
+- docs/local-dev.md
+- docs/presenters.md
+- docs/resources.md
+- docs/setup.md
+- docs/ssa.md
+- docs/stacks.md
+- flake.lock
+- flake.nix
 - lib/matsuri.rb
+- lib/matsuri/acceptor.rb
+- lib/matsuri/acceptors/image_tag.rb
+- lib/matsuri/cmd.rb
+- lib/matsuri/cmds/apply.rb
+- lib/matsuri/cmds/cli.rb
+- lib/matsuri/cmds/create.rb
+- lib/matsuri/cmds/delete.rb
+- lib/matsuri/cmds/diff.rb
+- lib/matsuri/cmds/generate.rb
+- lib/matsuri/cmds/kubectl.rb
+- lib/matsuri/cmds/recreate.rb
+- lib/matsuri/cmds/scale.rb
+- lib/matsuri/cmds/show.rb
+- lib/matsuri/cmds/status.rb
+- lib/matsuri/concerns/awaiting.rb
+- lib/matsuri/concerns/diffable.rb
+- lib/matsuri/concerns/export_manifest.rb
+- lib/matsuri/concerns/import_manifest.rb
+- lib/matsuri/concerns/pod_template.rb
+- lib/matsuri/concerns/pods/spread_pods.rb
+- lib/matsuri/concerns/pods/spread_topology.rb
+- lib/matsuri/concerns/registry_helpers.rb
+- lib/matsuri/config.rb
+- lib/matsuri/core_ext.rb
+- lib/matsuri/dsl/cluster/aggregated_cluster_role.rb
+- lib/matsuri/dsl/cluster/binding.rb
+- lib/matsuri/dsl/cluster/cluster_role.rb
+- lib/matsuri/dsl/cluster/role.rb
+- lib/matsuri/dsl/cluster/scope.rb
+- lib/matsuri/dsl/cluster/service_account.rb
+- lib/matsuri/dsl/concerns/default_binding.rb
+- lib/matsuri/dsl/concerns/manifest_set.rb
+- lib/matsuri/dsl/concerns/metadata.rb
+- lib/matsuri/dsl/concerns/rbac_rules.rb
+- lib/matsuri/initializer.rb
+- lib/matsuri/kubernetes/base.rb
+- lib/matsuri/kubernetes/config_map.rb
+- lib/matsuri/kubernetes/cron_job.rb
+- lib/matsuri/kubernetes/daemon_set.rb
+- lib/matsuri/kubernetes/deployment.rb
+- lib/matsuri/kubernetes/endpoints.rb
+- lib/matsuri/kubernetes/horizontal_pod_autoscaler.rb
+- lib/matsuri/kubernetes/imported_manifest.rb
+- lib/matsuri/kubernetes/ingress.rb
+- lib/matsuri/kubernetes/persistent_volume.rb
+- lib/matsuri/kubernetes/persistent_volume_claim.rb
+- lib/matsuri/kubernetes/pod.rb
+- lib/matsuri/kubernetes/replica_set.rb
+- lib/matsuri/kubernetes/secret.rb
+- lib/matsuri/kubernetes/service.rb
+- lib/matsuri/kubernetes/stateful_set.rb
+- lib/matsuri/kubernetes/storage_class.rb
+- lib/matsuri/platform.rb
+- lib/matsuri/presenter.rb
+- lib/matsuri/presenters/helpers.rb
+- lib/matsuri/presenters/prune_empty.rb
+- lib/matsuri/presenters/seed_image.rb
+- lib/matsuri/presenters/seed_replicas.rb
+- lib/matsuri/presenters/seed_resources.rb
+- lib/matsuri/registry.rb
+- lib/matsuri/shell_out.rb
+- lib/matsuri/stack.rb
+- lib/matsuri/task.rb
+- lib/matsuri/tasks/cluster.rb
+- lib/matsuri/tasks/docker.rb
+- lib/matsuri/tasks/hash_diff.rb
+- lib/matsuri/tasks/kubectl.rb
+- lib/matsuri/tasks/kubectl_ops.rb
+- lib/matsuri/tasks/kubectl_ops/apply.rb
+- lib/matsuri/tasks/kubectl_ops/create.rb
+- lib/matsuri/tasks/kubectl_ops/delete.rb
+- lib/matsuri/tasks/kubectl_ops/diff.rb
+- lib/matsuri/tasks/kubectl_ops/get.rb
+- lib/matsuri/tasks/kubectl_ops/recreate.rb
+- lib/matsuri/tasks/kubectl_ops/replace.rb
+- lib/matsuri/tasks/kubectl_ops/rollout_status.rb
+- lib/matsuri/tasks/kubectl_ops/scale.rb
+- lib/matsuri/tasks/kubectl_ops/server_side_apply.rb
+- lib/matsuri/tasks/kubectl_ops/status.rb
+- lib/matsuri/tasks/pod.rb
+- lib/matsuri/tasks/stacks.rb
+- lib/matsuri/tasks/stacks/seed.rb
+- lib/matsuri/transform.rb
+- lib/matsuri/transform/algebra.rb
+- lib/matsuri/transform/callable.rb
+- lib/matsuri/transform/combinators.rb
+- lib/matsuri/transform/env.rb
+- lib/matsuri/transform/kubernetes.rb
 - lib/matsuri/version.rb
 - matsuri.gemspec
-homepage: https://github.com/shopappsio/matsuri
+- tests/bin/minikube-start.sh
+- tests/bin/probe-save-config.sh
+- tests/bin/probe-ssa.sh
+- tests/example/.gitignore
+- tests/example/Gemfile
+- tests/example/README.md
+- tests/example/bin/matsuri
+- tests/example/config/initializer.rb
+- tests/example/config/matsuri.rb
+- tests/example/config/platform.rb
+- tests/example/lib/acme.rb
+- tests/example/lib/acme/nodes/dedicated.rb
+- tests/example/lib/acme/nodes/preemptible.rb
+- tests/example/lib/acme/nodes/required_cores.rb
+- tests/example/lib/acme/nodes/resource_class.rb
+- tests/example/lib/acme/pods/cacerts.rb
+- tests/example/lib/acme/pods/healthcheck.rb
+- tests/example/platform/config_maps/billing-settings.rb
+- tests/example/platform/config_maps/cacerts.rb
+- tests/example/platform/deployments/billing-web.rb
+- tests/example/platform/deployments/checkout-web.rb
+- tests/example/platform/namespaces/billing-dev.yaml
+- tests/example/platform/namespaces/checkout-dev.yaml
+- tests/example/platform/pods/billing.rb
+- tests/example/platform/pods/checkout.rb
+- tests/example/platform/services/billing-web.rb
+- tests/example/platform/services/checkout-web.rb
+- tests/example/platform/stacks/billing.rb
+- tests/example/platform/stacks/checkout.rb
+- tests/k8s/save-config/deployment-declared.yaml
+- tests/k8s/save-config/deployment-seeded.yaml
+- tests/k8s/save-config/namespace.yaml
+- tests/k8s/ssa/declared-bumped.yaml
+- tests/k8s/ssa/declared.yaml
+- tests/k8s/ssa/namespace.yaml
+- tests/k8s/ssa/seed-via-create.yaml
+homepage: https://github.com/matsuri-rb/matsuri
 licenses: []
 metadata: {}
-post_install_message: 
 rdoc_options: []
 require_paths:
 - lib
@@ -82,17 +353,14 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: '0'
+      version: '3.2'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubyforge_project: 
-rubygems_version: 2.4.5
-signing_key: 
+rubygems_version: 3.7.2
 specification_version: 4
 summary: Build a dev environment using Docker and Kubernetes
 test_files: []
-has_rdoc: 

data/.travis.yml

@@ -1,4 +0,0 @@
-language: ruby
-rvm:
-  - 2.2.2
-before_install: gem install bundler -v 1.10.6