# Удаление хостов из FreeIPA


## Описание и ограничения

Речь ***исключительно*** о записях хостов во `FreeIPA`, данный плейбук может
быть использован для удаления записей о как существующих (активных) хостах,
так и несуществующих (хосты выключены, ВМ уже удалены или даже никогда не
существовали).

Для удаления конфигурации `FreeIPA` на самих хостах следует использовать
другой механизм.

Есть два плейбука:

- `playbook/maintenance/freeipa/delete_hosts_groups_BETA.yml` ---
  универсальный, позволяет удалять от одного хоста до целых групп из Ansible
  inventory.

- `vim playbook/maintenance/freeipa/delete_host_one_BETA.yml` --- удаляет один
  хост.


## Порядок использования:

1.  До запуска плейбука поменять значения переменных `inv_ipaadmin_principal`
    и `inv_ipaadmin_password` в файле:

    ```bash   
    vim inv/prеprod/group_vars/FreeIPA_Controller.yml
    ```

    Пароль рекомендуется шифровать с помощью {doc}`/ansible/vault`

2.  Ознакомиться с комментариями по использованию и внести список хостов на
    удаление в файл плейбука:

    ```bash
    vim playbook/maintenance/freeipa/delete_hosts_groups_BETA.yml
    ```

3.  Выполнить плейбук:

    ```bash
    ansible-playbook -i inv/preprod --vault-id askme@prompt \
        playbook/maintenance/freeipa/delete_hosts_groups_BETA.yml
    ```