DockSplit Agent

NestJS-based agent application for DockSplit system.

Installation

Global Installation (Recommended)

npm install -g @docker-digital/dockernet-agent

Sau khi cài đặt, bạn có thể chạy dockernet-agent từ bất kỳ đâu:

# Set API key
dockernet-agent --apiKey YOUR_API_KEY

# Show config
dockernet-agent --config

# List profiles
dockernet-agent --profiles

# Run as daemon
dockernet-agent --run

# Stop daemon
dockernet-agent --stop

Local Installation

npm install

Usage

CLI Commands (After Global Installation)

# Set API key
dockernet-agent --apiKey YOUR_API_KEY

# Show config
dockernet-agent --config

# List profiles
dockernet-agent --profiles

# Show version
dockernet-agent --version

# Run as daemon
dockernet-agent --run

# Stop daemon
dockernet-agent --stop

# Restart daemon
dockernet-agent --restart

Local Development Commands

# Set API key
npm run agent -- --apiKey YOUR_API_KEY

# Show config
npm run agent -- --config

# List profiles
npm run agent -- --profiles

# Run as daemon
npm run agent -- --run

Development

# Run in development mode
npm run dev

# Build
npm run build

# Run production build
npm run start:prod

Architecture

The agent is structured following NestJS best practices:

• Services: Core business logic

  • ApiService: HTTP client for backend API
  • ConfigService: Configuration management
  • DockerService: Docker operations
  • EventService: Event polling and processing
  • LogService: Container log streaming
  • MachineService: Machine registration and status
  • ProfileService: Profile management (start/stop)
  • VolumeSyncService: Volume synchronization

• Commands: CLI interface

  • AgentCommand: Main command handler

Features

• Machine registration with server
• Event polling and processing
• Profile start/stop operations
• Container log streaming
• Service status updates
• Volume synchronization
• Private registry authentication