community.general.doas become – Do As user

Note

This become plugin is part of the community.general collection (version 9.4.0).

It is not included in ansible-core. To check whether it is installed, run ansible-galaxy collection list.

To install it, use: ansible-galaxy collection install community.general.

To use it in a playbook, specify: community.general.doas.

Synopsis

  • This become plugins allows your remote/login user to execute commands as another user via the doas utility.

Parameters

Parameter

Comments

become_exe

string

Doas executable.

Default: "doas"

Configuration:

  • INI entries:

    [privilege_escalation]
    become_exe = doas
    
    [doas_become_plugin]
    executable = doas
    
  • Environment variable: ANSIBLE_BECOME_EXE

  • Environment variable: ANSIBLE_DOAS_EXE

  • Variable: ansible_become_exe

  • Variable: ansible_doas_exe

become_flags

string

Options to pass to doas.

Default: ""

Configuration:

  • INI entries:

    [privilege_escalation]
    become_flags = ""
    
    [doas_become_plugin]
    flags = ""
    
  • Environment variable: ANSIBLE_BECOME_FLAGS

  • Environment variable: ANSIBLE_DOAS_FLAGS

  • Variable: ansible_become_flags

  • Variable: ansible_doas_flags

become_pass

string

Password for doas prompt.

Configuration:

  • INI entry:

    [doas_become_plugin]
    password = VALUE
    
  • Environment variable: ANSIBLE_BECOME_PASS

  • Environment variable: ANSIBLE_DOAS_PASS

  • Variable: ansible_become_password

  • Variable: ansible_become_pass

  • Variable: ansible_doas_pass

become_user

string

User you ‘become’ to execute the task.

Configuration:

  • INI entries:

    [privilege_escalation]
    become_user = VALUE
    
    [doas_become_plugin]
    user = VALUE
    
  • Environment variable: ANSIBLE_BECOME_USER

  • Environment variable: ANSIBLE_DOAS_USER

  • Variable: ansible_become_user

  • Variable: ansible_doas_user

prompt_l10n

list / elements=string

List of localized strings to match for prompt detection.

If empty we will use the built in one.

Default: []

Configuration:

  • INI entry:

    [doas_become_plugin]
    localized_prompts =
    
  • Environment variable: ANSIBLE_DOAS_PROMPT_L10N

  • Variable: ansible_doas_prompt_l10n

Authors

  • Ansible Core Team

Hint

Configuration entries for each entry type have a low to high priority order. For example, a variable that is lower in the list will override a variable that is higher up.