131 lines
3.7 KiB
Markdown
131 lines
3.7 KiB
Markdown
# Container Build Environment
|
|
|
|
This directory contains OCI-compatible Containerfiles (Dockerfiles) for building the Android File Handler on different Linux distributions. These images match exactly the images used in the CI/CD pipeline.
|
|
|
|
The project uses **Podman** as the container runtime. All commands below use Podman; if you have Docker installed, the Dockerfiles are OCI-compatible and will work with Docker as well.
|
|
|
|
## Quick Start
|
|
|
|
### Using Podman Compose (Recommended)
|
|
|
|
Build for all distributions:
|
|
```bash
|
|
podman-compose up --build
|
|
```
|
|
|
|
Build for a specific distribution:
|
|
```bash
|
|
podman-compose up --build debian
|
|
podman-compose up --build arch
|
|
podman-compose up --build rhel
|
|
```
|
|
|
|
### Using Prefect + Dagger (CI Pipeline Locally)
|
|
|
|
The CI/CD pipeline uses Prefect and Dagger to orchestrate builds. You can run it locally:
|
|
```bash
|
|
poetry install --with ci
|
|
poetry run python -m ci.prefect_flow build-linux
|
|
```
|
|
|
|
### Manual Podman Build
|
|
|
|
Build the image:
|
|
```bash
|
|
# Debian
|
|
podman build -f scripts/docker/Dockerfile.debian -t android-file-handler-debian-builder .
|
|
|
|
# Arch
|
|
podman build -f scripts/docker/Dockerfile.arch -t android-file-handler-arch-builder .
|
|
|
|
# RHEL/Fedora
|
|
podman build -f scripts/docker/Dockerfile.rhel -t android-file-handler-rhel-builder .
|
|
```
|
|
|
|
Run the build:
|
|
```bash
|
|
# Debian
|
|
podman run --rm -v $(pwd):/workspace:Z -w /workspace android-file-handler-debian-builder
|
|
|
|
# Arch
|
|
podman run --rm -v $(pwd):/workspace:Z -w /workspace android-file-handler-arch-builder
|
|
|
|
# RHEL/Fedora
|
|
podman run --rm -v $(pwd):/workspace:Z -w /workspace android-file-handler-rhel-builder
|
|
```
|
|
|
|
## Output
|
|
|
|
After building, you'll find:
|
|
|
|
- `dist/` - Final packaged files (.deb, .rpm, .pkg.tar.zst)
|
|
- `pkg_dist_{distro}/` - Staging directories for package contents
|
|
- `dist_{distro}/` - PyInstaller build outputs
|
|
|
|
## Images
|
|
|
|
### Debian Builder
|
|
- **Image**: `ghcr.io/jmr-dev/android-file-handler-debian-builder:debian13-trixie`
|
|
- **Base**: `debian:13`
|
|
- **Python**: 3.13 (via pyenv)
|
|
- **Tools**: Poetry, fpm, PyInstaller
|
|
|
|
### Arch Builder
|
|
- **Image**: `ghcr.io/jmr-dev/android-file-handler-arch-builder:latest`
|
|
- **Base**: `archlinux:latest`
|
|
- **Python**: 3.13 (via pyenv)
|
|
- **Tools**: Poetry, fpm, PyInstaller
|
|
|
|
### RHEL Builder
|
|
- **Image**: `ghcr.io/jmr-dev/android-file-handler-rhel-builder:fedora42`
|
|
- **Base**: `fedora:42`
|
|
- **Python**: 3.13 (via pyenv)
|
|
- **Tools**: Poetry, fpm, PyInstaller
|
|
|
|
## Troubleshooting
|
|
|
|
### Virtualenv Conflicts
|
|
|
|
The Podman Compose configuration automatically excludes the host's `.venv` directory to prevent conflicts between the host Python environment and the container Python environment. Each container creates its own virtualenv in `/tmp/poetry-cache`.
|
|
|
|
If you encounter virtualenv-related errors, ensure you're using the latest podman-compose.yml configuration.
|
|
|
|
### SELinux (Fedora/RHEL hosts)
|
|
|
|
Volume mounts use the `:Z` suffix to apply the correct SELinux labels automatically. If you encounter permission errors, ensure the `:Z` suffix is present on volume mounts.
|
|
|
|
## Cleaning Up
|
|
|
|
Remove build artifacts:
|
|
```bash
|
|
rm -rf dist pkg_dist_* dist_*
|
|
```
|
|
|
|
Remove Podman containers and volumes:
|
|
```bash
|
|
podman-compose down -v
|
|
```
|
|
|
|
## Customization
|
|
|
|
### Override FPM Version
|
|
|
|
Build with a specific fpm version:
|
|
```bash
|
|
docker-compose build --build-arg FPM_VERSION=1.15.0 debian
|
|
```
|
|
|
|
### Environment Variables
|
|
|
|
All builds use these environment variables:
|
|
- `CI_CD=true` - Runs in CI/CD mode
|
|
- `DISTRO_TYPE` - Set to `debian`, `arch`, or `rhel`
|
|
- `FPM_VERSION` - Version of fpm to use (default: 1.16.0)
|
|
|
|
## Notes
|
|
|
|
- All images use Python 3.13 built from source with tkinter support
|
|
- The builds are identical to what runs in GitHub Actions
|
|
- Poetry and fpm are pre-installed in all images
|
|
- The Python build script handles both PyInstaller and fpm packaging
|