Роль Ansible для членства в AD

Управление членством управляемого хоста в Windows AD.

• Роль Ansible для членства в AD
  • Лицензия
  • Информация об авторе
  • Требования
  • Зависимости
  • Совместимость
  • Переменные роли
  • Пример плейбука
  • Полезные команды оболочки
  • Дополнительные ресурсы документации
  • Тестирование с Molecule
  • CI/CD с Travis CI
  • Полезные ссылки

Лицензия

MIT / BSD

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

• Создатель и поддержка: Kasra Amirsarvari
• Автор сообщества Ansible Galaxy: https://galaxy.ansible.com/caseraw
• Пользователь сообщества Dockerhub: https://hub.docker.com/u/caseraw

Требования

• Убедитесь, что менеджер пакетов доступен и настроен с правильными источниками и репозиториями пакетов.
• Убедитесь, что у пользователя, выполняющего эту роль, есть привилегированные разрешения для:
  • Установки и удаления.
  • Редактирования файлов, таких как /etc/krb5.conf и /etc/sssd/sssd.conf.
  • Управления службами systemd для realmd, sssd и addjobd.
• Убедитесь, что есть сеть с контроллером домена Windows.

Зависимости

Нет.

Совместимость

Совместим со следующим списком операционных систем:

• CentOS 7
• CentOS 8
• RHEL 7.x
• RHEL 8.x

Переменные роли

Пример плейбука

---
- name: Управление членством управляемого хоста в Windows AD
  become: True
  gather_facts: True
  vars_files:
    - /path/to/vault/file.yml
  tasks:
    - import_role:
        name: ansible_role_ad_membership
      vars:
        role_ad_membership_required_packages:
          - openldap-clients
          - krb5-workstation
          - krb5-libs
          - adcli
          - realmd
          - authconfig
          - samba-client
          - samba-common
          - samba-common-tools
          - sssd
          - sssd-ad
          - sssd-krb5
          - oddjob
          - oddjob-mkhomedir
        role_ad_membership_use_global_domain_controller: False
        role_ad_membership_ad_controller_random_selection: False
        role_ad_membership_ad_controllers:
          - ad1.example.com
          - ad2.example.com
        role_ad_membership_computer_ou: OU=Servers,DC=example,DC=com
        role_ad_membership_netbios_max_length: 15
        role_ad_membership_leave_ad: False
        role_ad_membership_allowed_group_list_default:
          - Special-Group-01
          - super_special_group_01
        role_ad_membership_allowed_group_list_something:
          - Special-Group-02
          - super_special_group_02
        role_ad_membership_allowed_group_list_something_else:
          - Special-Group-03
          - super_special_group_03

...

Полезные команды оболочки

Обнаружение контроллера AD и специфики домена.

dig -t SRV _ldap._tcp.ad.example.com
dig -t SRV _ldap._tcp.dc._msdcs.ad.example.com

Дополнительные ресурсы документации

Следующие ссылки предоставляют дополнительную информацию о sssd и его использовании.

• https://access.redhat.com/documentation/en-us/red_hat_enterprise_linux/7/html/windows_integration_guide/sssd-integration-intro

Тестирование с Molecule

Эта роль тестируется локально с использованием Molecule, конфигурация находится в: molecule/default.
Тесты Molecule запускаются (с использованием docker driver) на Dockerhub images, построенных для этой цели:

• CentOS
• Fedora

Некоторые конкретные конфигурации могут потребовать полную ОС вместо минимального изображения контейнера. В этих случаях используйте molecule driver for vagrant с libvirt provider. Часть конфигурации драйвера Molecule и платформы может выглядеть примерно так:

driver:
  name: vagrant
  provider:
    name: libvirt
platforms:
  - name: ansible_role_ad_membership-ansible-molecule-centos-7
    box: centos/7
    imemory: 1024
    cpus: 1

CI/CD с Travis CI

Эта роль использует Travis CI для выполнения онлайн-тестов с использованием Molecule и отправки уведомлений для импорта роли в Ansible Galaxy, как только тесты успешно пройдены. Конфигурация Travis CI находится в корне роли Ansible .travis.yml

Полезные ссылки

• Репозиторий GitHub: https://github.com/Caseraw/ansible_role_ad_membership
• Статус сборки Travis CI: https://travis-ci.org/Caseraw/ansible_role_ad_membership
• Роль Ansible Galaxy: https://galaxy.ansible.com/caseraw/ansible_role_ad_membership