spire-agent

Pull Commands

Download the runtime container images

Interactive Development

Start interactive session for development

docker run -d --name spire-agent-prod \\
  --read-only \\
  --security-opt=no-new-privileges \\
  --user 1000:1000 \\
  clnstrt-images.cleanstart.com/$ORGANIZATION/spire-agent:latest

Run Hello World

Execute a simple Hello World program

docker run -it --name spire-agent-test clnstrt-images.cleanstart.com/$ORGANIZATION/spire-agent:latest-dev

Mount Workspace

Run container with local workspace mounted

docker run --rm -v $(pwd):/app -w /app clnstrt-images.cleanstart.com/$ORGANIZATION/spire-agent:latest-dev python --version

Application Server

Run application with port forwarding

docker run -d --name spire-agent-app \
  -p 8000:8000 \
  -v $(pwd):/app \
  -w /app \
  clnstrt-images.cleanstart.com/$ORGANIZATION/spire-agent:latest

Environment Variables

Configuration options available through environment variables

PATH

System PATH configuration

/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin

Security Best Practices

Recommended security configurations and practices

• Use specific image tags for production (avoid latest)
• Configure resource limits: memory and CPU constraints
• Enable read-only root filesystem when possible
• Run containers with non-root user (--user 1000:1000)
• Use --security-opt=no-new-privileges flag
• Regularly update container images for security patches
• Implement proper network segmentation
• Monitor container metrics for anomalies

Kubernetes Security Context

Recommended security context for Kubernetes deployments

securityContext:
  runAsNonRoot: true
  runAsUser: 1000
  runAsGroup: 1000
  readOnlyRootFilesystem: true
  allowPrivilegeEscalation: false
  capabilities:
    drop: ['ALL']