community.hrobot
community.hrobot copied to clipboard
Hetzner Robot Collection
Community Hetzner Robot Collection
This repository contains the community.hrobot
Ansible Collection. The collection includes modules to work with Hetzner's Robot.
You can find documentation for the modules and plugins in this collection here.
Please note that this collection does not support Windows targets.
Tested with Ansible
Tested with the current ansible-core 2.14, ansible-core 2.15, ansible-core 2.16, and ansible-core 2.17 releases and the current development version of ansible-core. Ansible versions before 2.9.10 are not supported.
External requirements
A Hetzner Robot account.
Collection Documentation
Browsing the latest collection documentation will show docs for the latest version released in the Ansible package, not the latest version of the collection released on Galaxy.
Browsing the devel collection documentation shows docs for the latest version released on Galaxy.
We also separately publish latest commit collection documentation which shows docs for the latest commit in the main
branch.
If you use the Ansible package and do not update collections independently, use latest. If you install or update this collection directly from Galaxy, use devel. If you are looking to contribute, use latest commit.
Included content
-
community.hrobot.failover_ip
module -
community.hrobot.failover_ip_info
module -
community.hrobot.firewall
module -
community.hrobot.firewall_info
module -
community.hrobot.robot
inventory plugin
You can find documentation for the modules and plugins in this collection here.
Using this collection
Before using the General community collection, you need to install the collection with the ansible-galaxy
CLI:
ansible-galaxy collection install community.hrobot
You can also include it in a requirements.yml
file and install it via ansible-galaxy collection install -r requirements.yml
using the format:
collections:
- name: community.hrobot
See Ansible Using collections for more details.
Contributing to this collection
If you want to develop new content for this collection or improve what is already here, the easiest way to work on the collection is to clone it into one of the configured COLLECTIONS_PATH
, and work on it there.
You can find more information in the developer guide for collections, and in the Ansible Community Guide.
Release notes
See the changelog.
More information
- Ansible Collection overview
- Ansible User guide
- Ansible Developer guide
- Ansible Collections Checklist
- Ansible Community code of conduct
- The Bullhorn (the Ansible Contributor newsletter)
- Changes impacting Contributors
Licensing
This collection is primarily licensed and distributed as a whole under the GNU General Public License v3.0 or later.
See LICENSES/GPL-3.0-or-later.txt for the full text.
Parts of the collection are licensed under the BSD 2-Clause license.
All files have a machine readable SDPX-License-Identifier:
comment denoting its respective license(s) or an equivalent entry in an accompanying .license
file. Only changelog fragments (which will not be part of a release) are covered by a blanket statement in .reuse/dep5
. This conforms to the REUSE specification.