1 unstable release

new 0.1.0 Oct 13, 2024

#1496 in Command line utilities

Download history 155/week @ 2024-10-11

155 downloads per month

MIT/Apache

24KB
261 lines

Rilis

GitHub Actions Workflow Status GitHub License GitHub repo size

asciicast

Why?

I build this tools for my use cases, i need to communicate with my server then need to automate deployment from my local computer to the VM server i have.

Key Features

  • Effortless VM (Virtual Machine) Deployment
  • Simply configure with a file deploy.toml or anything.toml and use docker-compose.yaml locally.

Installation

# download from crates
cargo install rilis

# download latest from git
cargo install --git https://github.com/ak9024/rilis

Please see the examples here

Configuration

Create configuration named deploy.toml.

[ssh]
# required IPv4 address can be define here.
address = ""
# optional, by default is "root"
username = ""
# You can choose one using "password" or "private_key"
password = ""
# optional if do you want to connect via private_key
private_key = "/Users/adiatma/.ssh/id_ed25519"
# optional by default port 22, but you can customize by your self.
port = 22

[server]
# scp is optional, if do you want to copy file from local to the server, can be define here.
scp = [ "docker-compose.yaml" ]
# ssh commands if do you want to exec script or anything on the server.
commands = [
  "sudo docker compose -f docker-compose.yaml up -d",
  "sudo docker ps",
]

You can define multiple configuration for multiple use case for automation, examples to provision VM using setup.toml, then for deployment using deploy.toml.

Docker

Prepare your docker-compose.yaml

version: "3.8"

services:
  home:
    container_name: home
    image: httpd:latest
    ports:
      - "3000:80"

Then start rilis --cfg deploy.toml

More

rilis -h

License

MIT & Apache 2.0

Dependencies

~18–29MB
~440K SLoC