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

Примечание

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

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

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

Для использования в книге задач укажите: community.windows.win_pester.

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

Описание

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

Требования

Ниже приведены требования, необходимые на хосте, выполняющем этот модуль.

Pester

Параметры

Параметр	Комментарии
output_file строка	Генерирует отчёт о результатах тестирования.
output_format строка	Формат отчёта о тестировании. Этот параметр используется с параметром output_file. По умолчанию: `"NunitXML"`
path строка / обязательно	Путь к файлу теста pester или папке, где находятся тесты. Если путь указывает на папку, модуль рассмотрит все файлы ps1 как тесты Pester.
tags список / элементы=строка	Запускает только тесты в блоках Describe со значениями указанных тегов. Принимает несколько тегов, разделённых запятыми.
test_parameters словарь	Позволяет указать параметры для скрипта теста.
версия псевдонимы: minimum_version строка	Минимальная версия модуля 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 список / элементы=строка	Результаты тестов Pester. Возвращается: успех Пример: `["False"]`
pester_version строка	Версия модуля pester, найденная на удалённом хосте. Возвращается: всегда Пример: `"4.3.1"`

Авторы

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

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

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