• About ApeRAG
Design
    • System Architecture
    • Chat History Message Data Flow
    • Document Upload Architecture Design
    • Knowledge Graph
Development
    • Container Container Images
    • Development Guide
  1. Documents
GithubDocuments

Build Guide

This section covers how to build ApeRAG container images.

Building Container Images

The project uses Docker and make commands to build container images.
  • Local Platform Builds: These commands build images for your current machine's architecture.
    # Build all necessary images for local platform
make build-local

# Build only the backend image for local platform
make build-aperag-local

# Build only the frontend image for local platform
make build-aperag-frontend-local
  • Multi-platform Builds: These commands build images for multiple architectures (e.g., amd64, arm64). This requires Docker Buildx to be set up and configured.
    # Build all necessary images for multiple platforms
make build

# Build only the backend image for multiple platforms
make build-aperag

# Build only the frontend image for multiple platforms
make build-aperag-frontend
    You can specify the target platforms using the PLATFORMS variable, for example:
    make build PLATFORMS=linux/amd64,linux/arm64

Deployment

Refer to the "Getting Started" section in the main README for common deployment methods:
  • Getting Started with Kubernetes
  • Getting Started with Docker Compose
For custom deployments, you will need to adapt these methods or use the built container images with your chosen orchestration platform. Ensure all required services (databases, backend, frontend, Celery workers) are correctly configured and can communicate with each other.