Incus Deploy 项目启动与配置教程

1. 项目目录结构及介绍

incus-deploy 项目是一个用于部署和操作 Incus 集群的工具集合，包含 Ansible playbooks、Terraform 配置和脚本。以下是项目的目录结构及各部分的简要介绍：

incus-deploy/
├── ansible/           # Ansible playbooks 和相关配置文件
│   ├── data/          # 存储部署过程中生成的数据
│   ├── inventory.yaml.example  # 示例 inventory 文件
│   └── deploy.yaml    # 部署 playbook
├── terraform/         # Terraform 配置文件
│   ├── init.sh        # 初始化 Terraform 项目的脚本
│   └── main.tf        # Terraform 配置文件
├── galaxy.yml         # Ansible Galaxy 角色依赖文件
├── README.md          # 项目说明文件
├── CONTRIBUTING.md    # 贡献指南
├── CODE_OF_CONDUCT.md # 行为准则
└── LICENSE            # Apache-2.0 许可证文件

2. 项目的启动文件介绍

项目的启动主要通过 ansible/deploy.yaml 文件进行。这个文件是 Ansible 的 playbook，用于定义部署 Incus 集群所需的任务和步骤。

以下是 deploy.yaml 的基本内容结构：

- name: Deploy Incus Cluster
  hosts: all
  become: yes
  roles:
    - { role: ceph, tags: ceph }
    - { role: ovn, tags: ovn }
    - { role: incus, tags: incus }

这个 playbook 会应用到所有目标主机，并且会使用 ceph、ovn 和 incus 三个角色来完成部署。

3. 项目的配置文件介绍

项目的主要配置文件包括 ansible/inventory.yaml.example 和 terraform/main.tf。

• ansible/inventory.yaml.example 是一个 Ansible inventory 文件的示例，用于定义目标主机的相关信息，如 IP 地址、用户名、SSH 密钥等。在实际部署时，需要根据实际情况修改此文件，并将其重命名为 inventory.yaml。

示例内容如下：

all:
  hosts:
    server01:
      ansible_host: 192.168.1.1
      ansible_user: user
      ansible_ssh_private_key_file: /path/to/key
    server02:
      ansible_host: 192.168.1.2
      ansible_user: user
      ansible_ssh_private_key_file: /path/to/key
    server03:
      ansible_host: 192.168.1.3
      ansible_user: user
      ansible_ssh_private_key_file: /path/to/key

• terraform/main.tf 是 Terraform 的配置文件，用于定义和创建所需的基础设施，如虚拟机、网络和存储卷。这个文件包含了创建 Incus 集群所需的资源和相关配置。

示例内容如下：

provider "openstack" {
  region = "your-region"
  endpoint = "https://your.openstack.endpoint"
  username = "your-username"
  password = "your-password"
  project_name = "your-project-name"
}

module "baremetal" {
  source = "./modules/baremetal"
  count = 5

  server_image = "incus-image"
  server_flavor = "medium"
  network_name = "private"
  // 其他相关配置...
}

以上内容是 incus-deploy 项目的基本启动和配置介绍。在实际操作中，需要根据项目的具体需求和部署环境进行相应的调整和配置。