77 lines
2.4 KiB
Python
77 lines
2.4 KiB
Python
# Copyright (c) 2017 Ansible Project
|
|
# GNU General Public License v3.0+ (see COPYING or https://www.gnu.org/licenses/gpl-3.0.txt)
|
|
from __future__ import (absolute_import, division, print_function)
|
|
__metaclass__ = type
|
|
|
|
|
|
class ModuleDocFragment(object):
|
|
|
|
# common shelldocumentation fragment
|
|
DOCUMENTATION = """
|
|
options:
|
|
remote_tmp:
|
|
description:
|
|
- Temporary directory to use on targets when executing tasks.
|
|
default: '~/.ansible/tmp'
|
|
env: [{name: ANSIBLE_REMOTE_TEMP}, {name: ANSIBLE_REMOTE_TMP}]
|
|
ini:
|
|
- section: defaults
|
|
key: remote_tmp
|
|
vars:
|
|
- name: ansible_remote_tmp
|
|
system_tmpdirs:
|
|
description:
|
|
- "List of valid system temporary directories for Ansible to choose when it cannot use
|
|
``remote_tmp``, normally due to permission issues. These must be world readable, writable,
|
|
and executable."
|
|
default: [ /var/tmp, /tmp ]
|
|
type: list
|
|
env: [{name: ANSIBLE_SYSTEM_TMPDIRS}]
|
|
ini:
|
|
- section: defaults
|
|
key: system_tmpdirs
|
|
vars:
|
|
- name: ansible_system_tmpdirs
|
|
async_dir:
|
|
description:
|
|
- Directory in which ansible will keep async job information
|
|
default: '~/.ansible_async'
|
|
env: [{name: ANSIBLE_ASYNC_DIR}]
|
|
ini:
|
|
- section: defaults
|
|
key: async_dir
|
|
vars:
|
|
- name: ansible_async_dir
|
|
environment:
|
|
type: dict
|
|
default: {}
|
|
description:
|
|
- dictionary of environment variables and their values to use when executing commands.
|
|
admin_users:
|
|
type: list
|
|
default: ['root', 'toor']
|
|
description:
|
|
- list of users to be expected to have admin privileges. This is used by the controller to
|
|
determine how to share temporary files between the remote user and the become user.
|
|
env:
|
|
- name: ANSIBLE_ADMIN_USERS
|
|
ini:
|
|
- section: defaults
|
|
key: admin_users
|
|
vars:
|
|
- name: ansible_admin_users
|
|
world_readable_temp:
|
|
version_added: '2.10'
|
|
default: False
|
|
description:
|
|
- This makes the temporary files created on the machine world-readable and will issue a warning instead of failing the task.
|
|
- It is useful when becoming an unprivileged user.
|
|
env:
|
|
- name: ANSIBLE_SHELL_ALLOW_WORLD_READABLE_TEMP
|
|
vars:
|
|
- name: ansible_shell_allow_world_readable_temp
|
|
ini:
|
|
- {key: allow_world_readable_tmpfiles, section: defaults}
|
|
type: boolean
|
|
"""
|