← Back to Plugins
Tools

Render

jugs-eth By jugs-eth 👁 29 views ▲ 0 votes

Render CLI plugin for OpenClaw

GitHub

Configuration Example

{
  "id": "srv_123456",
  "name": "my-web-app",
  "type": "web_service", 
  "env": "node",
  "repo": "username/repository",
  "branch": "main",
  "plan": "starter",
  "status": "live",
  "url": "https://my-web-app.onrender.com"
}

README

# Render CLI

A comprehensive TypeScript CLI tool for managing Render.com services via their REST API.

## Features

### Service Management
✅ **List Services** - View all services with optional filtering by type and pagination  
✅ **Service Details** - Get comprehensive information about specific services  
✅ **Create Services** - Deploy new web services, static sites, background workers, and cron jobs  
✅ **Update Services** - Modify service configuration including name, branch, and plan  
✅ **Delete Services** - Permanently remove services  
✅ **Suspend/Resume** - Temporarily stop services without deletion  

### Deployment Control  
✅ **List Deployments** - View deployment history with pagination  
✅ **Trigger Deployments** - Manually initiate new deployments  
✅ **Deployment Details** - Get detailed status and information for specific deployments  

### Environment Variables
✅ **List Variables** - View all environment variables for a service  
✅ **Add/Update Variables** - Set individual environment variables  
✅ **Remove Variables** - Delete specific environment variables  
✅ **Bulk Import** - Import multiple variables from .env files  

### Custom Domains
✅ **List Domains** - View all custom domains for a service  
✅ **Add Domains** - Configure custom domains for your services  
✅ **Remove Domains** - Delete custom domain configurations  
✅ **Verify Domains** - Verify domain ownership and DNS configuration  

### PostgreSQL Databases
✅ **List Databases** - View all PostgreSQL instances  
✅ **Database Details** - Get connection info and configuration details  
✅ **Create Databases** - Provision new PostgreSQL databases  
✅ **Delete Databases** - Remove database instances  

### Logging & Monitoring
✅ **Service Logs** - Retrieve service logs with optional tail functionality  

### Scaling & Performance
✅ **Manual Scaling** - Set specific instance counts for services  
✅ **Autoscaling** - Configure automatic scaling with min/max bounds  

### Account & Infrastructure
✅ **Owner Information** - Get current account and user details  
✅ **Available Regions** - List all deployment regions  
✅ **Service Plans** - Reference guide for available plans and pricing  

## Supported Service Types

- **Web Services** - Full-stack applications with HTTP endpoints
- **Static Sites** - Frontend applications served from CDN
- **Private Services** - Internal services without public endpoints  
- **Background Workers** - Long-running background processes
- **Cron Jobs** - Scheduled tasks and periodic jobs

## Supported Environments

- **Docker** - Container-based deployments
- **Node.js** - JavaScript/TypeScript applications
- **Python** - Python applications with automatic environment detection
- **Go** - Go applications with native compilation
- **Rust** - Rust applications with cargo support

## Service Plans

### Web Services & Workers
- **Free** - 750 hours/month, shared resources
- **Starter** - $7/month, 0.5 CPU, 512MB RAM
- **Standard** - $25/month, 1 CPU, 2GB RAM  
- **Pro** - $85/month, 2 CPU, 4GB RAM

### PostgreSQL Databases
- **Free** - 1GB storage, shared resources
- **Starter** - $7/month, 10GB storage
- **Standard** - $20/month, 100GB storage
- **Pro** - $90/month, 500GB storage

## Deployment Regions

- **Oregon** (US West)
- **Frankfurt** (Europe)  
- **Ohio** (US East)
- **Singapore** (Asia Pacific)

## Output Format

All commands output structured JSON to stdout, making integration with other tools seamless:

```json
{
  "id": "srv_123456",
  "name": "my-web-app",
  "type": "web_service", 
  "env": "node",
  "repo": "username/repository",
  "branch": "main",
  "plan": "starter",
  "status": "live",
  "url": "https://my-web-app.onrender.com"
}
```

## CLI Design Principles

- **JSON Output** - All responses in machine-readable JSON format
- **Error Handling** - Proper exit codes and stderr for errors
- **Consistent Interface** - Predictable command structure and arguments
- **Comprehensive Coverage** - Support for all major Render API endpoints
- **Secure Authentication** - Environment variable based API key management

## Use Cases

- **Automated Deployments** - Integrate with CI/CD pipelines
- **Infrastructure as Code** - Script service provisioning and configuration
- **Monitoring & Alerting** - Check service status and deployment progress
- **Multi-Environment Management** - Manage development, staging, and production services
- **Bulk Operations** - Efficiently manage multiple services and configurations

## Dependencies

- **axios** - HTTP client for API requests
- **dotenv** - Environment variable management
- **tsx** - TypeScript execution runtime
- **TypeScript** - Type-safe JavaScript development

## Compatibility

- **Node.js** 18.0.0 or higher
- **TypeScript** 5.3.3 or higher  
- **Linux, macOS, Windows** - Cross-platform compatibility
tools

Comments

Sign in to leave a comment

Loading comments...