Модуль community.windows.win_pester — запуск тестов Pester на узлах Windows

Примечание

Этот модуль входит в коллекцию community.windows (версия 3.1.0).

Возможно, эта коллекция уже установлена, если вы используете пакет ansible. Она не входит в состав ansible-core. Чтобы проверить, установлена ли она, выполните ansible-galaxy collection list.

Чтобы установить её, используйте: ansible-galaxy collection install community.windows. Для использования этого модуля необходимы дополнительные требования. Подробности см. в разделе Требования.

Чтобы использовать модуль в плейбуке, укажите: community.windows.win_pester.

Краткое описание
Требования
Параметры
Примеры
Возвращаемые значения

Краткое описание

Запускает тесты Pester на узлах Windows.
Файлы тестов должны быть доступны на удалённом узле.

Требования

Следующие требования необходимы на узле, который выполняет этот модуль.

Pester

Параметры

Параметр	Комментарии
output_file string	Создаёт отчёт о результатах тестирования.
output_format string	Формат создаваемого отчёта о результатах тестирования. Этот параметр следует использовать вместе с параметром output_file. По умолчанию: `"NunitXML"`
path string / обязательный	Путь к файлу тестов Pester или папке, в которой находятся тесты. Если указан путь к папке, модуль будет считать все файлы ps1 тестами Pester.
tags list / элементы=string	Запускает только тесты в блоках Describe с указанными значениями Tags. Принимает несколько тегов, разделённых запятыми.
test_parameters dictionary	Позволяет указать параметры для тестового скрипта.
version псевдонимы: minimum_version string	Минимальная версия модуля Pester, которая должна быть доступна на удалённом узле.

Примеры

- name: Get facts
  ansible.windows.setup:

- name: Add Pester module
  action:
    module_name: "{{ 'community.windows.win_psmodule' if ansible_powershell_version >= 5 else 'chocolatey.chocolatey.win_chocolatey' }}"
    name: Pester
    state: present

- name: Run the pester test provided in the path parameter.
  community.windows.win_pester:
    path: C:\Pester

- name: Run the pester tests only for the tags specified.
  community.windows.win_pester:
    path: C:\Pester\TestScript.tests
    tags: CI,UnitTests

# Run pesters tests files that are present in the specified folder
# ensure that the pester module version available is greater or equal to the version parameter.
- name: Run the pester test present in a folder and check the Pester module version.
  community.windows.win_pester:
    path: C:\Pester\test01.test.ps1
    version: 4.1.0

- name: Run the pester test present in a folder with given script parameters.
  community.windows.win_pester:
    path: C:\Pester\test04.test.ps1
    test_parameters:
      Process: lsass
      Service: bits

- name: Run the pester test present in a folder and generate NunitXML test result..
  community.windows.win_pester:
    path: C:\Pester\test04.test.ps1
    output_file: c:\Pester\resullt\testresult.xml

Возвращаемые значения

Общие возвращаемые значения описаны здесь. Ниже перечислены поля, уникальные для этого модуля:

Ключ	Описание
output list / элементы=string	Результаты тестов Pester. Возвращается: success Пример: `["False"]`
pester_version string	Версия модуля Pester, найденного на удалённом узле. Возвращается: always Пример: `"4.3.1"`

Авторы

Erwan Quelin (@equelin)
Prasoon Karunan V (@prasoonkarunan)

Ссылки на коллекцию

© 2012–2018 Michael DeHaan
© 2018–2025 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/projects/ansible/latest/collections/community/windows/win_pester_module.html