Skip to content

chore: Add block producer migration skills#27

Merged
gonzalezzfelipe merged 4 commits intomainfrom
chore/block-producer-migration-skills
Apr 22, 2026
Merged

chore: Add block producer migration skills#27
gonzalezzfelipe merged 4 commits intomainfrom
chore/block-producer-migration-skills

Conversation

@gonzalezzfelipe
Copy link
Copy Markdown
Contributor

@gonzalezzfelipe gonzalezzfelipe commented Apr 20, 2026

Summary by CodeRabbit

  • Documentation
    • Added comprehensive operational guides: relay-first setup, storage/prereqs, extension discovery, node metrics access, port-forward dashboard access, debug-first block-producer upgrade, verification and troubleshooting workflows, and vault/runtime material guidance.
  • New Features
    • Dashboard: added a Producer info card showing forged/adopted counts for block producers.

@coderabbitai
Copy link
Copy Markdown

coderabbitai Bot commented Apr 20, 2026

Caution

Review failed

The pull request is closed.

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: 9223c250-225c-496a-bee0-46a700503f1f

📥 Commits

Reviewing files that changed from the base of the PR and between 91d73da and 1f89587.

📒 Files selected for processing (8)
  • extensions/apex-fusion/README.md
  • extensions/apex-fusion/templates/configmap-metrics.yaml
  • extensions/cardano-node/templates/configmap-metrics.yaml
  • frontends/dashboard/src/routes/$namespace/$name/index.tsx
  • skills/README.md
  • skills/cardano-block-producer-troubleshooting.md
  • skills/cardano-block-producer-upgrade.md
  • skills/cardano-block-producer-verification.md

📝 Walkthrough

Walkthrough

Added a suite of operational documentation under skills/ for Metis Cardano cluster operations, plus small metrics template fixes and a dashboard UI card to surface local forged/adopted metrics.

Changes

Cohort / File(s) Summary
Skills docs (new)
skills/README.md, skills/kubernetes-extension-discovery.md, skills/kubernetes-storage-and-prereqs.md, skills/cardano-relay-setup.md, skills/cardano-block-producer-upgrade.md, skills/cardano-block-producer-verification.md, skills/cardano-block-producer-troubleshooting.md, skills/cardano-node-metrics-access.md, skills/supernode-dashboard-port-forward.md
Added comprehensive operational runbooks: extension discovery, storage/prereqs, relay setup, debug-first block-producer upgrade flow, verification checklists, troubleshooting, node metrics access, and dashboard port-forwarding.
Extensions — docs & vault workflow
extensions/apex-fusion/README.md
Clarified Vault-access workflow (kubectl port-forward option), use of absolute key paths, and which keys/certs belong in Vault.
Extensions — metrics script templates
extensions/apex-fusion/templates/configmap-metrics.yaml, extensions/cardano-node/templates/configmap-metrics.yaml
Defaulted leader_count, adopted_count, forged_count to 0 in block-producer branch; added extra network variants mapping to --mainnet.
Frontend — dashboard UI
frontends/dashboard/src/routes/$namespace/$name/index.tsx
Added forgedAdoptedLocal metric description and an InfoCard showing forgedCount/adoptedCount in the Producer metrics section.

Sequence Diagram(s)

(omitted — changes are documentation, small template defaults, and a UI metric card; no new multi-component control-flow to visualize)

Estimated code review effort

🎯 3 (Moderate) | ⏱️ ~20 minutes

Possibly related PRs

Suggested reviewers

  • scarmuega
  • mduthey

Poem

🐰🌿 I hopped through docs, keys, and charts tonight,
Wrote checklists, fixes, and a port-forward light,
Relay to producer, metrics in view,
A rabbit's hop to help your nodes renew 🥕✨

