Containr/app/backend/internal/build/README.md

Railpack Integration

This directory contains the build system for Containr, with Railpack as the primary build method.

Build Types

Railpack (Primary)

• Detection: Automatically detects supported frameworks (Node.js, Python, Go, Rust, Java, Ruby, PHP, Static)
• API: Uses https://api.railpack.app/v1/ for Dockerfile generation
• Fallback: Falls back to Nixpacks if Railpack cannot build the project

Nixpacks (Secondary)

• Detection: Used as fallback when Railpack detection fails
• Local: Runs locally without external API calls

Dockerfile

• Detection: Checks for existing Dockerfile in repository
• Priority: Highest priority if Dockerfile exists

Prebuilt

• Usage: For pre-built container images
• Configuration: Specified in service configuration

Supported Frameworks

Railpack supports the following frameworks:

• Node.js - package.json detection
• Python - requirements.txt detection
• Go - go.mod detection
• Rust - Cargo.toml detection
• Java - pom.xml or build.gradle detection
• Ruby - Gemfile detection
• PHP - composer.json detection
• Static - Static site detection

Usage

// Create build manager
buildManager := build.NewBuildManager("/tmp/builds", dockerClient)

// Build a project
response, err := buildManager.Build(ctx, &types.BuildRequest{
    SourcePath: "/path/to/project",
    ImageName:  "my-app",
    ImageTag:   "latest",
})

API Endpoints

• Generate Dockerfile: POST https://api.railpack.app/v1/generate
• Build Plan: POST https://api.railpack.app/v1/plan

Configuration

Railpack can be configured with:

• Custom build commands
• Custom start commands
• Environment variables
• Build root directory

References

• https://railpack.com/
• https://railpack.com/getting-started
• https://github.com/railwayapp/railpack