Deployment Engineer

# Deployment Engineer

> A Claude Code skill for CI/CD pipelines and deployment automation.

## Installation

This skill is part of the [agent-playbook](../../README.md) collection.

## Usage

```
You: Set up CI/CD
You: Create deployment pipeline
You: Configure GitHub Actions
```

## Deployment Strategies

| Strategy | Description |
|----------|-------------|
| **Blue-Green** | Zero downtime, instant rollback |
| **Rolling** | Gradual replacement |
| **Canary** | Test with small traffic first |

## Scripts

Generate deployment config:
```bash
python scripts/generate_deploy.py <environment>
```

Validate deployment:
```bash
python scripts/validate_deploy.py
```

## Resources

- [GitHub Actions Docs](https://docs.github.com/en/actions)
- [CI/CD Best Practices](https://www.atlassian.com/continuous-delivery/principles/continuous-integration-vs-delivery-vs-deployment)


# Kubernetes Deployment Skeleton

```yaml
apiVersion: apps/v1
kind: Deployment
metadata:
  name: app
spec:
  replicas: 2
  selector:
    matchLabels:
      app: app
  template:
    metadata:
      labels:
        app: app
    spec:
      containers:
        - name: app
          image: example/app:latest
          ports:
            - containerPort: 8080
```


# Monitoring Checklist

## Metrics
- Request rate
- Error rate
- Latency (p50/p95/p99)

## Logs
- Structured logs with request IDs
- Include error context and stack traces

## Alerts
- Define SLO-based alerts
- Avoid noisy, low-signal alerts


# CI/CD Pipeline Patterns

## Recommended Stages
- lint
- test
- build
- security
- deploy

## Notes
- Keep pipelines fast and deterministic
- Fail fast on lint and unit tests


#!/usr/bin/env python3
# Template generator for deployment plan.

from pathlib import Path
import argparse
import textwrap


def write_output(path: Path, content: str, force: bool) -> bool:
    if path.exists() and not force:
        print(f"{path} already exists (use --force to overwrite)")
        return False
    path.parent.mkdir(parents=True, exist_ok=True)
    path.write_text(content, encoding="utf-8")
    return True


def main() -> int:
    parser = argparse.ArgumentParser(description="Generate a deployment plan.")
    parser.add_argument("--output", default="deploy-plan.md", help="Output file path")
    parser.add_argument("--name", default="example", help="Service or app name")
    parser.add_argument("--env", default="production", help="Target environment")
    parser.add_argument("--owner", default="team", help="Owning team")
    parser.add_argument("--force", action="store_true", help="Overwrite existing file")
    args = parser.parse_args()

    content = textwrap.dedent(
        f"""\
        # Deployment Plan

        ## Overview
        - Service: {args.name}
        - Environment: {args.env}
        - Owner: {args.owner}

        ## Preconditions
        - Release approved
        - Change window confirmed
        - Backups verified

        ## Steps
        1. Build and publish artifacts
        2. Deploy to staging and run smoke tests
        3. Run migrations (if needed)
        4. Deploy to {args.env}
        5. Verify health checks and dashboards

        ## Verification
        - Health endpoint returns 200
        - Key metrics within baseline
        - Error budget stable

        ## Rollback
        - Revert to last known good release
        - Disable feature flags
        - Communicate rollback status

        ## Observability
        - Dashboard links
        - Alert channels
        """
    ).strip() + "\n"

    output = Path(args.output)
    if not write_output(output, content, args.force):
        return 1
    print(f"Wrote {output}")
    return 0


if __name__ == "__main__":
    raise SystemExit(main())


#!/usr/bin/env python3
# Template validator for deployment plan.

from pathlib import Path
import argparse

DEFAULT_REQUIRED = [
    "## Overview",
    "## Preconditions",
    "## Steps",
    "## Verification",
    "## Rollback",
    "## Observability",
]


def