reploy

README

Reploy

Reploy is an experimental deployment lifecycle tool for services.

Reploy turns an environment blueprint into a local staging workspace, lets you configure and test it, then installs its optional workload. Docker is the first supported runtime.

Host OS	Docker	Staging	User install	System install
Linux	Docker Engine	✅	✅	✅
macOS	Docker-compatible	✅	✅	—
Windows	Docker Desktop	✅	✅	—

Install

Install the latest release binary:

curl -fsSL https://reploy.yadan.net/install.sh | sh

On Windows, use the PowerShell installer:

irm https://reploy.yadan.net/install.ps1 | iex

From cmd.exe, invoke PowerShell explicitly:

powershell -NoProfile -ExecutionPolicy Bypass -Command "irm https://reploy.yadan.net/install.ps1 | iex"

See the installation docs for script options and other installation methods.

Quickstart

Try Reploy with the included OmegaConf Inspector demo:

OmegaConf Inspector is a small browser app for merging YAML config layers and inspecting the OmegaConf result. It is useful as a Reploy demo because it has real Python dependencies, service config, a browser UI, health checks, logs, control commands, and writable project data, but stays neutral enough to try without learning a domain-specific app first.

APP_REF=omegaconf-inspector-demo

# Create a self-contained staging workspace in ./reploy-staging.
reploy stage "$APP_REF"

# Resolve packages, build the image, and validate it.
reploy build

# Configure and operate the app through its staging-owned command.
./reploy-staging/omegaconf-inspector config init
./reploy-staging/omegaconf-inspector config check

# Start and test the staged service.
./reploy-staging/omegaconf-inspector up
reploy test

# Install the tested staging workspace for the current user.
reploy install --scope user --to "$PWD/omegaconf-inspector-installed"

# Tail logs through the installed app control script.
./omegaconf-inspector-installed/omegaconf-inspector logs --tail=100

Read the app installation guide for the full staging and install workflow.

Documentation

Read the Reploy documentation for the full guide.

Maintainer setup is documented in docs/MAINTAINING.md. Design notes live in docs/.

Documentation

Index

• Variables
• func DisplayVersion() string

Variables

var BuildCommit string

var BuildDirty string

var BuildTimestamp string

var Version string

Functions

func DisplayVersion

func DisplayVersion() string