Docker

Docker is a tool designed to make it easier to create, deploy, and run applications by using containers. Containers allow a developer to package up an application with all parts it needs, such as libraries and other dependencies, and ship it all out as one package.

Documentation

Commands

Init

Initialize a Docker Compose file with database services.

npx ayanokoji docker init

Options

Features

• Interactive service selection - Choose from multiple database services
• Connection strings - Outputs ready-to-use connection strings after setup
• Health checks - All services include health check configuration
• Environment file support - Optionally write connection strings to .env
• Conflict handling - Prompts to override or skip existing env vars
• Gitignore integration - Auto-adds .env to .gitignore

Remove

Remove services from an existing Docker Compose file.

npx ayanokoji docker remove

Options

Features

• Interactive service selection - Choose which services to remove
• Volume cleanup - Automatically removes orphaned volumes
• Environment cleanup - Optionally removes related env vars from .env

Supported Services

Databases

Caching

Message Queues

Storage

Development Tools

Environment Variables

When you choose to write connection strings to .env, the following variables are created:

Health Checks

All services include Docker health checks for better container orchestration:

healthcheck:
  test: ["CMD-SHELL", "..."]
  interval: 10s
  timeout: 5s
  retries: 5

This enables using depends_on with condition: service_healthy in your compose files.

Example Output

Running ayanokoji docker init and selecting PostgreSQL and Redis generates:

services:
  postgres:
    image: postgres:latest
    environment:
      POSTGRES_USER: docker
      POSTGRES_PASSWORD: docker
      POSTGRES_DB: docker
    ports:
      - "5432:5432"
    volumes:
      - postgres_data:/var/lib/postgresql/data
    healthcheck:
      test:
        - CMD-SHELL
        - pg_isready -U docker -d docker
      interval: 10s
      timeout: 5s
      retries: 5
  redis:
    image: redis:latest
    command:
      - redis-server
      - "--requirepass"
      - docker
    ports:
      - "6379:6379"
    volumes:
      - redis_data:/data
    healthcheck:
      test:
        - CMD-SHELL
        - redis-cli -a docker ping | grep PONG
      interval: 10s
      timeout: 5s
      retries: 5
volumes:
  postgres_data: {}
  redis_data: {}