kamal-coder

This skill guides deploying Rails applications with Kamal 2. Use when configuring deploy.yml, setting up kamal-proxy, managing secrets, accessories, or preparing servers for container deployment.

Zur Installation springen

Repository: majesticlabs-dev/majestic-marketplace
Letzte Quellaktivität: 28. März 2026 um 03:24
Erkannte Sprache von SKILL.md: Englisch
Sterne: 47
Forks: 11

Installationsoptionen

Standardmäßig ist der Prompt ausgewählt, der zuerst die Quelle prüft. Sie können zu einem direkten Befehl wechseln oder eine lokale Kopie herunterladen.

Mit Codex oder Claude installieren Kopieren Sie diesen Prompt, fügen Sie ihn in Codex, Claude oder einen anderen Assistant ein und lassen Sie die Skill-Seite prüfen und installieren.

Ein direkter Befehl überspringt den Prüf-Prompt. Prüfen Sie die Quelle, bevor Sie ihn ausführen.

npx skills add https://github.com/majesticlabs-dev/majestic-marketplace --skill kamal-coder

Der Befehl bleibt in einer Zeile. Scrollen Sie horizontal, um ihn vor dem Kopieren vollständig zu prüfen.

Sie bevorzugen eine lokale Kopie? Laden Sie die Dateien herunter, die SkillsMP derzeit vorliegen.

Quelldateien prüfen

Lesen Sie SKILL.md und alle von SkillsMP angezeigten Begleitdateien, bevor Sie sich für eine Installation entscheiden.

Datei-Explorer

3 Dateien

SKILL.md

Quellanweisungen · Schreibgeschützte Vorschau

Zurück zur Suche Zurück zur Installation

frontend-design

Create distinctive, production-grade frontend interfaces with high design quality. Use when building web components, pages, or applications. Includes framework-specific guidance for Tailwind, React, Vue, and Rails/Hotwire ecosystems.

2026-05-13

skill-structure

Skill file structure, naming conventions, directory layout, frontmatter requirements, and invocation control. Use when creating skill files or slash commands to ensure correct format and validation.

2026-05-13

devils-advocate

Forces adversarial reasoning before committing to decisions. Triggers on architectural choices, approach selection, and planning phases to prevent premature commitment bias.

2026-05-08

Alle aus diesem Repository ansehen

service: myapp
image: myapp

servers:
  web:
    - 203.0.113.10
  job:
    hosts:
      - 203.0.113.10
    cmd: bin/jobs start

proxy:
  ssl: true
  host: myapp.com

registry:
  username: username
  password:
    - KAMAL_REGISTRY_PASSWORD

env:
  clear:
    RAILS_ENV: production
    SOLID_QUEUE_IN_PUMA: false
  secret:
    - RAILS_MASTER_KEY

registry:
  server: localhost:5555
  username: ignored
  password:
    - KAMAL_REGISTRY_PASSWORD

accessories:
  registry:
    image: registry:2
    host: 203.0.113.10
    port: "5555:5000"
    volumes:
      - registry_data:/var/lib/registry

accessories:
  db:
    image: postgres:16
    host: 203.0.113.10
    port: 5432
    env:
      clear:
        POSTGRES_DB: myapp_production
      secret:
        - POSTGRES_PASSWORD
    directories:
      - data:/var/lib/postgresql/data
    options:
      shm-size: 256m

  redis:
    image: redis:7-alpine
    host: 203.0.113.10
    port: 6379
    directories:
      - data:/data
    cmd: redis-server --appendonly yes

servers:
  web:
    hosts:
      - 203.0.113.10
    volumes:
      - myapp_storage:/rails/storage
    labels:
      docker-volume-backup.stop-during-backup: "true"
  job:
    hosts:
      - 203.0.113.10
    cmd: bin/jobs start
    volumes:
      - myapp_storage:/rails/storage

proxy:
  ssl: true
  host: myapp.com

proxy:
  ssl: true
  host: myapp.com
  app_port: 3000

proxy:
  ssl: true
  hosts:
    - myapp.com
    - www.myapp.com

proxy:
  ssl: true
  host: myapp.com
  healthcheck:
    path: /up
    interval: 3
    timeout: 3

proxy:
  ssl: true
  host: myapp.com
  response_timeout: 30

KAMAL_REGISTRY_PASSWORD=$(op read "op://Infrastructure/DockerHub/password")
RAILS_MASTER_KEY=$(op read "op://MyApp/production/master_key")
DATABASE_URL=$(op read "op://MyApp/production/database_url")

KAMAL_REGISTRY_PASSWORD=$DOCKERHUB_TOKEN
RAILS_MASTER_KEY=$RAILS_MASTER_KEY
DATABASE_URL=$DATABASE_URL

