# Docker

## Image

```
ppmsupport/purplemet-cli:latest
ppmsupport/purplemet-cli:v1.0.0
```

Alpine-based, ~15MB. Contains only the `purplemet-cli` binary and CA certificates.

## Usage

```bash
# Basic analysis
docker run --rm \
  -e PURPLEMET_API_TOKEN=<token> \
  ppmsupport/purplemet-cli analyze https://your-app.com

# JSON output with severity gate
docker run --rm \
  -e PURPLEMET_API_TOKEN=<token> \
  ppmsupport/purplemet-cli analyze https://your-app.com --json --fail-on-severity high

# Auth check
docker run --rm \
  -e PURPLEMET_API_TOKEN=<token> \
  ppmsupport/purplemet-cli auth check

# List sites
docker run --rm \
  -e PURPLEMET_API_TOKEN=<token> \
  ppmsupport/purplemet-cli sites list --json

# Version
docker run --rm ppmsupport/purplemet-cli version
```

## CI/CD Usage

### GitLab CI

```yaml
purplemet-analyze:
  image: ppmsupport/purplemet-cli:latest
  script:
    - purplemet-cli analyze "$TARGET_URL" --json --fail-on-severity high
```

### GitHub Actions

```yaml
- name: Purplemet Analysis
  run: |
    docker run --rm \
      -e PURPLEMET_API_TOKEN=${{ secrets.PURPLEMET_API_TOKEN }} \
      ppmsupport/purplemet-cli analyze https://app.com --json --fail-on-severity high
```

### Bitbucket Pipelines

```yaml
- step:
    image: ppmsupport/purplemet-cli:latest
    script:
      - purplemet-cli analyze "$TARGET_URL" --json
```

## Building Locally

```bash
make docker                    # Build image
docker images ppmsupport/purplemet-cli    # Check size
```