Skip to content

docs: add Microcks example#289

Merged
mathieu-benoit merged 2 commits intoscore-spec:mainfrom
Abhishek9639:examples/add-microcks
May 7, 2026
Merged

docs: add Microcks example#289
mathieu-benoit merged 2 commits intoscore-spec:mainfrom
Abhishek9639:examples/add-microcks

Conversation

@Abhishek9639
Copy link
Copy Markdown
Contributor

What is the motivation?

Microcks is a CNCF Sandbox project that works great alongside Score, and there was no example entry for it yet in the docs. This PR adds one to help Developers understand how to use Score with Microcks to mock external service dependencies both locally and in Kubernetes.

What does this change do?

Adds a new Microcks entry to the Examples section (/docs/examples/), covering both score-compose and score-k8s tabs. The content is inspired by the blog post Unifying the Inner & Outer Loops with Containers + Microcks + Score and includes:

  • A Score file taken from the score-microcks reference repo
  • A score-compose tab showing the inner loop (local dev with Microcks mocking)
  • A score-k8s tab showing the outer loop (Kubernetes deployment)
  • A Next steps section mentioning the KubeCon EU 2026 talk

What is your testing strategy?

  • Ran yarn run hugo locally - built successfully with 0 errors (165 pages)
  • Ran yarn run dprint check locally - passed with no formatting issues
  • Verified all shortcodes, mermaid diagram, and front matter are correct

Is this related to any issues?

Closes #285

Have you read the Contributing Guidelines?

@Abhishek9639 Abhishek9639 force-pushed the examples/add-microcks branch from 0472aad to 9e3b73c Compare May 5, 2026 14:05
Signed-off-by: Abhishek <abhishekup082@gmail.com>
@Abhishek9639 Abhishek9639 force-pushed the examples/add-microcks branch from 9e3b73c to 2e26b27 Compare May 5, 2026 14:05
@Abhishek9639
Copy link
Copy Markdown
Contributor Author

Hi @mathieu-benoit,
I've opened a PR for this issue.

It adds the Microcks example entry covering both score-compose and score-k8s tabs, following the same format as the existing examples. All local CI checks (hugo build + dprint) passed.

Would love your feedback whenever you get a chance.
Thanks

Copy link
Copy Markdown
Contributor

@mathieu-benoit mathieu-benoit left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks, @Abhishek9639, much appreciated!

Couple of updates to do please, thanks!

Comment thread content/en/docs/examples/included/microcks-score-k8s.md Outdated
Comment thread content/en/docs/examples/included/microcks-score-compose.md Outdated
Comment thread content/en/docs/examples/included/microcks-score-compose.md Outdated
Comment thread content/en/docs/examples/included/microcks-score-k8s.md Outdated
Comment thread content/en/docs/examples/included/microcks-score-compose.md Outdated
Comment thread content/en/docs/examples/included/microcks-score-k8s.md Outdated
Comment thread content/en/docs/examples/included/microcks-score-k8s.md Outdated
Comment thread content/en/docs/examples/included/microcks-score-k8s.md
Signed-off-by: Abhishek <abhishekup082@gmail.com>
@Abhishek9639
Copy link
Copy Markdown
Contributor Author

Hey @mathieu-benoit,
Thanks for the review. I've addressed all your feedback.

  • Added name to the service outputs in both the provisioners and resources tables.
  • Updated the description to reference both score-compose and score-k8s.
  • Moved the K8s cluster and Microcks prerequisites to the beginning of the generate section.
  • Added a note about the microcks CLI needing to be installed locally, with a link to the provisioner file.

Let me know if anything else needs tweaking.

Copy link
Copy Markdown
Contributor

@mathieu-benoit mathieu-benoit left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM, good job!

@mathieu-benoit mathieu-benoit merged commit 0f0c1cc into score-spec:main May 7, 2026
6 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Examples - Add a new Microcks entry

2 participants