# config/deploy.yml — base config
service: myapp

# config/deploy.staging.yml — overrides
service: myapp-staging
servers:
  web:
    - 203.0.113.20
proxy:
  host: staging.myapp.com

# .kamal/secrets.staging
RAILS_MASTER_KEY=$(op read "op://MyApp/staging/master_key")

# One-time: installs kamal-proxy, pushes image, deploys
kamal setup

# Subsequent: builds, pushes, rolling restart
kamal deploy

kamal deploy                    # Deploy latest
kamal deploy --version=abc123   # Deploy specific version
kamal deploy -d staging         # Deploy to staging
kamal redeploy                  # Redeploy without building

kamal app containers            # List available versions
kamal rollback <version>        # Rollback to specific version

kamal app exec --interactive bash              # Shell into container
kamal app logs -f                              # Tail logs
kamal app exec --interactive "bin/rails console"  # Rails console
kamal app exec "bin/rails db:migrate"          # Run migrations

kamal accessory boot all        # Start all accessories
kamal accessory reboot db       # Restart specific accessory
kamal accessory exec db --interactive "psql -U postgres"
kamal accessory logs litestream  # View accessory logs

builder:
  arch: amd64

builder:
  multiarch: true

builder:
  remote:
    arch: amd64
    host: ssh://builder@build-server

builder:
  args:
    RUBY_VERSION: "3.3.0"

# .kamal/hooks/pre-deploy
#!/bin/sh
echo "Running pre-deploy checks..."

# .kamal/hooks/post-deploy
#!/bin/sh
echo "Deploy complete: $(date)"
curl -s https://notify.example.com/deploy

# 1. Ansible: Configure server
ansible-playbook -i hosts.ini playbook.yml

# 2. Kamal: Bootstrap and deploy
kamal setup

Task	Purpose
Install Docker	Container runtime
Configure fail2ban	SSH intrusion prevention
Setup UFW	Firewall (22, 80, 443)
Enable NTP	Time synchronization
Create swap	Memory overflow protection
Harden SSH	Disable password auth, root login
Unattended upgrades	Automatic security patches

accessories:
  litestream:
    image: litestream/litestream:0.3
    host: 203.0.113.10
    cmd: replicate
    volumes:
      - myapp_storage:/rails/storage:ro
    files:
      - config/litestream.yml:/etc/litestream.yml
    env:
      secret:
        - LITESTREAM_ACCESS_KEY_ID
        - LITESTREAM_SECRET_ACCESS_KEY

myapp/
├── config/
│   ├── deploy.yml           # Main Kamal config
│   └── deploy.staging.yml   # Staging overrides
├── .kamal/
│   ├── secrets              # Production secrets (git-ignored)
│   ├── secrets.staging      # Staging secrets (git-ignored)
│   └── hooks/
│       ├── pre-deploy
│       └── post-deploy
├── Dockerfile               # Application container
└── docker-entrypoint.sh     # Entrypoint script

Issue	Cause	Fix
Connection refused	Docker not running	`kamal setup` or check Docker service
Permission denied	SSH key not authorized	Check server's `authorized_keys`
Health check failing	App not starting	Check `kamal app logs`
Registry auth failed	Wrong credentials	Verify `.kamal/secrets`
502 Bad Gateway	Container not healthy	Increase healthcheck timeout
SSL cert not issued	DNS not pointing to server	Verify DNS A record
Asset 404 after deploy	Volume not mounted	Check `volumes:` in deploy.yml

name	kamal-coder
description	This skill guides deploying Rails applications with Kamal 2. Use when configuring deploy.yml, setting up kamal-proxy, managing secrets, accessories, or preparing servers for container deployment.
allowed-tools	Read Write Edit Grep Glob Bash

kamal-coder

Quellinformationen

Installationsoptionen

Quelldateien prüfen

Mehr aus diesem Repository

Mehr aus diesem Repository

Kamal 2 Coder

Configuration: config/deploy.yml

Minimal Setup

Kamal 2 Coder

Configuration: config/deploy.yml

Minimal Setup

Multi-Role Setup (Web + Job Worker)

With Local Registry

With Accessories

Docker Volumes for Persistence

Proxy Configuration (kamal-proxy)

Basic SSL

Custom Port

Multiple Hosts

Health Check

Response Timeout

Secrets: .kamal/secrets

With 1Password CLI

With Environment Variables

Multi-Environment

Common Commands

First Deployment

Regular Operations

Rollback

Debugging

Accessories

Builder Configuration

Native Builds

Multi-Architecture

Remote Builder

Build Arguments

Hooks

Pre-Deploy

Post-Deploy

Provisioning Workflow

Ansible + Kamal Pipeline

What Ansible Should Configure

Litestream Backup Accessory

Directory Structure

Troubleshooting

References