ruStack Launcher

一个用于开发应用程序启动器的 Rust 库。它使用单个 TOML 配置文件，自动将其转换为 .env 和 YAML 文件。此库还允许您轻松地在 Docker Compose 和 Podman Compose 之间切换。

NOTE: This is a personal project created for practicing Rust development. Feel free to modify this library as you see fit.

配置文件

启动器使用 TOML 格式来接收配置。有关指南，请参阅 TOML。

表格

[settings]

提供对启动器功能及其常用配置值的洞察。

属性

示例

[settings]
name = "Hello There"
description = "MyAppStack launcher."
author = "JP Mateo"
base_dir = "/mydirectory"
deploy_dir = "deploy"
services_dir = "services"
compose_executable = "docker-compose"
compose_file = "docker-compose-test.yaml"
compose_detached = true

[[services]]

包含一个服务列表或数组，格式与 Docker Compose 服务兼容。有关更多详细信息，请参阅： Docker Compose 服务文档

示例

[[services]]
#This is the app service.
hostname = "db"
image = "postgres"
ports = [
    "5432:5432"
]
environment = { POSTGRES_USER = "admin", POSTGRES_PASSWORD = "admin123",  PGDATA="/var/lib/postgresql/data/pgdata" }
env_file = [
    "database",
]
networks = [
    "mynetwork"
]
volumes = [
    { kind = "bind", source = "/Users/jpmateo/Codes/rust/rustack-launcher/tests/testapp/data", target = "/var/lib/postgresql/data/pgdata"}
]
depends_on = [
    "myserviceapp"
]
restart = "always"
tty = true

[[networks]]

包含一个网络列表或数组，格式符合 Docker Compose 网络规范。有关更多指导，请参阅： Docker Compose 网络文档

示例

[[networks]]
name = "mynetwork2"
driver = "bridge"
external = false
labels = { "my.network.label.1" = "This is a network label 1.", "my.network.label.2" = "This is a network label 2." }

[[volumes]]

包含一个与 Docker Compose 体积规范兼容的体积列表或数组。有关更多信息，请参阅：Docker Compose 体积文档

[[volumes]]
name = "testvolumes"
driver = "nfs"
driver_opts = [
    { name = "type", value = "nfs" },
    { name = "o", value = "addr=10.40.0.199,nolock,soft,rw" },
    { name = "device", value = ":/docker/example" },
]
external = false
labels = { "my.volume.label1" = "This is a volume label 1.", "my.volume.label2" = "This is a volume label 2." }

[[repositories]]

这包括需要从版本控制系统拉取的存储库列表或数组。

Note: I did not include the authentication method. It is generally better to establish a connection between your machine/server and the desired Git server before proceeding.

示例

[[repositories]]
service = "app"
mount_target = "/var/db"
name = "execism-diffie-hellman"
url = "https://github.com/j-p-d-e-v/execism-diffie-hellman"
branch = "master"
clone = false

使用 Docker-Compose

先决条件

1. Docker 引擎必须在您的系统中安装。参见：https://docs.docker.net.cn/
2. Docker-Compose 必须在您的系统中安装：参见：https://docs.docker.net.cn/compose/install/podman-compose

    //Load the toml configuration file.
    let config = Config::load("config-test-docker.toml".to_string());

    let deploy_dir: String = format!("{}/{}",config.settings.base_dir,&config.settings.deploy_dir);
    config.validate();
    let env_file_paths: Vec<String> = EnvironmentFile::generate(&config.env_files,&deploy_dir);
    let compose: Compose = Compose::new(config);
    compose.up();
    compose.down();

使用 Podman-Compose

先决条件

1. Podman 必须在您的系统中安装。参见：https://podman.io/
2. Podman-Compose 必须在您的系统中安装：参见：https://github.com/containers/podman-compose

示例

    let config = Config::load("config-test-podman.toml".to_string());
    let deploy_dir: String = format!("{}/{}",config.settings.base_dir,&config.settings.deploy_dir);
    config.validate();
    let env_file_paths: Vec<String> = EnvironmentFile::generate(&config.env_files,&deploy_dir);
    let compose: Compose = Compose::new(config);
    compose.up();
    compose.down();

单元测试

cargo test -- --test-threads 1 --nocapture

开发者

• JP Mateo