Adds dist.
This commit is contained in:
76
dist/README.md
vendored
Normal file
76
dist/README.md
vendored
Normal file
@@ -0,0 +1,76 @@
|
||||
# Packaging Wild Central
|
||||
|
||||
## Installation
|
||||
|
||||
### APT Repository (recommended)
|
||||
|
||||
```bash
|
||||
# Import the signing key
|
||||
curl -fsSL https://aptly.cloud2.payne.io/wild-central.gpg \
|
||||
| sudo tee /usr/share/keyrings/wild-central.gpg > /dev/null
|
||||
|
||||
# Add the repository
|
||||
sudo tee /etc/apt/sources.list.d/wild-central.sources <<EOF
|
||||
Types: deb
|
||||
URIs: https://aptly.cloud2.payne.io
|
||||
Suites: stable
|
||||
Components: main
|
||||
Signed-By: /usr/share/keyrings/wild-central.gpg
|
||||
EOF
|
||||
|
||||
sudo apt update && sudo apt install wild-central
|
||||
```
|
||||
|
||||
Use `Suites: edge` for rolling builds from HEAD.
|
||||
|
||||
### Manual .deb install
|
||||
|
||||
```bash
|
||||
sudo dpkg -i wild-central_*.deb
|
||||
sudo apt-get install -f
|
||||
```
|
||||
|
||||
## Quick Start
|
||||
|
||||
1. **Start the service**:
|
||||
```bash
|
||||
sudo systemctl enable --now wild-central
|
||||
```
|
||||
|
||||
2. **Access the web interface**: open `http://your-server-ip` in your browser
|
||||
|
||||
3. **Configure** (optional):
|
||||
```bash
|
||||
sudo cp /etc/wild-central/config.yaml.example /etc/wild-central/config.yaml
|
||||
sudo nano /etc/wild-central/config.yaml
|
||||
sudo systemctl restart wild-central
|
||||
```
|
||||
|
||||
## Release Artifacts
|
||||
|
||||
Each release includes:
|
||||
- `wild-central_{VERSION}_{arch}.deb` — full install (daemon + web UI)
|
||||
- `wild-central-{arch}` — standalone daemon binary
|
||||
- `SHA256SUMS` — checksums for all artifacts
|
||||
|
||||
## Developer Tooling
|
||||
|
||||
```bash
|
||||
make help # Show all targets and current version info
|
||||
make package-all # Build all .deb packages
|
||||
make release # Stable release: tag + Gitea + APT stable
|
||||
make release-edge # Edge release: force-tag + Gitea + APT edge
|
||||
make deploy-repo # Deploy packages to APT repository only
|
||||
```
|
||||
|
||||
Directory structure:
|
||||
|
||||
```
|
||||
build/ Intermediate build artifacts
|
||||
dist/bin/ Standalone binaries
|
||||
dist/packages/ .deb packages
|
||||
```
|
||||
|
||||
Environment variables (see `.envrc`):
|
||||
- `GITEA_TOKEN` — required for `make release` / `make release-edge`
|
||||
- `APTLY_URL` / `APTLY_PASS` — required for APT deployment
|
||||
Reference in New Issue
Block a user