bretton.dev
A community based topic aggregation platform built on atproto
feat(kagi): add production-ready Docker deployment
Add complete Docker configuration for containerized deployment.
Files added:
- Dockerfile: Multi-stage Python 3.11 image with cron scheduler
- docker-compose.yml: Simple deployment configuration
- docker-entrypoint.sh: Startup script with validation
- .dockerignore: Build optimization
Features:
- Automated cron scheduling (daily at 1 PM UTC)
- Health checks (verifies cron is running)
- Log rotation (10MB max, 3 files)
- Auto-restart on failure
- Environment-based configuration
- Single command deployment: docker compose up -d
The container runs cron internally and streams logs to stdout,
making it production-ready and easy to monitor.
Updated README with comprehensive Docker deployment documentation
including quick start, configuration, testing, and production
deployment best practices.
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude <noreply@anthropic.com>
+55
aggregators/kagi-news/.dockerignore
+55
aggregators/kagi-news/.dockerignore
···
1
+
# Git
2
+
.git
3
+
.gitignore
4
+
5
+
# Python
6
+
__pycache__
7
+
*.py[cod]
8
+
*$py.class
9
+
*.so
10
+
.Python
11
+
venv/
12
+
*.egg-info
13
+
dist/
14
+
build/
15
+
16
+
# Testing
17
+
.pytest_cache/
18
+
.coverage
19
+
htmlcov/
20
+
.tox/
21
+
.hypothesis/
22
+
23
+
# IDE
24
+
.vscode/
25
+
.idea/
26
+
*.swp
27
+
*.swo
28
+
*~
29
+
30
+
# Environment
31
+
.env.local
32
+
.env.*.local
33
+
34
+
# Data and logs
35
+
data/
36
+
*.log
37
+
38
+
# Documentation
39
+
README.md
40
+
docs/
41
+
42
+
# Docker
43
+
Dockerfile
44
+
docker-compose.yml
45
+
.dockerignore
46
+
47
+
# Development
48
+
tests/
49
+
pytest.ini
50
+
mypy.ini
51
+
.mypy_cache/
52
+
53
+
# OS
54
+
.DS_Store
55
+
Thumbs.db
+53
aggregators/kagi-news/Dockerfile
+53
aggregators/kagi-news/Dockerfile
···
1
+
# Kagi News RSS Aggregator
2
+
# Production-ready Docker image with cron scheduler
3
+
4
+
FROM python:3.11-slim
5
+
6
+
# Install cron and other utilities
7
+
RUN apt-get update && apt-get install -y \
8
+
cron \
9
+
curl \
10
+
procps \
11
+
&& rm -rf /var/lib/apt/lists/*
12
+
13
+
# Set working directory
14
+
WORKDIR /app
15
+
16
+
# Copy requirements first for better caching
17
+
COPY requirements.txt .
18
+
19
+
# Install Python dependencies (exclude dev/test deps in production)
20
+
RUN pip install --no-cache-dir \
21
+
feedparser==6.0.11 \
22
+
beautifulsoup4==4.12.3 \
23
+
requests==2.31.0 \
24
+
atproto==0.0.55 \
25
+
pyyaml==6.0.1
26
+
27
+
# Copy application code
28
+
COPY src/ ./src/
29
+
COPY config.yaml ./
30
+
31
+
# Copy crontab file
32
+
COPY crontab /etc/cron.d/kagi-aggregator
33
+
34
+
# Give execution rights on the cron job and apply it
35
+
RUN chmod 0644 /etc/cron.d/kagi-aggregator && \
36
+
crontab /etc/cron.d/kagi-aggregator
37
+
38
+
# Create log file to be able to run tail
39
+
RUN touch /var/log/cron.log
40
+
41
+
# Copy entrypoint script
42
+
COPY docker-entrypoint.sh /usr/local/bin/
43
+
RUN chmod +x /usr/local/bin/docker-entrypoint.sh
44
+
45
+
# Health check - verify cron is running
46
+
HEALTHCHECK --interval=60s --timeout=10s --start-period=10s --retries=3 \
47
+
CMD pgrep cron || exit 1
48
+
49
+
# Run the entrypoint script
50
+
ENTRYPOINT ["docker-entrypoint.sh"]
51
+
52
+
# Default command: tail the cron log
53
+
CMD ["tail", "-f", "/var/log/cron.log"]
+48
aggregators/kagi-news/docker-compose.yml
+48
aggregators/kagi-news/docker-compose.yml
···
1
+
services:
2
+
kagi-aggregator:
3
+
build:
4
+
context: .
5
+
dockerfile: Dockerfile
6
+
container_name: kagi-news-aggregator
7
+
restart: unless-stopped
8
+
9
+
# Environment variables - override in .env file or here
10
+
environment:
11
+
# Required: Aggregator credentials
12
+
- AGGREGATOR_HANDLE=${AGGREGATOR_HANDLE}
13
+
- AGGREGATOR_PASSWORD=${AGGREGATOR_PASSWORD}
14
+
15
+
# Optional: Override Coves API URL
16
+
- COVES_API_URL=${COVES_API_URL:-https://api.coves.social}
17
+
18
+
# Optional: Run immediately on startup (useful for testing)
19
+
- RUN_ON_STARTUP=${RUN_ON_STARTUP:-false}
20
+
21
+
# Mount config file if you want to modify it without rebuilding
22
+
volumes:
23
+
- ./config.yaml:/app/config.yaml:ro
24
+
- ./data:/app/data # For state persistence (if implemented)
25
+
26
+
# Use env_file to load credentials from .env
27
+
env_file:
28
+
- .env
29
+
30
+
# Logging configuration
31
+
logging:
32
+
driver: "json-file"
33
+
options:
34
+
max-size: "10m"
35
+
max-file: "3"
36
+
37
+
# Health check
38
+
healthcheck:
39
+
test: ["CMD", "pgrep", "cron"]
40
+
interval: 60s
41
+
timeout: 10s
42
+
retries: 3
43
+
start_period: 10s
44
+
45
+
# Optional: Networks for multi-container setups
46
+
# networks:
47
+
# coves:
48
+
# external: true
+41
aggregators/kagi-news/docker-entrypoint.sh
+41
aggregators/kagi-news/docker-entrypoint.sh
···
1
+
#!/bin/bash
2
+
set -e
3
+
4
+
echo "Starting Kagi News RSS Aggregator..."
5
+
echo "========================================="
6
+
7
+
# Load environment variables if .env file exists
8
+
if [ -f /app/.env ]; then
9
+
echo "Loading environment variables from .env"
10
+
export $(grep -v '^#' /app/.env | xargs)
11
+
fi
12
+
13
+
# Validate required environment variables
14
+
if [ -z "$AGGREGATOR_HANDLE" ] || [ -z "$AGGREGATOR_PASSWORD" ]; then
15
+
echo "ERROR: Missing required environment variables!"
16
+
echo "Please set AGGREGATOR_HANDLE and AGGREGATOR_PASSWORD"
17
+
exit 1
18
+
fi
19
+
20
+
echo "Aggregator Handle: $AGGREGATOR_HANDLE"
21
+
echo "Cron schedule loaded from /etc/cron.d/kagi-aggregator"
22
+
23
+
# Start cron in the background
24
+
echo "Starting cron daemon..."
25
+
cron
26
+
27
+
# Optional: Run aggregator immediately on startup (for testing)
28
+
if [ "$RUN_ON_STARTUP" = "true" ]; then
29
+
echo "Running aggregator immediately (RUN_ON_STARTUP=true)..."
30
+
cd /app && python -m src.main
31
+
fi
32
+
33
+
echo "========================================="
34
+
echo "Kagi News Aggregator is running!"
35
+
echo "Cron schedule: Daily at 1 PM UTC"
36
+
echo "Logs will appear below:"
37
+
echo "========================================="
38
+
echo ""
39
+
40
+
# Execute the command passed to docker run (defaults to tail -f /var/log/cron.log)
41
+
exec "$@"