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_TLS_PASSWORD на пароль перед запуском rwreceiver. Если RWRECEIVER_TLS_PASSWORD не установлена, она рассматривается как пустой пароль; установите её в пустую строку для разрешения пустого пароля.

Зависимости

• cmusei.silk

Пример Playbook

- 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
    # настройки tls rwreceiver
    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 года Red Hat, Inc.
2. molecule (https://github.com/ansible-community/molecule/blob/master/LICENSE) Авторские права 2018 года Red Hat, Inc.
3. testinfra (https://github.com/philpep/testinfra/blob/master/LICENSE) Авторские права 2020 года Philippe Pepiot.

DM20-0505

Информация об авторе

Эта роль была создана в 2019 году Мэттом Хеккаторном.