迁移到 RHEL 8/9

为新的 RHEL 8/9 系统创建并准备 Salt 基础架构后，可以执行以下迁移步骤来完成到 RHEL 8/9 的升级。

准备并执行迁移

1. 在 RHEL 7 和 RHEL 8/9 系统上停止 RaaS 服务。
2. 将 gz 备份文件从旧服务器复制到新服务器。gz 文件必须存储在 /var/lib/pgsql 目录中，且 ownership 必须设置为 postgres:postgres。
3. 从 postgres 用户运行以下命令以移除数据库目录：

   su - postgres
   psql -U postgres
   drop database raas_43cab1f4de604ab185b51d883c5c5d09
   

4. 创建一个空数据库并验证用户：

   create database raas_43cab1f4de604ab185b51d883c5c5d09
   \du – should display users for postgres and salteapi

5. 将 /etc/raas/pki/.raas.key 和 /etc/raas/pki/.instance_id 文件从旧的 RaaS 服务器复制到新的 RaaS 服务器。
6. 对新的 Postgresql 数据库运行升级命令：

   su – raas
   raas -l debug upgrade
   

现在，您可以在新的 rhel9-raas 服务器上启动 raas 服务。您还可以在浏览器中访问 Automation Config UI。接下来，必须在新的 RHEL 8/9 Salt 主节点上配置主节点插件。

在新的 Salt 主节点上配置主节点插件

在新的 rhel9-master 节点上执行这些步骤。

1. 登录到 Salt 主节点并验证 /etc/salt/master.d 目录是否存在，如果不存在，则创建该目录。
2. 生成主配置设置。
   小心： 如果要在升级安装时保留设置，请备份现有的主节点插件配置文件，然后再运行此步骤。之后，将相关设置从现有配置复制到新生成的文件中。

   sudo sseapi-config --all > /etc/salt/master.d/raas.conf

   如果运行此命令导致错误，则可能与最初安装 Salt 时所使用的方法相关。如果通过 Automation Config 安装程序安装 Salt，则安装可能包括一个称为 Salt Crystal 的脱机软件包，这需要特殊的升级说明。有关详细信息，请参见故障排除页面。

3. 编辑生成的 raas.conf 文件并按如下所示更新值，以验证 API (RaaS) 使用的证书并设置其 IP 地址。

   值	说明
   sseapi_ssl_validate_cert	验证 API (RaaS) 使用的证书。默认值为 True。 如果使用自己 CA 颁发的证书，请将此值设置为 True 并配置 sseapi_ssl_ca、sseapi_ssl_cert 和 sseapi_ssl_cert: 设置。 否则，请将此值设置为 False，不验证证书。 sseapi_ssl_validate_cert:False
   sseapi_server	RaaS 节点的 HTTP IP 地址，例如，http://example.com 或 https://example.com（如果启用了 SSL）。
   sseapi_command_age_limit	设置跳过可能失效的旧作业的期限（以秒为单位）。例如，要跳过一天前的作业，请设置为： sseapi_command_age_limit:86400 跳过的作业将继续存在于数据库中，并在 Automation Config 用户界面中显示状态 Completed。 某些环境可能需要 Salt 主节点长时间脱机，并且需要 Salt 主节点在重新联机后运行排队的任何作业。如果此情况适用于您的环境，请将期限设置为 0。
   sseapi_windows_minion_deploy_delay	设置延迟以允许所有必需的 Windows 服务变为活动状态。默认值为 180 秒。
   sseapi_linux_minion_deploy_delay	设置延迟以允许所有必需的 Linux 服务变为活动状态。默认值为 90 秒。
   sseapi_local_cache	设置某些数据在每个 Salt 主节点上本地缓存的时长。默认值为 300 秒（5 分钟）。

4. 可选：仅手动安装需要执行此步骤。要验证是否可以在连接主节点插件之前连接到 SSL，请编辑生成的 raas.conf 文件，更新以下值。如果不更新这些值，则主节点插件将使用默认生成的证书。

   值	说明
   sseapi_ssl_ca	CA 文件的路径。
   sseapi_ssl_cert	证书的路径。默认值为 /etc/pki/raas/certs/localhost.crt。
   sseapi_ssl_key	证书私钥的路径。默认值为 /etc/pki/raas/certs/localhost.key。
   id	在开头添加 #，注释掉此行。不需要此项。

