Hashi-Homelab 项目教程

Hashi-Homelab 项目教程

hashi-homelabHashicorp Homelab is a collection of nomad recipes related to several Open Source projects that I use on my own nomad + consul + vault + Intel Nuc cluster.项目地址:https://gitcode.com/gh_mirrors/has/hashi-homelab

1. 项目的目录结构及介绍

Hashi-Homelab 项目的目录结构如下：

hashi-homelab/
├── assets/
│   └── ...
├── packer/
│   └── ...
├── recipes/
│   └── ...
├── .editorconfig
├── .envrc
├── .gitattributes
├── .gitignore
├── LICENSE
├── Makefile
├── README.md
└── levant.yaml

目录结构介绍

• assets/: 存放项目所需的静态资源文件。
• packer/: 存放与 Packer 相关的配置文件，用于构建镜像。
• recipes/: 存放 Nomad 配置文件（recipes），用于部署各种开源服务。
• .editorconfig: 编辑器配置文件，用于统一代码风格。
• .envrc: 环境变量配置文件，用于设置项目运行时的环境变量。
• .gitattributes: Git 属性配置文件，用于指定文件的属性。
• .gitignore: Git 忽略文件配置，用于指定不需要纳入版本控制的文件。
• LICENSE: 项目许可证文件，说明项目的开源许可协议。
• Makefile: 项目的构建和部署脚本。
• README.md: 项目说明文档，包含项目的介绍、安装和使用说明。
• levant.yaml: Levant 配置文件，用于管理和部署 Nomad 作业。

2. 项目的启动文件介绍

Makefile

Makefile 是项目的启动文件之一，包含了项目的构建和部署命令。通过 Makefile，用户可以快速启动和部署各种服务。

主要命令

• make deploy-postgres: 快速部署 PostgreSQL 服务。
• make deploy-mysql: 快速部署 MySQL 服务。
• make deploy-nextcloud: 快速部署 Nextcloud 服务。

levant.yaml

levant.yaml 是 Levant 的配置文件，用于管理和部署 Nomad 作业。Levant 是一个用于 Nomad 的模板渲染和作业部署工具。

主要配置项

• job: 定义 Nomad 作业的名称和类型。
• task: 定义作业的具体任务和配置。
• template: 定义模板文件，用于生成 Nomad 作业的配置文件。

3. 项目的配置文件介绍

.envrc

.envrc 文件用于设置项目运行时的环境变量。通过设置环境变量，用户可以灵活地配置项目的运行环境。

示例

export NOMAD_ADDR=http://localhost:4646
export CONSUL_HTTP_ADDR=http://localhost:8500
export VAULT_ADDR=http://localhost:8200

recipes/

recipes/ 目录下存放了各种服务的 Nomad 配置文件（recipes）。每个配置文件定义了一个服务的部署方式。

示例：recipes/postgres.nomad

job "postgres" {
  datacenters = ["dc1"]

  group "postgres" {
    task "postgres" {
      driver = "docker"

      config {
        image = "postgres:13"
        ports = ["db"]
      }

      env {
        POSTGRES_USER = "user"
        POSTGRES_PASSWORD = "password"
        POSTGRES_DB = "mydb"
      }
    }
  }
}

.editorconfig

.editorconfig 文件用于统一代码风格，确保不同开发者使用不同编辑器时，代码风格一致。

示例

root = true

[*]
indent_style = space
indent_size = 2
end_of_line = lf
charset = utf-8
trim_trailing_whitespace = true
insert_final_newline = true

通过以上介绍，您可以更好地理解和使用 Hashi-Homelab 项目。

hashi-homelabHashicorp Homelab is a collection of nomad recipes related to several Open Source projects that I use on my own nomad + consul + vault + Intel Nuc cluster.项目地址:https://gitcode.com/gh_mirrors/has/hashi-homelab