find-and-deploy-codebundle

Find and Deploy a CodeBundle from the Registry

Search the RunWhen CodeBundle Registry for production-ready automation before writing a custom script. The registry contains hundreds of pre-built, tested codebundles for Kubernetes, cloud providers, databases, and more.

When to use this skill

• The user asks to "add monitoring for X" or "create a health check for Y"
• The user describes a task that sounds like common operational automation
• Before starting a custom build-runwhen-task workflow — always check the registry first

Key concept: two different deployment paths

Path	Tool	When to use
Registry codebundle	deploy_registry_codebundle	Pre-built automation from the registry. Points to the codebundle's own git repo + robot file. No inline script.
Custom script	commit_slx	Hand-written bash/python script. Uses the Tool Builder codebundle with an inline base64-encoded script.

These are not interchangeable — the YAML structure is fundamentally different. Registry codebundles use the codebundle's own runbook.robot / sli.robot files from its codecollection git repo.

Workflow

1. Search the registry

search_registry(search="kubernetes pod health", platform="Kubernetes")

Search tips:

• Use natural language: "postgres connection pool", "gcp bucket permissions"
• Filter by platform when you know it: "Kubernetes", "GCP", "AWS"
• Filter by tags for specifics: "GKE,KUBERNETES" or "EKS"
• Review tasks and slis in results to confirm the codebundle covers what the user needs

2. Get full codebundle details

If a result looks promising, fetch the full details:

get_registry_codebundle(
    collection_slug="rw-cli-codecollection",
    codebundle_slug="k8s-namespace-healthcheck"
)

Key fields to examine:

• tasks / slis: what the codebundle actually does
• user_variables: the config vars you need to provide (NAMESPACE, CONTEXT, etc.)
• support_tags: which platforms and services it covers
• access_level: "read-only" vs "read-write"
• runbook_path / sli_path: confirms whether runbook and/or SLI exist
• codecollection.git_url: the repo URL needed for deployment
• runbook_source_url: link to source code on GitHub