Skip to content

omry/reploy

Repository files navigation

Reploy

CI Go Report Card Go version Release Docs License

Reploy is an experimental deployment lifecycle tool for services.

It creates a self-contained staging workspace from an app-provided blueprint, lets you configure and test the app there, and can install the result as a deployed host service. Docker is the first supported deployment runtime. Linux supports both current-user Docker-managed installs and system-scope systemd installs; macOS and Windows support Docker Desktop-backed staging and Docker-managed user-scope permanent installs.

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"

# Create and validate the demo service config.
reploy app config init
reploy app config check

# Start and test the staged service.
reploy 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-inspectorctl 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/.

About

Experimental deployment lifecycle tool

Resources

License

Stars

1 star

Watchers

0 watching

Forks

Packages

 
 
 

Contributors