Agent Types

Trailer.dev supports different types of agents for managing container resources. This document describes the available agent types and their capabilities.

Overview

Agents are responsible for managing container resources in different environments. Each agent type provides specific functionality for its target environment.

Available Agent Types

Docker Agent

The Docker agent manages Docker containers and resources:

Features

• Docker integration
• Container lifecycle management
• Network configuration
• Volume management
• Image management

Resource Management

• Containers
  • Create/delete containers
  • Start/stop containers
  • Resource limits
  • Health checks
• Networks
  • Network creation
  • Container networking
  • Network isolation
• Volumes
  • Volume management
  • Data persistence
  • Volume mounting
• Images
  • Image pulling
  • Image building
  • Image cleanup

Configuration

agent:
  type: docker
  docker:
    socket: /var/run/docker.sock
    api_version: 1.41
    network_mode: bridge

Kubernetes Agent

The Kubernetes agent manages Kubernetes resources:

Features

• Kubernetes integration
• Pod lifecycle management
• Service management
• ConfigMap/Secret handling
• Persistent volume management

Resource Management

• Pods
  • Pod creation/deletion
  • Resource requests/limits
  • Health monitoring
• Services
  • Service creation
  • Load balancing
  • Service discovery
• ConfigMaps/Secrets
  • Configuration management
  • Secret handling
  • Environment variables
• Persistent Volumes
  • Volume provisioning
  • Storage management
  • Data persistence

Configuration

agent:
  type: kubernetes
  kubernetes:
    config: ~/.kube/config
    context: default
    namespace: default

Configuration Options

Common Options

agent:
  type: docker  # or kubernetes
  log_level: info
  metrics_enabled: true
  health_check_interval: 30s

Type-Specific Options

# Docker options
agent:
  docker:
    socket: /var/run/docker.sock
    api_version: 1.41
    network_mode: bridge

# Kubernetes options
agent:
  kubernetes:
    config: ~/.kube/config
    context: default
    namespace: default