use-ryvn

Manage Ryvn infrastructure and deployments via the ryvn CLI.

Updated Mar 24, 2026
One-click install
npx skills add https://github.com/ryvn-technologies/skills --skill use-ryvn
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: use-ryvn
Source: https://github.com/ryvn-technologies/skills/tree/main/plugins/ryvn/skills/use-ryvn
Command: npx skills add https://github.com/ryvn-technologies/skills --skill use-ryvn

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

It provides a guided, CLI-first workflow for managing Ryvn infrastructure so operators and engineers can provision environments, deploy services, configure blueprints, manage release channels and promotion pipelines, troubleshoot failures, and approve or monitor tasks without guessing commands or resource relationships.

Core Features & Use Cases

  • Authentication & Setup: CLI installation and profile/service-account management to authenticate and target organizations and environments.
  • Provisioning & Deployments: Create, provision, update, and delete environments and service installations; perform full config replacements, strategic patches, and force deploys or rollbacks.
  • Configuration & Blueprints: Manage services, blueprint creation and inputs, blueprint installations, exclusions, and unlinking behavior.
  • Release & Promotion Management: Create and manage release channels and promotion pipelines to stage releases across environments.
  • Observability & Recovery: Stream and filter logs, inspect K8s manifests, triage failures, manage tasks (approve/cancel/retry), and recover via redeploys and retries.
  • Use Case: Provision a GCP-backed staging environment, deploy a service installation from a blueprint, verify logs for health, and promote a release to production with task approval.

Quick Start

Provision the production environment and deploy the my-api installation using the ryvn CLI, then report the deployment status.

Frequently Asked Questions about use-ryvn

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I manage Ryvn infrastructure and deployments from the command line?

You can manage Ryvn infrastructure and deployments from the command line by using the ryvn CLI to provision environments, deploy services, configure blueprints, and monitor logs. It requires an installed and authenticated CLI profile to target your organization.

What is the process to deploy a service installation using a Ryvn blueprint?

Deploying a service installation using a Ryvn blueprint involves creating the blueprint, defining its inputs, and provisioning the target environment. You then execute a deployment command via the ryvn CLI and verify the deployment status using JSON output.

Can I stream and filter infrastructure logs for troubleshooting with the ryvn CLI?

Yes, you can stream and filter infrastructure logs for troubleshooting with the ryvn CLI. The CLI provides observability commands to inspect K8s manifests, triage deployment failures, and manage task retries or cancellations during recovery.

How do release channels and promotion pipelines stage deployments across Ryvn environments?

Release channels and promotion pipelines stage deployments across Ryvn environments by routing releases sequentially from staging to production. You create and manage these pipelines via the CLI to control promotion workflows and ensure stable rollouts.

Do I need an authenticated ryvn CLI to approve tasks and manage rollbacks?

Yes, you need an authenticated ryvn CLI to approve tasks and manage rollbacks. The CLI handles task approval workflows, force deploys, and rollback operations, using JSON output for reliable parsing of deployment states and recovery actions.

What are the limitations when replacing configurations or unlinking Ryvn blueprints?

When replacing configurations or unlinking Ryvn blueprints, limitations include potential service disruptions if exclusions are not properly managed. The CLI supports full config replacements, strategic patches, and controlled unlinking behavior to mitigate risk.