rwreceiver

这是一个用于配置和管理 rwreceiver 服务的角色。 rwreceiver 是一个守护进程，它接收来自一个或多个 rwsender 进程传送的文件。接收到的文件将存储在一个目的目录中。请参阅 rwreceiver 文档以获取更多信息。

要求

如果使用 TLS 进行连接，必须为发送方和接收方生成并上传匹配的证书。

角色变量

可用变量如下所示，带有默认值（请参阅 defaults/main.yml）：

silk_packing_tools_loc: "/usr/local/sbin"

silk 打包工具的文件夹位置。

silk_tls_support: False

是否使用 TLS 进行连接。

rwreceiver_myname: "rwreceiver"

rwreceiver 进程的名称。可以通过不同的名称在单个机器上运行多个 rwreceiver 实例。

rwreceiver_conf_template: "rwreceiver.conf.j2"
rwreceiver_conf_file_loc: "/usr/local/etc"
rwreceiver_conf_file_path: "{{ rwreceiver_conf_file_loc }}/{{ rwreceiver_myname }}.conf"
rwreceiver_init_template: "rwreceiver.j2"
rwreceiver_init_file_path: "/etc/init.d/{{ rwreceiver_myname }}" 

使用的模板源及其目标。

当使用可选的 GnuTLS 支持并设置 silk_tls_support: True 时，必须指定 CA 文件的完整路径（TLS_CA），以及 或 程序特定的 PKCS#12 文件的完整路径（TLS_PKCS12）或 程序特定的证书（TLS_CERT）和密钥（TLS_KEY）文件的完整路径。如果 PKCS#12 文件受到密码保护，您必须在启动 rwreceiver 之前将 RWRECEIVER_TLS_PASSWORD 环境变量设置为该密码。如果未设置 RWRECEIVER_TLS_PASSWORD，它将被视为空密码；将其设置为空字符串以允许空密码。

依赖项

• cmusei.silk

示例剧本

- hosts: server
  become: true
  vars:
    data_root_dir: "/data"
    # rwreceiver 设置
    silk_tls_support: True
    rwreceiver_statedirectory: "{{ data_root_dir }}/rwreceiver"
    rwreceiver_destination_dir: "{{ rwreceiver_statedirectory }}/incoming"
    rwreceiver_create_directories: "yes"
    rwreceiver_mode: "server"
    rwreceiver_port: "3737"
    rwreceiver_sender_clients: |
        sender1
        sender2
    # rwreceiver tls 设置
    tls_ca: "testcert.pem"
    tls_key: "client-key.pem"
    tls_cert: "client-cert.pem"
    rwreceiver_tls_ca: "/etc/pki/tls/{{ tls_ca }}"
    rwreceiver_tls_key: "/etc/pki/tls/private/{{ tls_key }}"
    rwreceiver_tls_cert: "/etc/pki/tls/{{ tls_cert }}"
    rwreceiver_pid_dir: "/var/run"
  pre_tasks:
    - name: 复制 ssl 证书
      copy:
        src: "{{ item.f }}"
        dest: "{{ item.d }}"
        mode: "{{ item.m }}"
        owner: "root"
        group: "root"
      with_items:
        - f: "{{ tls_ca }}"
          d: "{{ rwreceiver_tls_ca }}"
          m: '0644'
        - f: "{{ tls_key }}"
          d: "{{ rwreceiver_tls_key }}"
          m: '0600'
        - f: "{{ tls_cert}}"
          d: "{{ rwreceiver_tls_cert }}"
          m: '0644'
  roles:
    - role: cmusei.rwreceiver
      tags: [ 'rwreceiver' ]

许可证

版权 © 2020 卡内基梅隆大学。 不提供保证。此卡内基梅隆大学和软件工程研究所的材料以“原样”基础提供。卡内基梅隆大学不对任何事宜提供任何形式的保证，包括但不限于适用于用途或商品的适销性、独占性或使用材料所获得的结果的保证。卡内基梅隆大学对剽窃、商标或版权侵犯不提供任何形式的保证。 在 MIT (SEI) 风格许可证下发布，请参阅 license.txt 或联系 permission@sei.cmu.edu 以获取完整条款。 [分发声明 A] 本材料已获得公开发布和无限分发的批准。有关非美国政府使用和分发请参见版权声明。 CERT® 注册于美国专利和商标局，由卡内基梅隆大学拥有。 本软件包括和/或使用以下受其自身许可证约束的第三方软件：

1. ansible (https://github.com/ansible/ansible/tree/devel/licenses) 版权所有 © 2019 红帽公司。
2. molecule (https://github.com/ansible-community/molecule/blob/master/LICENSE) 版权所有 © 2018 红帽公司。
3. testinfra (https://github.com/philpep/testinfra/blob/master/LICENSE) 版权所有 © 2020 Philippe Pepiot。

DM20-0505

作者信息

该角色由 Matt Heckathorn 于 2019 年创建。