Documentation

PLEASE NOTE: This document applies to latest version and not to the latest stable release v2.19

Documentation for other releases can be found by using the version selector in the top right of any doc page.

chroot

Execute commands within a chroot environment.

Attributes

check_mode:
  support: none

Parameters

Parameter	Required	Type	Description
cmd		string	The command to run as a string.
argv		array	The command to run as a list of arguments.
command		string	The command executable (use with args).
args		string	Arguments for the command (if command used instead of cmd).
become		boolean	Become another user inside chroot.
become_user		string	User to become.
chdir		string	Working directory inside chroot. [default: `"/"`]
creates		string	File that if exists skips the command.
env_file		string	File to source environment from (e.g., /etc/environment).
environment		object	Environment variables to set.
executable		string	Shell to use for command execution. [default: `"/bin/sh"`]
removes		string	File that if missing skips the command.
root	true	string	Path to the chroot directory.
stdin		string	Data to pass to command stdin.
timeout		integer	Command timeout in seconds. [default: `3600`]
umask		integer	Umask for command execution.

Example

- name: Update package lists in chroot
  chroot:
    root: /mnt
    cmd: apt-get update

- name: Install packages in chroot
  chroot:
    root: /mnt
    cmd: apt-get install -y linux-image-generic zfs-initramfs
    environment:
      DEBIAN_FRONTEND: noninteractive

- name: Run script in chroot
  chroot:
    root: /mnt
    cmd: /usr/local/bin/setup-script.sh
    creates: /etc/installed-marker

- name: Run as different user
  chroot:
    root: /mnt
    cmd: whoami
    become: true
    become_user: agil