digitalocean/ansible-collection

Python

Open original ↗

Captured source

source ↗
published Jan 25, 2023seen 5dcaptured 8hhttp 200method plain

digitalocean/ansible-collection

Description: DigitalOcean Ansible Collection

Language: Python

License: GPL-3.0

Stars: 57

Forks: 16

Open issues: 19

Created: 2023-01-25T12:47:07Z

Pushed: 2026-03-13T23:43:09Z

Default branch: main

Fork: no

Archived: no

README:

DigitalOcean Collection

This repository contains the `digitalocean.cloud` Ansible Collection. This is a grounds-up rewrite of the `community.digitalocean` Ansible collection, leveraging PyDO.

DigitalOcean Collection for Ansible

![OpenSSF Best Practices](https://www.bestpractices.dev/projects/7862)

![Integration tests](https://github.com/digitalocean/ansible-collection/actions/workflows/ansible-test-integration.yml) ![Sanity tests](https://github.com/digitalocean/ansible-collection/actions/workflows/ansible-test-sanity.yml) ![Unit tests](https://github.com/digitalocean/ansible-collection/actions/workflows/ansible-test-unit.yml) ![codecov](https://codecov.io/gh/digitalocean/ansible-collection) ![Publish Collection on Galaxy](https://github.com/digitalocean/ansible-collection/actions/workflows/publish-galaxy.yml) ![Lint extra docsite docs and links](https://github.com/digitalocean/ansible-collection/actions/workflows/extra-docs-linting.yml) ![Python psf/black](https://github.com/digitalocean/ansible-collection/actions/workflows/psf-black.yml)

![Open in GitHub Codespaces](https://codespaces.new/digitalocean/ansible-collection?quickstart=1)

This collection can be used to manage infrastructure in the DigitalOcean cloud. The DigitalOcean API documentation is located here. The pydo library which this collection is based on is hosted on GitHub and PyPI.

Code of Conduct

We follow the Ansible Code of Conduct in all our interactions within this project.

If you encounter abusive behavior, please refer to the policy violations section of the Code for information on how to raise a complaint.

Communication

Join us in Libera.chat in the #ansible-digitalocean for collection development questions or DigitalOcean Community Discord in the `#ansible` channel.

Contributing to this collection

The content of this collection is made by people like you, a community of individuals collaborating on making the world better through developing automation software.

We are actively accepting new contributors.

Any kind of contribution is very welcome.

You don't know how to start? Refer to our [contribution guide](CONTRIBUTING.md)!

We use the following guidelines:

Collection maintenance

The current maintainers are listed in the [MAINTAINERS](MAINTAINERS) file. If you have questions or need help, feel free to mention them in the proposals.

To learn how to maintain / become a maintainer of this collection, refer to the [Maintainer guidelines](MAINTAINING.md).

Governance

The process of decision making in this collection is based on discussing and finding consensus among participants.

Every voice is important. If you have something on your mind, create an issue or dedicated discussion and let's discuss it!

Tested with versions

| Ansible | Python | | ------------- | ------ | | stable-2.14 | 3.9 | | stable-2.15 | 3.10 | | stable-2.16 | 3.11 | | devel | 3.11 |

External requirements

azure-core==1.26.1
boto3==1.28.53 # For the Spaces modules
pydo==0.1.7

The following should install the requirements for your account:

pip3 install --user azure-core==1.26.1 boto3==1.28.53 pydo==0.1.7

There is a [pyproject.toml](./pyproject.toml) is the root of this repository as well if you use Poetry or similar.

Included content

| Module | Description | | --------------------------------------------------- | -------------------------------------------- | | digitalocean.cloud.account_info | Get account information | | digitalocean.cloud.balance_info | Get balance information | | digitalocean.cloud.billing_history_info | Get billing history | | digitalocean.cloud.cdn_endpoints_info | Get CDN endpoints | | digitalocean.cloud.certificate | Create and delete certificates | | digitalocean.cloud.certificate_info | Get certificates | | digitalocean.cloud.container_registry_info | Get container registry | | digitalocean.cloud.database_cluster_info | Get databases | | digitalocean.cloud.domain | Create and delete domains | | digitalocean.cloud.domain_record | Create and delete domain records | | digitalocean.cloud.domain_records_info | Get domain records | | digitalocean.cloud.domains_info | Get domains | | digitalocean.cloud.droplet | Create and delete Droplets | | digitalocean.cloud.droplet_action_power | Change power states on…

Excerpt shown — open the source for the full document.