mirror of
https://github.com/johndoe6345789/SparkOS.git
synced 2026-04-24 13:34:56 +00:00
Update README with release workflow documentation
Co-authored-by: johndoe6345789 <224850594+johndoe6345789@users.noreply.github.com>
This commit is contained in:
39
README.md
39
README.md
@@ -25,6 +25,8 @@ The current MVP provides:
|
|||||||
- ✅ Docker container for testing
|
- ✅ Docker container for testing
|
||||||
- ✅ Automated builds and publishing to GHCR
|
- ✅ Automated builds and publishing to GHCR
|
||||||
- ✅ Multi-architecture Docker images (AMD64 and ARM64)
|
- ✅ Multi-architecture Docker images (AMD64 and ARM64)
|
||||||
|
- ✅ CI/CD pipeline for compiled release packages
|
||||||
|
- ✅ GitHub releases with pre-built binaries
|
||||||
|
|
||||||
## Prerequisites
|
## Prerequisites
|
||||||
|
|
||||||
@@ -43,6 +45,32 @@ To create bootable images (optional):
|
|||||||
|
|
||||||
## Quick Start
|
## Quick Start
|
||||||
|
|
||||||
|
### Using Pre-built Releases (Easiest)
|
||||||
|
|
||||||
|
Download the latest release package from the [GitHub Releases page](https://github.com/johndoe6345789/SparkOS/releases):
|
||||||
|
|
||||||
|
```bash
|
||||||
|
# Download the latest release (replace VERSION with actual version, e.g., v1.0.0)
|
||||||
|
wget https://github.com/johndoe6345789/SparkOS/releases/download/VERSION/sparkos-release.zip
|
||||||
|
|
||||||
|
# Extract the package
|
||||||
|
unzip sparkos-release.zip
|
||||||
|
cd sparkos/
|
||||||
|
|
||||||
|
# The init binary is already compiled and ready to use
|
||||||
|
ls -lh init
|
||||||
|
|
||||||
|
# Copy to your rootfs or use directly
|
||||||
|
cp init /path/to/your/rootfs/sbin/init
|
||||||
|
```
|
||||||
|
|
||||||
|
The release package includes:
|
||||||
|
- Pre-compiled init binary (statically linked, ready to use)
|
||||||
|
- Complete source code
|
||||||
|
- Build scripts and configuration
|
||||||
|
- Root filesystem structure
|
||||||
|
- Full documentation
|
||||||
|
|
||||||
### Using Docker (Recommended for Testing)
|
### Using Docker (Recommended for Testing)
|
||||||
|
|
||||||
The easiest way to test SparkOS is using the pre-built Docker image from GitHub Container Registry:
|
The easiest way to test SparkOS is using the pre-built Docker image from GitHub Container Registry:
|
||||||
@@ -187,10 +215,17 @@ SparkOS uses GitHub Actions for continuous integration and delivery:
|
|||||||
|
|
||||||
**Automated Builds:**
|
**Automated Builds:**
|
||||||
- Docker images are automatically built on every push to main/develop branches
|
- Docker images are automatically built on every push to main/develop branches
|
||||||
- Images are also built for pull requests (testing only, not published)
|
- Compiled release packages are automatically built on every push to main/develop branches
|
||||||
- Tagged releases automatically create versioned Docker images
|
- Images and releases are also built for pull requests (testing only, not published)
|
||||||
|
- Tagged releases automatically create versioned Docker images and GitHub releases with compiled binaries
|
||||||
- **Multi-architecture builds**: Images are built for both AMD64 (x86_64) and ARM64 (aarch64)
|
- **Multi-architecture builds**: Images are built for both AMD64 (x86_64) and ARM64 (aarch64)
|
||||||
|
|
||||||
|
**Compiled Releases:**
|
||||||
|
- Pre-compiled init binaries are available as GitHub releases for version tags
|
||||||
|
- Release packages include: compiled init binary, source code, build scripts, and documentation
|
||||||
|
- Download releases from the [GitHub Releases page](https://github.com/johndoe6345789/SparkOS/releases)
|
||||||
|
- Build artifacts are available for all workflow runs (retained for 90 days)
|
||||||
|
|
||||||
**Container Registry:**
|
**Container Registry:**
|
||||||
- Images are published to GitHub Container Registry (GHCR)
|
- Images are published to GitHub Container Registry (GHCR)
|
||||||
- Pull images: `docker pull ghcr.io/johndoe6345789/sparkos:latest`
|
- Pull images: `docker pull ghcr.io/johndoe6345789/sparkos:latest`
|
||||||
|
|||||||
Reference in New Issue
Block a user