Модуль community.sap_libs.sapcar_extract — управление архивами SAP SAPCAR

Примечание

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

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

Чтобы установить её, используйте: ansible-galaxy collection install community.sap_libs.

Чтобы использовать её в плейбуке, укажите: community.sap_libs.sapcar_extract.

Добавлено в community.sap_libs 1.0.0

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

Описание

Поддерживает распаковку файлов sar/car с помощью бинарного файла SAPCAR от SAP и передачу полученной информации обратно в Ansible.

Параметры

Параметр	Комментарии
binary_path path	Путь к бинарному файлу SAPCAR, например, `/home/dummy/sapcar` или `https://myserver/SAPCAR`. Если этот параметр не указан, модуль выполнит поиск в `PATH`.
dest path	Путь к папке назначения, в которую SAPCAR распаковывает файл SAR. Отсутствующие папки будут созданы. Если этот параметр не указан, файл будет распакован в ту же папку, что и файл SAR.
manifest string	Имя манифеста. По умолчанию: `"SIGNATURE.SMF"`
overwrite boolean	Если `true`, существующие файлы будут перезаписаны при распаковке. Используйте этот параметр с осторожностью! Если `false`, модуль проверяет, есть ли ожидаемые имена файлов в папке назначения, и распаковывает файлы, только если они не найдены. Файлы не удаляются, но перезаписываются, если они уже есть в папке назначения. Варианты: `false` ← (по умолчанию) `true`
path path / обязательный	Путь к файлу SAR/CAR.
remove boolean	Если `true`, файл SAR/CAR будет удалён. Используйте этот параметр с осторожностью! Варианты: `false` ← (по умолчанию) `true`
security_library path	Путь к библиотеке безопасности, например, `/usr/sap/hostctrl/exe/libsapcrytp.so`, для операций с подписями.
signature boolean	Если `true`, подпись будет извлечена. Варианты: `false` ← (по умолчанию) `true`

Примечания

Примечание

Всегда возвращает changed=true в check_mode.

Примеры

- name: Extract SAR file
  community.sap_libs.sapcar_extract:
    path: "~/source/hana.sar"

- name: Extract SAR file with destination
  community.sap_libs.sapcar_extract:
    path: "~/source/hana.sar"
    dest: "~/test/"

- name: Extract SAR file with destination and download from webserver can be a fileshare as well
  community.sap_libs.sapcar_extract:
    path: "~/source/hana.sar"
    dest: "~/dest/"
    binary_path: "https://myserver/SAPCAR"

- name: Extract SAR file and delete SAR after extract
  community.sap_libs.sapcar_extract:
    path: "~/source/hana.sar"
    remove: true

- name: Extract SAR file with manifest
  community.sap_libs.sapcar_extract:
    path: "~/source/hana.sar"
    signature: true

- name: Extract SAR file with manifest and rename it
  community.sap_libs.sapcar_extract:
    path: "~/source/hana.sar"
    manifest: "MyNewSignature.SMF"
    signature: true

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

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

Ключ	Описание
changed boolean	Указывает, вносил ли модуль изменения. Возвращается: всегда Пример: `true`
command string	Полная выполненная команда SAPCAR. Возвращается: всегда Пример: `"/tmp/sapcar -xvf /tmp/hana.sar -R /tmp/test2"`
msg string	Сообщение о состоянии операции распаковки. Возвращается: всегда Пример: `"Files extracted to /tmp/test2 (overwrite mode enabled)"`
stderr string	Поток стандартных ошибок команды SAPCAR. Возвращается: всегда Пример: `""`
stdout string	Поток стандартного вывода команды SAPCAR. Возвращается: всегда Пример: `"SAPCAR: processing archive /tmp/hana.sar (version 2.01)\\nfile1\\nfile2"`

Авторы

Rainer Leber (@RainerLeber)

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

© 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/sap_libs/sapcar_extract_module.html