Integration · Deploys and install
Install the Opservo agent with Ansible
Install the Opservo agent on every Linux host with the Ansible Galaxy role opservo.opservo_agent: idempotent, uses the signed installer, never logs keys.
In short
The Ansible Galaxy role opservo.opservo_agent installs the Opservo agent on every Linux host in your inventory with the official installer, so the binary is checked against Opservo’s signed manifest exactly as in a manual install. The role is idempotent, keeps your enrollment key out of logs, and hosts appear in your workspace within a minute.
What you get
One playbook run puts the whole fleet under monitoring.
- ansible-galaxy role install opservo.opservo_agent.
- Idempotent: hosts that already have the agent are only checked to be enabled and running.
- The installer task runs with no_log, so the key never appears in output.
- Works on systemd hosts: Ubuntu, Debian, RHEL, Rocky, Alma and Amazon Linux, with Ansible 2.14 or newer.
How to set it up
Create a fleet key in Opservo, keep it in Ansible Vault, and run the role.
- In Opservo, open Add server → Auto Scaling / golden AMI → Create fleet key. A fleet key is multi-use and revocable.
- Store it with ansible-vault encrypt_string as vault_opservo_enroll_key.
- Add the role to a play with become: true and opservo_agent_enroll_key set from the vault, then run the playbook.
Good to know
- The role does not switch on remote actions. Every server stays read-only until an owner or admin turns actions on for it in the dashboard.
- The agent updates itself from signed releases, so you do not need to re-run the role to upgrade.
Ansible and Opservo, answered
Is there an Ansible role for Opservo?+
Yes: opservo.opservo_agent on Ansible Galaxy. It installs the agent with the official signed installer and is safe to run repeatedly.
Which enrollment key should I use with Ansible?+
A fleet key (fleet_…), created under Add server → Auto Scaling / golden AMI. It enrolls many hosts and can be revoked; a single-use token enrolls only one.
Read next
Free for 2 servers, no card. Install the agent in about 30 seconds, then connect Ansible.