31.4. 使用 microsoft.sql.server Ansible 系统角色安装和配置带有 AD 集成的 SQL Server

流程

1. 将敏感变量存储在加密的文件中：

   1. 创建 vault ：

      $ ansible-vault create ~/vault.yml
      New Vault password: <vault_password>
      Confirm New Vault password: <vault_password>

      Copy to Clipboard Toggle word wrap

   2. 在 ansible-vault create 命令打开编辑器后，以 <key>: <value> 格式输入敏感数据：

      sa_pwd: <sa_password>
      sql_pwd: <SQL_AD_password>
      ad_admin_pwd: <AD_admin_password>

      Copy to Clipboard Toggle word wrap
   3. 保存更改，并关闭编辑器。Ansible 加密 vault 中的数据。

2. 创建一个包含以下内容的 playbook 文件，如 ~/playbook.yml ：

   ---
   - name: Installing and configuring Microsoft SQL Server
     hosts: managed-node-01.example.com
     vars_files:
       - ~/vault.yml
     tasks:
       - name: SQL Server with AD authentication
         ansible.builtin.include_role:
           name: microsoft.sql.server
         vars:
           mssql_accept_microsoft_odbc_driver_for_sql_server_eula: true
           mssql_accept_microsoft_cli_utilities_for_sql_server_eula: true
           mssql_accept_microsoft_sql_server_standard_eula: true
   
           mssql_version: 2022
           mssql_password: "{{ sa_pwd }}"
           mssql_edition: Developer
           mssql_tcp_port: 1433
           mssql_manage_firewall: true
   
           mssql_ad_configure: true
           mssql_ad_join: true
           mssql_ad_sql_user: sqluser
           mssql_ad_sql_password: "{{ sql_pwd }}"
           ad_integration_realm: ad.example.com
           ad_integration_user: Administrator
           ad_integration_password: "{{ ad_admin_pwd }}"

   Copy to Clipboard Toggle word wrap

   示例 playbook 中指定的设置包括如下：

   mssql_ad_configure: true

   启用针对 AD 的身份验证。

   mssql_ad_join: true

   使用 ad_integration RHEL 系统角色将受管节点加入到 AD。角色使用 ad_integration_realm、ad_integration_user 和 ad_integration_password 变量中的设置来加入域。

   mssql_ad_sql_user: <username>

   设置角色出于管理目的应在 AD 和 SQL Server 中创建的 AD 帐户的名称。

   ad_integration_user: <AD_user>

   设置具有特权的 AD 用户的名称，来将机器加入到域，并创建 mssql_ad_sql_user 中指定的 AD 用户。

   有关 playbook 中使用的所有变量的详情，请查看控制节点上的 /usr/share/ansible/roles/microsoft.sql-server/README.md 文件。

3. 验证 playbook 语法：

   $ ansible-playbook --ask-vault-pass --syntax-check ~/playbook.yml

   Copy to Clipboard Toggle word wrap

   请注意，这个命令只验证语法，不能防止错误的、但有效的配置。

4. 运行 playbook：

   $ ansible-playbook --ask-vault-pass ~/playbook.yml

   Copy to Clipboard Toggle word wrap

5. 授权应能够向 SQL Server 进行身份验证的 AD 用户。在 SQL Server 上，执行以下步骤：

   1. 获取 Administrator 用户的 Kerberos 票据：

      $ kinit Administrator@ad.example.com

      Copy to Clipboard Toggle word wrap

   2. 授权一个 AD 用户：

      $ /opt/mssql-tools/bin/sqlcmd -S. -Q 'CREATE LOGIN [AD\<AD_user>] FROM WINDOWS;'

      Copy to Clipboard Toggle word wrap

      对应该能够访问 SQL Server 的每个 AD 用户重复此步骤。