Skip to content
This repository has been archived by the owner on Jul 21, 2023. It is now read-only.

Latest commit

 

History

History
59 lines (33 loc) · 3.52 KB

README.md

File metadata and controls

59 lines (33 loc) · 3.52 KB
Raw

Hosttech DNS Modules

CI Codecov

This collection and its contents are depreated! Please use the community.dns collection and its HostTech DNS modules instead!

This repository provides an Ansible collection with modules to create, modify and delete DNS records for zones hosted at the Swiss provider Hosttech using their API.

You can find documentation for this collection on my Ansible docsite.

Tested with Ansible

Tested with the current Ansible 2.9, ansible-base 2.10, ansible-core 2.11 and ansible-core 2.12 releases. Ansible versions before 2.9.10 are not supported.

External requirements

The lxml Python module is needed.

Included content

  • hosttech_dns_record module
  • hosttech_dns_record_info module

You can find documentation for this collection on my Ansible docsite.

Using this collection

See Ansible Using collections for more details.

Release notes

See here.

Running integration tests

The CI (based on GitHub Actions) runs sanity and unit tests, but not integration tests. The integration tests need access to HostTech API credentials. If you have some, copy tests/integration/integration_config.yml.template to integration_config.yml in the same directory, and insert username, key, a test zone (domain.ch) and test record (foo.domain.ch). Then run ansible-test integration. Please note that the test record will be deleted, (re-)created, and finally deleted, so do not use any record you actually need!

Releasing, Deprecation and Versioning

We release new versions once there are new features or bugfixes. Deprecations can happen, and we try to announce them a long time in advance. We currently do not plan breaking changes, so there will be no new major release anytime soon.

Contributing

Please create issues to report problems or request new features, and create PRs to fix bugs or add new features. If you want to do a refactoring PR, please create an issue first to discuss the refactoring.

Please follow the general Ansible contributor guidelines; see the Ansible Community Guide.

More information

Licensing

GNU General Public License v3.0 or later.

See COPYING to see the full text.