Play with Capact

[mszostok]

Description

Preview URL:

• ~old: https://3dc9be72.website-8qa.pages.dev/blog/play-with-capact-via-cli~
• new: https://play-with-capact.website-8qa.pages.dev/blog/take-capact-for-a-spin

Changes proposed in this pull request:

• Add blog post describing "Play with Capact"
  • Change diagrams colors to match our website
  • Add diagrams for "dark" theme
  • Use simplified manifests

NOTE: The Argo UI, was was not described.

Blog related

Alternative titles:

• Experiment with Capact
• Your first night with Capact - could be controversial 👀

---

Alternative scenario:

I spot that current examples don't show another important value of Capact: glue different tools and unify it usage via Capact CLI. Because of that, I thought about a different example.

Currently, in both Implementations we use echo to produce just a different string. Instead, we could use helm and kubectl CLIs to produce the ConfigMap manifest.

Implementations:

• First,helm template hello-world which produces:

  # Source: hello-world/templates/config-map.yaml
  apiVersion: v1
  kind: ConfigMap
  metadata:
    name: hello-world
  data:
    message: |
      Hello World from Helm template

• and second, kubectl kustomize hello-world which produces:

  apiVersion: v1
  data:
  message: |
    Hello World from Kustomize
  kind: ConfigMap
  metadata:
  name: hello-world

By default, Helm template is used, By using proper Policy, the kubectl kustomize is used instead.

rules:
  - interface:
      path: cap.interface.capactio.examples.manifest
    oneOf:
    - implementationConstraints:
        attributes:
          - path: cap.attribute.capactio.examples.kustomize
            revision: 0.1.0

Pros:

• we can get rid of kubectl step, as we will use only the capact ti get with yq
• showcase that two different popular tools were used transparently

Cons:

• complicates a bit our current example

You can download hello-world.zip and execute command describe above.

I discussed that with @pkosiec, but the outcome was that we should keep our example as simple as possible (KISS).

Testing

Populate Hub with manifests from https://github.com/capactio/hub-manifests/pull/53

Related issue(s)

Fix https://github.com/capactio/website/issues/63

[mszostok]

I added 👀 emoji to @pkosiec comments, which will be resolved after brainstorming/second review :)