Docker Management

AIVory Architect includes a visual Docker Compose designer for creating, editing, and managing containerized applications directly from your IDE.

Requirements

Before using Docker features, ensure you have the following installed:

docker --version
docker compose version

Visual Compose Designer

Design Docker Compose stacks visually by dragging services onto a canvas and connecting them.

Adding Services

1. Open the Docker tab in Architect
2. Drag a service from the palette onto the canvas
3. Click the service to edit properties:
   • Image and tag
   • Port mappings
   • Environment variables
   • Volume mounts
   • Resource limits
   • Health checks

Connection Types

Connect services to define relationships:

Generating docker-compose.yml

1. Design your stack visually
2. Click Generate Compose
3. Review the generated YAML
4. File is saved to your project directory

Pre-built Templates

Start quickly with 8 ready-to-use templates:

To use a template:

1. Open the Docker tab
2. Click Templates
3. Select a template
4. Customize as needed

Container Management

Lifecycle Operations

Viewing Logs

1. Select a container in the tree view
2. Click View Logs
3. Logs stream in real-time

Options:

• Tail last N lines
• Show timestamps
• Follow new output

Executing Commands

Run commands inside a container:

1. Select a running container
2. Click Exec
3. Enter command (e.g., sh, bash, ls -la)
4. Interactive terminal opens

Container Stats

View real-time resource usage:

• CPU percentage
• Memory usage
• Network I/O
• Block I/O

Docker Compose Operations

Manage entire stacks with compose commands:

Stack Status

The tree view shows:

• Running containers (green indicator)
• Stopped containers (gray indicator)
• Compose project groupings
• Service health status

Image Management

List Images

View all local Docker images with:

• Repository and tag
• Image ID
• Size
• Creation date

Pull Images

Download images from registries:

1. Click Pull Image
2. Enter image name and tag (e.g., nginx:latest)
3. Monitor download progress

Build Images

Build from Dockerfile:

1. Click Build Image
2. Select Dockerfile location
3. Enter tag name
4. Optionally add build arguments
5. Monitor build output

Remote Docker Hosts (JetBrains)

Connect to Docker running on remote machines via SSH.

Setup

1. Open Docker tab
2. Click Host dropdown
3. Select Add Remote Host
4. Enter SSH connection details:
   • Host: user@hostname
   • Port: 22 (default)
   • Authentication method

Switching Hosts

Toggle between local and remote Docker:

1. Click Host dropdown
2. Select the target host
3. All operations now execute on that host

Working with Existing Projects

Architect automatically detects Docker files in your project:

• docker-compose.yml / docker-compose.yaml
• docker-compose.*.yml (override files)
• Dockerfile

When you open a project with compose files:

1. The designer visualizes the stack
2. Services appear as nodes on the canvas
3. Connections show relationships
4. Edit visually or in YAML

Layout Persistence

Node positions are saved automatically to .aivory/docker-positions.json. Your layout is preserved across IDE sessions.

Troubleshooting

sudo usermod -aG docker $USER

Next Steps