eclipseosgitechnology/feature-launcher-local-directory-installer repository overview

⁠OSGi Feature Launcher - Local Directory Installer

OSGi Feature Launcher container that automatically discovers mounted artifact volumes and installs their features at runtime. Bundles are resolved from the local file repository only.

Uses the all.lite launcher with the installer.directory bundle and the hash.checker extension.

⁠How It Works

1. The launcher starts with a bootstrap feature that includes the Directory Installer and Hash Checker bundles
2. The Directory Installer scans /app/storage/features for *.json feature files
3. If configured, it also discovers artifact volumes under /app/artifacts/:
   • Each child directory's repo/ subdirectory is registered as a repository
   • Each child directory's features/ subdirectory is scanned for feature files
4. Discovered features are installed via the OSGi FeatureRuntime
5. Bundle integrity can be verified via the Hash Checker extension

⁠Available Tags

⁠Quick Start

docker pull ghcr.io/eclipse-osgi-technology/feature-launcher-local-directory-installer:eclipse-temurin-17-snapshot

docker run \
  -v ./my-features:/app/storage/features:ro \
  -v ./my-repo:/app/storage/repo:ro \
  ghcr.io/eclipse-osgi-technology/feature-launcher-local-directory-installer:eclipse-temurin-17-snapshot

⁠Mounting Artifact Volumes

Mount artifact volumes under /app/artifacts/. Each child directory may contain repo/ and features/ subdirectories:

docker run \
  -v ./jetty-artifact:/app/artifacts/jetty:ro \
  -v ./jaxrs-artifact:/app/artifacts/jaxrs:ro \
  ghcr.io/eclipse-osgi-technology/feature-launcher-local-directory-installer:eclipse-temurin-17-snapshot

Expected artifact volume structure:

jetty-artifact/
├── repo/
│   └── org/eclipse/jetty/...    # Maven layout
└── features/
    └── jetty-feature.json

⁠Volumes

⁠Environment Variables

⁠Example: Watch mode with 10-second interval

docker run \
  -e OSGITECH_SCAN_MODE=WATCH \
  -e OSGITECH_SCAN_INTERVAL=10 \
  -v ./features:/app/storage/features \
  -v ./repo:/app/storage/repo \
  ghcr.io/eclipse-osgi-technology/feature-launcher-local-directory-installer:eclipse-temurin-17-snapshot

⁠Custom Configuration

Mount a custom args-file to override all launcher settings:

docker run \
  -v ./my-launcher.args:/app/launcher.args:ro \
  ghcr.io/eclipse-osgi-technology/feature-launcher-local-directory-installer:eclipse-temurin-17-snapshot

⁠License

Eclipse Public License 2.0⁠