🚥 Pre-merge checks | ✅ 3
✅ Passed checks (3 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed The PR title accurately summarizes the main change: adding documentation for block producer migration skills, which is the primary content of this changeset.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.

✨ Finishing Touches
📝 Generate docstrings
  • Create stacked PR
  • Commit on current branch
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch chore/block-producer-migration-skills

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

Copy link
Copy Markdown

@coderabbitai coderabbitai Bot left a comment

Choose a reason for hiding this comment

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

Actionable comments posted: 1

🧹 Nitpick comments (1)
skills/supernode-dashboard-port-forward.md (1)

22-24: Avoid local port collision between dashboard and Grafana examples.

Both examples use local port 3000, which makes side-by-side debugging awkward. Use a different local port for Grafana.

Proposed doc fix
 ### Grafana
 
 ```bash
-kubectl -n control-plane port-forward service/grafana 3000:3000
+kubectl -n control-plane port-forward service/grafana 3001:3000
</details>


Also applies to: 36-38

<details>
<summary>🤖 Prompt for AI Agents</summary>

Verify each finding against the current code and only fix it if needed.

In @skills/supernode-dashboard-port-forward.md around lines 22 - 24, The two
port-forward examples conflict because both use local port 3000; update the
Grafana command (the line containing "kubectl -n control-plane port-forward
service/grafana 3000:3000") to use a different local port such as 3001 by
changing it to "kubectl -n control-plane port-forward service/grafana 3001:3000"
so it doesn’t collide with the supernode-dashboard command ("kubectl -n
control-plane port-forward service/supernode-dashboard 3000:3000"); apply the
same change to the second Grafana occurrence in the file.


</details>

</blockquote></details>

</blockquote></details>

<details>
<summary>🤖 Prompt for all review comments with AI agents</summary>

Verify each finding against the current code and only fix it if needed.

Inline comments:
In @skills/supernode-dashboard-port-forward.md:

  • Around line 26-30: The section heading/text says "forward the pod directly"
    but the example command uses a deployment ("kubectl -n control-plane
    port-forward deployment/supernode-dashboard 3000:3000"); update the doc so they
    match by either changing the text to "forward the deployment directly" or
    changing the command to target a pod (e.g., "kubectl -n control-plane
    port-forward pod/ 3000:3000"); ensure the phrase and the command
    reference the same object type (pod vs deployment) and keep the example name
    "supernode-dashboard" consistent with the rest of the doc.

Nitpick comments:
In @skills/supernode-dashboard-port-forward.md:

  • Around line 22-24: The two port-forward examples conflict because both use
    local port 3000; update the Grafana command (the line containing "kubectl -n
    control-plane port-forward service/grafana 3000:3000") to use a different local
    port such as 3001 by changing it to "kubectl -n control-plane port-forward
    service/grafana 3001:3000" so it doesn’t collide with the supernode-dashboard
    command ("kubectl -n control-plane port-forward service/supernode-dashboard
    3000:3000"); apply the same change to the second Grafana occurrence in the file.

</details>

<details>
<summary>🪄 Autofix (Beta)</summary>

Fix all unresolved CodeRabbit comments on this PR:

- [ ] <!-- {"checkboxId": "4b0d0e0a-96d7-4f10-b296-3a18ea78f0b9"} --> Push a commit to this branch (recommended)
- [ ] <!-- {"checkboxId": "ff5b1114-7d8c-49e6-8ac1-43f82af23a33"} --> Create a new PR with the fixes

</details>

---

<details>
<summary>ℹ️ Review info</summary>

<details>
<summary>⚙️ Run configuration</summary>

**Configuration used**: defaults

**Review profile**: CHILL

**Plan**: Pro

**Run ID**: `1f282cfe-3f2b-4399-93f7-08e5185c1350`

</details>

<details>
<summary>📥 Commits</summary>

Reviewing files that changed from the base of the PR and between 671862e942b023cfa8f1a5c9ba118492b31278c9 and 91d73dac7d3d97cc9bacc33da37f519e4539ab0e.

</details>

<details>
<summary>📒 Files selected for processing (8)</summary>

* `skills/README.md`
* `skills/cardano-block-producer-upgrade.md`
* `skills/cardano-block-producer-verification.md`
* `skills/cardano-node-metrics-access.md`
* `skills/cardano-relay-setup.md`
* `skills/kubernetes-extension-discovery.md`
* `skills/kubernetes-storage-and-prereqs.md`
* `skills/supernode-dashboard-port-forward.md`

</details>

</details>

<!-- This is an auto-generated comment by CodeRabbit for review status -->

Comment on lines +26 to +30
If needed, you can also forward the pod directly:

```bash
kubectl -n control-plane port-forward deployment/supernode-dashboard 3000:3000
```
Copy link
Copy Markdown

Choose a reason for hiding this comment

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

⚠️ Potential issue | 🟡 Minor

Fix object-type mismatch in the “pod directly” section.

Line 26 says “forward the pod directly,” but Line 29 forwards a deployment. Please make wording and command match.

Proposed doc fix
-If needed, you can also forward the pod directly:
+If needed, you can also forward the deployment directly:
 
 ```bash
 kubectl -n control-plane port-forward deployment/supernode-dashboard 3000:3000
</details>

<details>
<summary>🤖 Prompt for AI Agents</summary>

Verify each finding against the current code and only fix it if needed.

In @skills/supernode-dashboard-port-forward.md around lines 26 - 30, The section
heading/text says "forward the pod directly" but the example command uses a
deployment ("kubectl -n control-plane port-forward
deployment/supernode-dashboard 3000:3000"); update the doc so they match by
either changing the text to "forward the deployment directly" or changing the
command to target a pod (e.g., "kubectl -n control-plane port-forward
pod/ 3000:3000"); ensure the phrase and the command reference the same
object type (pod vs deployment) and keep the example name "supernode-dashboard"
consistent with the rest of the doc.


</details>

<!-- fingerprinting:phantom:triton:hawk:04de8889-5853-452b-a113-b60af168bf5c -->

<!-- This is an auto-generated comment by CodeRabbit -->

@gonzalezzfelipe gonzalezzfelipe merged commit 29f4b08 into main Apr 22, 2026
14 of 15 checks passed
@gonzalezzfelipe gonzalezzfelipe deleted the chore/block-producer-migration-skills branch April 22, 2026 14:40
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.

1 participant