On this page
community.general.lxd – Run tasks in lxc containers via lxc CLI
Note
This plugin is part of the community.general collection (version 3.8.1).
You might already have this collection installed if you are using the ansible package. 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.lxd.
Synopsis
- Run commands or put/fetch files to an existing lxc container using lxc CLI
 
Parameters
| Parameter | Choices/Defaults | Configuration | Comments | 
|---|---|---|---|
| executable
        
        string
         | 
      Default: 
        "/bin/sh"
         | 
      
        
        var: ansible_executable
        
       
        var: ansible_lxd_executable
         | 
      
        
        shell to use for execution inside container
         | 
     
| project
        
        string
        
       
        added in 2.0.0 of community.general
         | 
      
        
        var: ansible_lxd_project
         | 
      
        
        Name of the LXD project to use.
         | 
     |
| remote
        
        string
        
       
        added in 2.0.0 of community.general
         | 
      Default: 
        "local"
         | 
      
        
        var: ansible_lxd_remote
         | 
      
        
        Name of the LXD remote to use.
         | 
     
| remote_addr
        
        string
         | 
      Default: 
        "inventory_hostname"
         | 
      
        
        var: ansible_host
        
       
        var: ansible_lxd_host
         | 
      
        
        Container identifier.
         | 
     
Authors
- Matt Clay (@mattclay) <matt@mystile.com>
 
© 2012–2018 Michael DeHaan
© 2018–2021 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
 https://docs.ansible.com/ansible/latest/collections/community/general/lxd_connection.html