{"id":19270372,"url":"https://github.com/netdata/ansible","last_synced_at":"2025-06-25T04:35:32.480Z","repository":{"id":40509523,"uuid":"472380052","full_name":"netdata/ansible","owner":"netdata","description":"Official Ansible playbook for installing Netdata.","archived":false,"fork":false,"pushed_at":"2024-12-09T18:32:59.000Z","size":225,"stargazers_count":15,"open_issues_count":5,"forks_count":7,"subscribers_count":9,"default_branch":"master","last_synced_at":"2025-02-23T20:14:35.448Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Jinja","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/netdata.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2022-03-21T14:42:51.000Z","updated_at":"2025-01-16T02:32:41.000Z","dependencies_parsed_at":"2024-03-27T11:50:20.139Z","dependency_job_id":"d50d0767-804f-4d65-aa28-2dea69637930","html_url":"https://github.com/netdata/ansible","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/netdata/ansible","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/netdata%2Fansible","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/netdata%2Fansible/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/netdata%2Fansible/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/netdata%2Fansible/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/netdata","download_url":"https://codeload.github.com/netdata/ansible/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/netdata%2Fansible/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":261806990,"owners_count":23212649,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-11-09T20:24:34.189Z","updated_at":"2025-06-25T04:35:32.430Z","avatar_url":"https://github.com/netdata.png","language":"Jinja","readme":"# Example of basic Netdata agent management using Ansible\n\n## Prerequisites\n\nTested with Ansible v. 2.12.1; should work with any Ansible version since 2.9\n\nYou have to edit the inventory file `hosts` and, perhaps, `ansible.cfg`.\nIt is likely that you will also want to edit netdata agent configuration file(s).\n\nRequires jmespath installed on the host system\n\n## Tested on\n\n`Centos 7, Rocky 8, Oracle Linux 8, Fedora 35`\n\n`Debian 10, Debian 11, Ubuntu 18, Ubuntu 20, Ubuntu22`\n\n## Playbook components, a short description\n\n\u003e netdata-agent.yml:\n\nInstalls Netdata Packagecloud repository whenever possible.\nInstalls Netdata agent latest available version, trying to avoid installation from other repositories. By default, the 'edge' is used. You can change the default in group_vars/all or set it in the command line using external variable:\n\n`ansible-playbook -e \"distro=stable\" netdata-agent.yml`\n\nOr you can set in on per host basis, using inventory file or hosts_var/hostname.\n\n\u003e purge.yml:\n\nRemoves both installed repository and the package, making efforts to remove all possible remains like the log or configuration files.\n\n\u003e claim.yml:\n\nClaims the agent against Netdata Cloud\n\n## Parameters\n\nPlaybooks behavior is parameterized to some extent. You may add or change the global settings in `group_vars/all` file or on per host basis in corresponding files in `host_vars/`\nYou might also want to set some parameters in inventory file, of course. Or directly in the command line. Examples:\n\n`ansible-playbook --limit=debian10,ubuntu20 netdata-agent.yml`\n\n`ansible-playbook -u toor --limit=rocky8 -e \"distro=edge\" purge.yml`\n\n*Warning.*\n\nYou cannot just switch from stable to edge repos (nor visa versa). You have to purge existing installation first.\n\n## To do\n\n- The only agent configuration file used for the time being is `netdata.conf`. Perhaps, other configuration files handling should be added.\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnetdata%2Fansible","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fnetdata%2Fansible","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnetdata%2Fansible/lists"}