Skip to content
reaatechREAATECH

@reaatech/agent-runbook-rollback

npm v0.1.0

Generates platform-specific rollback procedures, pre-checks, and verification plans by analyzing deployment configurations. It provides a set of utility functions to output automated scripts and checklists for common cloud environments like Kubernetes, ECS, and Cloud Run.

@reaatech/agent-runbook-rollback

npm version License: MIT CI

Rollback procedure generation for the Agent Runbook Generator. Analyzes deployment configurations and generates step-by-step rollback procedures with pre-checks, commands, and verification steps.

Installation

terminal
npm install @reaatech/agent-runbook-rollback
# or
pnpm add @reaatech/agent-runbook-rollback

Feature Overview

  • Deployment analysis — identifies deployment platform, strategy, replicas, and rollback capabilities
  • Platform-specific commands — generates correct rollback commands for Kubernetes, ECS, Cloud Run, and more
  • Four rollback scenarios — deployment failure, config error, performance degradation, data corruption
  • Pre-check validation — environment state checks before initiating rollback
  • Verification plans — health checks, smoke tests, data validation, and performance checks post-rollback
  • Automated scripts — generates fully automated rollback scripts with error handling

Quick Start

typescript
import { analyzeDeployment, generateRollbackProcedures, generateVerificationSteps } from "@reaatech/agent-runbook-rollback";
 
const deployment = analyzeDeployment("/path/to/repo", analysisContext);
 
const procedures = generateRollbackProcedures(analysisContext, "kubernetes");
// { deploymentFailure: {...}, configurationError: {...}, ... }
 
const verification = generateVerificationSteps(analysisContext, "kubernetes");

API Reference

Deployment Analyzer

FunctionSignature
analyzeDeployment(repoPath: string, context: AnalysisContext) => DeploymentAnalysis
getRollbackCommands(platform: DeploymentPlatform, serviceName: string) => string[]

Rollback Generator

FunctionSignature
generateRollbackProcedures(context: AnalysisContext, platform: DeploymentPlatform) => RollbackScenarios

RollbackScenarios: { deploymentFailure: RollbackProcedure; configurationError: RollbackProcedure; performanceDegradation: RollbackProcedure; dataCorruption: RollbackProcedure }

Verification Generator

FunctionSignature
generateVerificationSteps(context: AnalysisContext, platform: DeploymentPlatform) => VerificationPlan
generateVerificationChecklist(context: AnalysisContext, platform: DeploymentPlatform) => string[]

License

MIT