5. 可选：更新与性能相关的设置。对于大型或繁忙环境，可以通过调整以下设置提高 Salt 主节点与 Automation Config 之间通信的性能。
   • 配置 eventqueue 和 rpcqueue 引擎：

     这些引擎会将与 Automation Config 的某些通信从性能关键型代码路径卸载到专用进程。当这些引擎正在等待与 Automation Config 通信时，负载会存储在 Salt 主节点的本地文件系统中，以便数据可以在 Salt 主节点重新启动后持久保留。

     要启用引擎，请取消注释 Salt 主节点插件配置文件 (raas.conf) 中的以下设置：

     engines:
       - sseapi: {}
       - eventqueue: {}
       - rpcqueue: {}
       - jobcompletion: {}
       - keyauth: {}

     要配置 eventqueue 引擎，请取消注释并更新以下设置：

     sseapi_event_queue:
       name: sseapi-events
       strategy: always
       push_interval: 5
       batch_limit: 2000
       age_limit: 86400
       size_limit: 35000000
       vacuum_interval: 86400
       vacuum_limit: 350000
       forward: []

     可以根据队列参数的协同工作方式调整这些队列参数。例如，假设 Salt 事件总线上每秒平均 400 个事件，上述设置允许在 Salt 主节点上收集约 24 小时的已排队事件流量，之后由于大小或期限限制而放弃最早的事件。

     要配置 rpcqueue 引擎，请取消注释并更新以下设置：

     sseapi_rpc_queue:
         name: sseapi-rpc
         strategy: always
         push_interval: 5
         batch_limit: 500
         age_limit: 3600
         size_limit: 360000
         vacuum_interval: 86400
         vacuum_limit: 100000

   • 启用负载缓存：

     sseapi_local_cache:
         load:3600

     注： 如果启用了 rpcqueue 引擎，还必须启用负载缓存，Salt 主节点才能正确处理作业。
   • 限制工作节点颗粒负载大小：

     sseapi_max_minion_grains_payload:2000

   • 启用跳过早于定义时间（以秒为单位）的作业。例如，使用 86400 会将其设置为跳过一天前的作业。如果设置为 0，将禁用此功能：

     sseapi_command_age_limit:0

     注：

     此功能在升级期间非常有用，可防止数据库中存储的旧命令意外运行。

   Salt 中的事件队列以及 Salt 主节点插件中的队列引擎、负载缓存、颗粒负载大小限制和命令期限限制协同工作，不仅增加了吞吐量，而且减少了在对性能最敏感的代码路径中 Salt 主节点与 Automation Config 之间的通信延迟。

6. 重新启动主服务。

   sudo systemctl restart salt-master

7. 可选：可能希望运行测试作业以确保主节点插件现在支持在主节点与 RaaS 节点之间进行通信。

   salt -v '*' test.ping

RHEL 8/9 主节点现在会显示在 主节点密钥页面中。

小心： 此时不要接受主节点密钥。

配置工作节点代理

按照以下步骤将 rhel9-master 节点上的工作节点代理配置为指向自身。

1. 通过 SSH 登录到 rhel9-master 节点，然后浏览到 /etc/salt/minion.d 目录。
2. 编辑 minion.conf 文件，并将主节点设置更改为 master:localhost。
3. 浏览到 /etc/salt/pki/minion 目录，然后删除 minion_master.pub 文件。
4. 使用 重新启动 salt-minion 服务

   systemctl restart salt-minion

5. 通过运行以下命令查看并接受 rhel9-master 上的工作节点密钥：

   salt-key
   salt-key -A

6. 在 Automation Config 中，导航到管理 > 主节点密钥，然后接受主节点密钥。

   RHEL8/9 主节点现在应显示在目标页面中。

7. 通过 SSH 登录到 RHEL7 主节点，然后删除 rhel9-master 工作节点的密钥。

迁移 Salt-Minion 系统

迁移受管系统的方法有很多种。如果您已设置某个流程，请遵循该流程。如果未设置流程，请按照以下说明将 salt-minion 从旧的 Salt 主节点迁移到新的 Salt 主节点。

注： 这些步骤不适用于多主节点系统。

