Mirrors/ansible-collection-hetzner-hcloud
2
0
Fork 0
mirror of https://github.com/ansible-collections/hetzner.hcloud synced 2024-11-10 06:34:13 +00:00
Code Issues Projects Releases Packages Wiki Activity
No description
134 commits 9 branches 47 tags 2.9 MiB
Python 97.7%
Shell 2.1%
Makefile 0.2%
Find a file
Julian Tölle 23c2d7d228
ci: ubuntu-18.04 is deprecated/EOL (#224) 
Update all references to ubuntu-18.04 (and 20.04) to 22.04, as ubuntu
18.04 is EOL and deprecated in Hetzner Cloud. This causes a CI failure
in the main branch:

https://dev.azure.com/ansible/hetzner.hcloud/_build/results?buildId=80941&view=logs&j=fdb818b8-39d8-529a-d9da-324e304604bc&t=2d52cce2-88ce-5057-da88-145e92cee00f&l=1094
2023-06-20 11:38:51 +02:00
.azure-pipelines ci: add tests for ansible 2.15 (#213) 2023-05-12 13:30:30 +02:00
.github/workflows Antisibul (#151) 2022-09-14 10:15:22 +02:00
changelogs feat: Server Type Deprecation (#222) 2023-06-20 11:38:38 +02:00
meta chore: remove Ansible 2.11 support (#191) 2023-02-08 10:07:27 +01:00
plugins ci: ubuntu-18.04 is deprecated/EOL (#224) 2023-06-20 11:38:51 +02:00
tests ci: ubuntu-18.04 is deprecated/EOL (#224) 2023-06-20 11:38:51 +02:00
.gitignore Implement Firewall Support (#63) 2021-03-11 11:07:41 +01:00
.gitlab-ci.yml ci: add tests for ansible 2.15 (#213) 2023-05-12 13:30:30 +02:00
CHANGELOG.rst chore: prepare v1.12.0 (#216) 2023-05-16 13:16:14 +02:00
COPYING Initial commit 2020-03-09 13:36:01 +00:00
galaxy.yml chore: prepare v1.12.0 (#216) 2023-05-16 13:16:14 +02:00
README.md Prepare Release 1.7.0 2022-06-09 14:51:49 +02:00

README.md

Build Status Codecov

Ansible Collection: hetzner.hcloud

Ansible Hetzner Cloud Collection for controlling your Hetzner Cloud Resources.

Release notes

See here.

Documentation

The documentation for all modules are available through ansible-doc.

Sample: ansible-doc hetzner.hcloud.hcloud_server shows the documentation for the hcloud_server module.

For all modules that were part of Ansible directly (before Ansible 2.11) we also have the documentation published in the Ansible documentation: https://docs.ansible.com/ansible/latest/collections/hetzner/hcloud/

Development

Requirements

You should place the collection (clone the repository) into the Ansible collection path. Normally this is ~/.ansible/collections/ansible_collections/<namespace>/<collection, so for our collection it would be: ~/.ansible/collections/ansible_collections/hetzner/hcloud.

git clone git@github.com:ansible-collections/hetzner.hcloud.git ~/.ansible/collections/ansible_collections/hetzner/hcloud

After this you just need ansible installed.

Testing

Testing is done via ansible-test. Make sure to have a cloud-config-hcloud.ini file in tests/integration which contains the hcloud API token:

[default]
hcloud_api_token=<token>

After this you should be able to use ansible-test integration to perform the integration tests for a specific module. Sample:

ansible-test integration --color --local  -vvv hcloud_server // Executed all integration tests for hcloud_server module

Releasing a new version

Generating changelog from fragments

  1. Check if the changelog fragments are available (there should be files in changelogs/fragments)
  2. Run antsibull-changelog release --version <version>, it should remove all fragments and change the changelogs/changlog.yaml and CHANGELOG.rst
  3. Push the changes to the main branch
  4. Tag the release through the Github UI, after this the Github Actions will run and publish the collection to Ansible Galaxy