Skip to content

Add KubeStellar Console guided install for Microcks#125

Merged
yada merged 3 commits intomicrocks:mainfrom
clubanderson:add-kubestellar-console-install
Mar 17, 2026
Merged

Add KubeStellar Console guided install for Microcks#125
yada merged 3 commits intomicrocks:mainfrom
clubanderson:add-kubestellar-console-install

Conversation

@clubanderson
Copy link
Copy Markdown
Contributor

Summary

Adds a guide for installing Microcks 1.13.2 via KubeStellar Console's guided mission system, following the existing structure in install/.

What's included

  • install/kubestellar-console/README.md — step-by-step guide covering:
    • Interactive guided mission (pre-flight checks, validation after each step, troubleshooting on failure)
    • Standalone Helm commands for direct copy-paste
    • Troubleshooting table (MongoDB PVC issues, Keycloak crashes, port-forward failures)
    • Post-install monitoring card reference
    • Link to open-source mission definition for community edits

How the mission works

The mission wraps the standard helm install microcks microcks/microcks workflow with:

  1. Pre-flight — checks Helm is installed, cluster is reachable
  2. helm repo add microcks https://microcks.io/helm && helm repo update
  3. helm install microcks microcks/microcks --namespace microcks --create-namespace --version 1.13.2
  4. Validation — queries kubectl get pods -n microcks to verify all pods are Running
  5. Port-forward setup for local UI access
  6. Rollback — helm uninstall microcks -n microcks

Ref: microcks/microcks#1997

Adds a step-by-step guide for installing Microcks 1.13.2 via
KubeStellar Console's guided mission system. The mission automates
the standard Helm-based installation with pre-flight validation,
cluster state checks after each step, and rollback commands.

Includes:
- Interactive mission walkthrough (with cluster validation)
- Standalone commands for copy-paste usage
- Troubleshooting table for common issues
- Monitoring card reference for post-install observability
- Link to the open-source mission definition for community edits

Ref: microcks/microcks#1997
Signed-off-by: Andrew Anderson <andy@clubanderson.com>
Signed-off-by: Andrew Anderson <andy@clubanderson.com>
Signed-off-by: Andrew Anderson <andy@clubanderson.com>
@github-actions
Copy link
Copy Markdown

👋 @clubanderson

Welcome to the Microcks community! 💖

Thanks and congrats 🎉 for opening your first pull request here! Be sure to follow the pull request template or please update it accordingly.

Hope you have a great time there!

🌟 ~~~~~~~~~ 🌟

📢 If you like Microcks, please ⭐ star ⭐ our repo to support it!

🙏 It really helps the project to gain momentum and credibility. It's a small contribution back to the project with a big impact.

@yada yada added documentation Improvements or additions to documentation enhancement New feature or request labels Mar 17, 2026
Copy link
Copy Markdown
Member

@yada yada left a comment

Choose a reason for hiding this comment

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

LGTM with thanks

@yada yada merged commit b9a1ef3 into microcks:main Mar 17, 2026
1 check passed
@github-actions
Copy link
Copy Markdown

🎉 @clubanderson

You are now a Microcks community contributor! 💖

Thanks and congrats 🚀 on merging your first pull request! We are delighted and very proud of you! 👏

📢 If you're using Microcks in your organization, please add your company name to this list. 🙏 It really helps the project to gain momentum and credibility. It's a small contribution back to the project with a big impact.

If you need to know why and how to add yourself to the list, please read the blog post "Join the Microcks Adopters list and Empower the vibrant open source Community 🙌"

Kudos and please keep going, we need you 🙌

🌟 ~~~~~~~~~ 🌟

📢 If you like Microcks, please ⭐ star ⭐ our repo to support it!

🙏 It really helps the project to gain momentum and credibility. It's a small contribution back to the project with a big impact.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation enhancement New feature or request

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants