stancel.add-job-to-bareos-director

添加作业到 Bareos Director

此角色适用于使用 Bareos 备份系统的用户，Bareos 是一个企业级开源备份管理系统，配有实用的 Web 用户界面，使恢复备份变得非常简单。使用 Bareos 时，最慢的部分是将新机器和/或文件添加到系统中。

此角色提供了一种快速简便的方法来系统地将新机器或项目添加到备份中。运行此角色的 Ansible 主机应为你的 Bareos 服务器（存储 bareos-dir 和 bareos-sd 文件的地方）。

Bareos 是 Bacula 的衍生版本。此 Ansible 角色可能与 Bacula 一起工作，但只经过 Bareos 测试。

Bareos 确实可以备份笔记本电脑（Mac、Linux 和 Windows）及其他未分配静态 IP 地址的设备，但此角色目前不涵盖这些情况。此角色假设系统的 bareos director（bareos-dir）组件在备份时能够联系到 server_fqdn，并且与 bareos file daemon（bareos-fd）协作以获取所需的文件，并将其传递给 bareos storage daemon（bareos-sd）进行永久存储。

要求

你需要使用完整设置好的 Bareos 备份系统版本 17.x 或更高版本。我在使用 Ansible 之前就开始使用 Bareos，没有使用 Ansible 来设置我的实例，但最近找到了这个 Ansible 角色用于安装 Bareos 系统。

角色变量

备份机器的主机名

    add_job_to_bareos_director_host_name: "my-important-crm-server"
```	

要添加进行备份的机器的完全合格域名或 IP 地址

add_job_to_bareos_director_server_fqdn: "crm.example.com"


你的 Bareos 存储守护程序/服务运行的完全合格域名或 IP 地址。对于大多数人来说，这可能与 Bareos Director 守护程序/服务运行的 FQDN 相同（你的 Bareos 服务器），但也可以是另一台机器。

add_job_to_bareos_director_bareos_storage_daemon_fqdn: "待填写"


这是一个非常重要的变量。它需要与在要备份的机器上添加 bareos 客户端程序时输入的 client_password 一致。你可能希望查看我为此目的写的 [Ansible 角色（install-bareos-client）](https://github.com/stancel/install-bareos-client)。此值通常是一个很长的随机字符串（47 个字符），如下所示。

add_job_to_bareos_director_client_password: "kAgt2SJTysbg5iRpcnj5XRexuEnDieGCetCXNQrYGuzNxCf"


存储管理员密码变量是你 Bareos 服务器上的 bareos-dir 密码。使用环境变量（如下所示）或 Ansible Vault 来存储并检索此值到 `storage_director_password` 变量是个好主意。

add_job_to_bareos_director_storage_director_password: "{{ lookup('env', 'BAREOS_STORAGE_PASSWORD') }}"


备份级别 - 完全、增量、差异
* 增量 - 自上一个完全、差异或增量备份以来所有更改的文件
* 差异 - 自上一个成功的 *完全* 备份以来，FileSet 中所有更改的文件将被备份
* 完全 - FileSet 中所有文件，无论是否更改，都将被备份

add_job_to_bareos_director_level: Incremental

允许你通过指定一个正数非零的数字来控制作业的运行顺序。数字越高，作业优先级越低。

add_job_to_bareos_director_priority: 6

你要为此作业/机器设置的备份计划，使用此角色添加的机器。[官方文档在这里](http://doc.bareos.org/master/html/bareos-manual-main-reference.html#x1-1380009.4)

add_job_to_bareos_director_backup_schedule:
  - Run = Full sun at 02:00
  - Run = Incremental mon-sat at 02:00


如下面示例所示，我将其用作文件路径，但你还有其他一些有趣的选项。建议在 [Bareos 文档中查看](http://doc.bareos.org/master/html/bareos-manual-main-reference.html#directiveSdDeviceArchive%20Device)。你还可以备份到分布式文件系统，如 GlusterFS 和对象存储（AWS S3）、磁带等。

add_job_to_bareos_director_archive_device: "/z-storage/backups/{{ add_job_to_bareos_director_host_name }}"


要在备份作业中处理的目录和/或文件列表。[官方文档在这里](http://doc.bareos.org/master/html/bareos-manual-main-reference.html#x1-1410009.5.1)

add_job_to_bareos_director_filesets_to_backup:
  - File = "/var/www/html"
  - File = "/path/to/your/directory"
  - File = "/backups/mysql/current"


要在备份作业中排除的目录和/或文件列表。[官方文档在这里](http://doc.bareos.org/master/html/bareos-manual-main-reference.html#x1-1430009.5.2)。切记不要将你的 git 文件/目录存储在网页服务器的 DocumentRoot 下面。这只是为了演示从备份目录中排除文件或目录的用例。

add_job_to_bareos_director_filesets_to_exclude:
  - File = "/var/www/html/.github"
  - File = "/var/www/html/.git"
  - File = "/var/www/html/.gitignore"


还有一些额外的简单变量，其值在 [defaults/main.yml 文件](../blob/master/defaults/main.yml) 中设置。它们是：

add_job_to_bareos_director_backup_name: "{{ add_job_to_bareos_director_host_name }} 备份"

单个文件记录的保留时长 - 影响在 GUI 中浏览文件的功能

add_job_to_bareos_director_file_retention: 90 天

数据库中的作业记录 - 备份信息/元数据的存储时间

add_job_to_bareos_director_job_retention: 6 个月

实际存储备份文件的时长

add_job_to_bareos_director_volume_retention_full: 12 个月

每个备份卷/文件的最大大小

add_job_to_bareos_director_maximum_volume_bytes_full: 10G

限制池中的卷数量

add_job_to_bareos_director_maximum_volumes_full: 10

实际存储增量备份文件的时长

add_job_to_bareos_director_volume_retention_incremental: 12 个月

增量备份每个卷/文件的最大大小

add_job_to_bareos_director_maximum_volume_bytes_incremental: 10G

限制池中的增量卷数量

add_job_to_bareos_director_maximum_volumes_incremental: 10


依赖项
------------

没有依赖于其他 Ansible 角色。

示例剧本
----------------

- hosts: your_bareos_server
  vars_files:
    - vars/main.yml
  roles:
    - { role: stancel.add-job-to-bareos-director }

或

- hosts: your_bareos_server
  vars:
    add_job_to_bareos_director_host_name: "my-important-crm-server"
    add_job_to_bareos_director_server_fqdn: "crm.example.com"
    add_job_to_bareos_director_client_password: "kAgt2SJTysbg5iRpcnj5XRexuEnDieGCetCXNQrYGuzNxCf"
    add_job_to_bareos_director_storage_director_password: "{{ lookup('env', 'BAREOS_STORAGE_PASSWORD') }}" 
    add_job_to_bareos_director_level: Incremental
    add_job_to_bareos_director_priority: 6
    add_job_to_bareos_director_backup_schedule:
      - Run = Full sun at 02:00
      - Run = Incremental mon-sat at 02:00
    add_job_to_bareos_director_archive_device: "/z-storage/backups/{{ host_name }}"
    add_job_to_bareos_director_filesets_to_backup:
      - File = "/var/www/html"
      - File = "/path/to/your/directory"
      - File = "/backups/mysql/current"
    add_job_to_bareos_director_filesets_to_exclude:
      - File = "/var/www/html/.github"
      - File = "/var/www/html/.git"
      - File = "/var/www/html/.gitignore"
  roles:
    - { role: stancel.add-job-to-bareos-director }