mirror of
https://github.com/Dvorinka/Containr.git
synced 2026-06-03 20:12:58 +00:00
Tomas Dvorak
68 lines
1.8 KiB
Markdown
68 lines
1.8 KiB
Markdown
# 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
|
|
|
|
```go
|
|
// 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
|