1. 创建编排文件。例如，

   # Orchestration to move Minions from one master to another
   # file: /srv/salt/switch_masters/init.sls
   {% import_yaml 'switch_masters/map.yaml' as mm %}
   {% set minions = mm['minionids'] %}
   
   {% if minions %}
   {% for minion in minions %}
   move_minions_{{ minion }}:
     salt.state:
       - tgt: {{ minion }}
       - sls:
         - switch_masters.move_minions_map
   
   {% endfor %}    
   {% else %}
   no_minions:
     test.configurable_test_state:
       - name: No minions to move
       - result: True 
       - changes: False 
       - comment: No minions to move
   {% endif %}
   
   remove_minions:
     salt.runner:
       - name: manage.down
       - removekeys: True 
   
   # map file for moving minions
   # file: /srv/salt/switch_masters/map.yaml
   newsaltmaster: <new_ip_address>
   oldsaltmaster: <old_ip_address>
   minionids:
     - minion01
     - minion02
     - minion03
   state to switch minions from one master to another
   # file: /srv/salt/swith_masters/move_minions_map.sls
   {% set minion = salt['grains.get']('os') %}
   # name old master and set new master ip address
   {% import_yaml 'switch_masters/map.yaml' as mm %}
   {% set oldmaster = mm['oldsaltmaster'] %}
   {% set newmaster = mm['newsaltmaster'] %}
   
   # remove minion_master.pub key
   {% if minion == 'Windows' %}
   remove_master_key:
     file.absent:
       - name: c:\ProgramData\Salt Project\Salt\conf\pki\minion\minion_master.pub
   
   change_master_assignment:
     file.replace:
       - name: c:\ProgramData\Salt Project\Salt\conf\minion.d\minion.conf 
       - pattern: 'master: {{oldmaster}}'
       - repl: 'master: {{newmaster}}'
       - require:
         - remove_master_key
   {% else %}
   remove_master_key:
     file.absent:
       - name: /etc/salt/pki/minion/minion_master.pub
   
   # modify minion config file
   change_master_assignment:
     file.replace:
       - name: /etc/salt/minion.d/minion.conf 
       - pattern: 'master: {{oldmaster}}'
       - repl: 'master: {{newmaster}}'
       - require:
         - remove_master_key
   {% endif %}
   # restart salt-minion
   restart_salt_minion:
     service.running:
       - name: salt-minion 
       - require:
         - change_master_assignment
       - watch:
         - change_master_assignment
   

2. 创建包含以下代码的 map.yaml 文件（请参见上面的代码示例）：
   1. <旧的 salt 主节点> IP 地址/FQDN
   2. <新的 salt 主节点> IP 地址/FQDN
   3. 要移动的 Salt 工作节点 ID 的列表。
3. 创建状态文件（请参见上述代码示例）以处理迁移。例如，move_minions_map.sls。
4. 将这些文件添加到 RHEL7 Salt 主节点上的某个目录（例如，/srv/salt/switch_masters）。
5. 在 RHEL7 Salt 主节点上运行编排文件。这会导致 Salt 工作节点服务重新启动时出现一些错误，并且无法为 RHEL7 Salt 主节点恢复联机。
6. 在 Automation Config 中监控进度。接受 UI 中填充的已迁移 Salt 工作节点 ID。
7. 迁移所有系统后，针对这些系统运行 test.ping 作业，以验证所有服务是否都正常通信。

迁移现有文件

此过程完全取决于您的组织创建、存储和管理状态文件及配置文件的方式。下面概述了最常见的用例以供参考。

用例 1：Automation Config 文件服务器

在此用例中，Automation Config 文件存储在 Postgres 数据库中，并显示在 Automation Config UI 中。

在还原 Postgres 数据库期间，将恢复并迁移这些文件。您无需执行任何额外步骤来将这些文件迁移到 RHEL8/9 环境。

用例 2：Github/Gitlab 文件服务器

在此用例中，Automation Config 状态文件和配置文件存储在 Github/Gitlab/Bitbucket 或某种其他代码版本控制系统中。

由于这些文件存储在第三方工具中，因此您需要配置新的 RHEL8/9 主节点以连接到存储库系统。此配置将镜像 RHEL7 存储库配置。

用例 3：Salt 主节点的本地文件根目录

在此用例中，Automation Config 存储在 Salt 主节点上的本地文件服务器目录中。

要将这些文件迁移到 RHEL8/9 主节点，请从 RHEL7 主节点将相应的目录复制到 RHEL8/9 主节点。

1. 状态文件和 pillar 文件分别存储在 /srv/salt 和 /srv/pillar 中。
2. 使用安全复制工具（例如 wincp 或命令行）从 RHEL7 主节点将这些目录安全复制到 RHEL8/9 主节点。
3. 使用 Salt \* saltutil.refresh_pillar 刷新 pillar 日期