On this page
atomic_host - Manage the atomic host platform
New in version 2.2.
Synopsis
- Manage the atomic host platform.
 - Rebooting of Atomic host platform should be done outside this module.
 
Requirements
The below requirements are needed on the host that executes this module.
- atomic
 - python >= 2.6
 
Parameters
| Parameter | Choices/Defaults | Comments | 
|---|---|---|
| revision | Default: 
        "latest"
         | 
      
        
        The version number of the atomic host to be deployed. Providing  
       latest will upgrade to the latest available version.
       aliases: version  | 
     
Notes
Note
- Host should be an atomic platform (verified by existence of ‘/run/ostree-booted’ file).
 
Examples
- name: Upgrade the atomic host platform to the latest version (atomic host upgrade)
  atomic_host:
    revision: latest
- name: Deploy a specific revision as the atomic host (atomic host deploy 23.130)
  atomic_host:
    revision: 23.130
  Return Values
Common return values are documented here, the following are the fields unique to this module:
| Key | Returned | Description | 
|---|---|---|
| msg  
        string
         | 
      always | 
        
        The command standard output
         Sample:
        
       
        Already on latest
         | 
     
Status
This module is flagged as preview which means that it is not guaranteed to have a backwards compatible interface.
Maintenance
This module is flagged as community which means that it is maintained by the Ansible Community. See Module Maintenance & Support for more info.
For a list of other modules that are also maintained by the Ansible Community, see here.
Author
- Saravanan KR (@krsacme)
 
Hint
If you notice any issues in this documentation you can edit this document to improve it.
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
 https://docs.ansible.com/ansible/2.6/modules/atomic_host_module.html