Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/jm1/ansible-collection-jm1-openstack
Ansible Collection for using OpenStack https://galaxy.ansible.com/jm1/openstack
https://github.com/jm1/ansible-collection-jm1-openstack
ansible ansible-collection ansible-galaxy ansible-modules ansible-roles openstack
Last synced: about 1 month ago
JSON representation
Ansible Collection for using OpenStack https://galaxy.ansible.com/jm1/openstack
- Host: GitHub
- URL: https://github.com/jm1/ansible-collection-jm1-openstack
- Owner: JM1
- License: gpl-3.0
- Created: 2020-08-05T11:26:37.000Z (over 4 years ago)
- Default Branch: master
- Last Pushed: 2024-05-30T09:49:57.000Z (8 months ago)
- Last Synced: 2024-11-08T11:12:33.579Z (3 months ago)
- Topics: ansible, ansible-collection, ansible-galaxy, ansible-modules, ansible-roles, openstack
- Language: Python
- Homepage:
- Size: 148 KB
- Stars: 0
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE.md
Awesome Lists containing this project
README
# Ansible Collection for using OpenStack
This repo hosts the Ansible collection [`jm1.openstack`](https://galaxy.ansible.com/jm1/openstack).
The collection includes a variety of Ansible content to help automate the provisioning and maintenance of OpenStack clusters.
It provides supplemental modules and roles to the [Ansible OpenStack collection][openstack-cloud]. For example,
[`jm1.openstack.image_import`](plugins/modules/image_import.py) resembles [`openstack.cloud.image`][
openstack-cloud-image] to upload images from remote uri's to the OpenStack Image Repository:
[openstack-cloud]: https://galaxy.ansible.com/openstack/cloud
[openstack-cloud-image]: https://docs.ansible.com/ansible/latest/collections/openstack/cloud/image_module.html
```yaml
- hosts: all
tasks:
- name: Install software required by jm1.openstack's roles and modules
import_role:
name: jm1.openstack.setup
- name: Download image from web and upload it to OpenStack image repository
jm1.openstack.image_import:
auth:
auth_url: https://identity.example.com
username: admin
password: passme
project_name: admin
os_identity_user_domain_name: Default
os_project_domain_name: Default
# name is derived from uri
uri: 'https://cdimage.debian.org/cdimage/openstack/archive/10.4.2-20200608/debian-10.4.2-20200608-openstack-amd64.qcow2'
checksum: 'sha256:00f76f2fd8e3d74c4f0de7cf97cb7b1706be4299ad44a452849e7993757a8549'
```
## Included content
Click on the name of a module or role to view that content's documentation:
- **Modules**:
* [image_import](plugins/modules/image_import.py)
* [floating_ip](plugins/modules/floating_ip.py)
- **Roles**:
* [cloud](roles/cloud/README.md)
* [setup](roles/setup/README.md)
## Requirements and Installation
### Installing necessary software
Content in this collection requires additional roles and collections, e.g. to collect operating system facts. You can
fetch them from Ansible Galaxy using the provided [`requirements.yml`](requirements.yml):
```sh
ansible-galaxy collection install --requirements-file requirements.yml
ansible-galaxy role install --role-file requirements.yml
# or
make install-requirements
```
Content in this collection requires additional tools and libraries, e.g. to interact with OpenStack's APIs. You can use
role [`jm1.openstack.setup`](roles/setup/README.md) to install necessary software packages:
```yaml
- hosts: all
roles:
- jm1.openstack.setup
```
Or to install these packages locally:
```sh
sudo -s
ansible-console localhost << EOF
gather_facts
include_role name=jm1.openstack.setup
EOF
```
The exact requirements for every module and role are listed in the corresponding documentation.
See the module documentations for the minimal version supported for each module.
### Installing the Collection from Ansible Galaxy
Before using the `jm1.openstack` collection, you need to install it with the Ansible Galaxy CLI:
```sh
ansible-galaxy collection install jm1.openstack
```
You can also include it in a `requirements.yml` file and install it via
`ansible-galaxy collection install -r requirements.yml`, using the format:
```yaml
---
collections:
- name: jm1.openstack
version: 2024.5.30
```
## Usage and Playbooks
You can either call modules by their Fully Qualified Collection Name (FQCN), like `jm1.openstack.volume_import`, or you
can call modules by their short name if you list the `jm1.openstack` collection in the playbook's `collections`,
like so:
```yaml
---
- name: Using jm1.openstack collection
hosts: localhost
collections:
- jm1.openstack
tasks:
- name: Satisfy software requirements
import_role:
name: setup
- name: Download image from web and upload it to OpenStack image repository
image_import:
auth:
auth_url: https://identity.example.com
username: admin
password: passme
project_name: admin
os_identity_user_domain_name: Default
os_project_domain_name: Default
# name is derived from uri
uri: 'https://cdimage.debian.org/cdimage/openstack/archive/10.4.2-20200608/debian-10.4.2-20200608-openstack-amd64.qcow2'
checksum: 'sha256:00f76f2fd8e3d74c4f0de7cf97cb7b1706be4299ad44a452849e7993757a8549'
```
For documentation on how to use individual modules and other content included in this collection, please see the links
in the 'Included content' section earlier in this README.
See [Ansible Using collections](https://docs.ansible.com/ansible/latest/user_guide/collections_using.html) for more
details.
## Contributing
There are many ways in which you can participate in the project, for example:
- Submit bugs and feature requests, and help us verify them
- Submit pull requests for new modules, roles and other content
We're following the general Ansible contributor guidelines;
see [Ansible Community Guide](https://docs.ansible.com/ansible/latest/community/index.html).
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 this repository (or a fork of it) into one of the configured [`ANSIBLE_COLLECTIONS_PATHS`](
https://docs.ansible.com/ansible/latest/reference_appendices/config.html#collections-paths) and work on it there:
1. Create a directory `ansible_collections/jm1`;
2. In there, checkout this repository (or a fork) as `openstack`;
3. Add the directory containing `ansible_collections` to your
[`ANSIBLE_COLLECTIONS_PATHS`](https://docs.ansible.com/ansible/latest/reference_appendices/config.html#collections-paths).
Helpful tools for developing collections are `ansible`, `ansible-doc`, `ansible-galaxy`, `ansible-lint`, `flake8`,
`make` and `yamllint`.
| OS | Install Instructions |
| -------------------------------------------- | ------------------------------------------------------------------- |
| Debian 10 (Buster) | Enable [Backports](https://backports.debian.org/Instructions/). `apt install ansible ansible-doc ansible-lint flake8 make yamllint` |
| Debian 11 (Bullseye) | `apt install ansible ansible-lint flake8 make yamllint` |
| Debian 12 (Bookworm) | `apt install ansible ansible-lint flake8 make yamllint` |
| Debian 13 (Trixie) | `apt install ansible ansible-lint flake8 make yamllint` |
| Fedora | `dnf install ansible python3-flake8 make yamllint` |
| Red Hat Enterprise Linux (RHEL) 7 / CentOS 7 | Enable [EPEL](https://fedoraproject.org/wiki/EPEL). `yum install ansible ansible-lint ansible-doc python-flake8 make yamllint` |
| Red Hat Enterprise Linux (RHEL) 8 / CentOS 8 | Enable [EPEL](https://fedoraproject.org/wiki/EPEL). `yum install ansible python3-flake8 make yamllint` |
| Red Hat Enterprise Linux (RHEL) 9 / CentOS 9 | Enable [EPEL](https://fedoraproject.org/wiki/EPEL). `yum install ansible python3-flake8 make yamllint` |
| Ubuntu 18.04 LTS (Bionic Beaver) | Enable [Launchpad PPA Ansible by Ansible, Inc.](https://launchpad.net/~ansible/+archive/ubuntu/ansible). `apt install ansible ansible-doc ansible-lint flake8 make yamllint` |
| Ubuntu 20.04 LTS (Focal Fossa) | Enable [Launchpad PPA Ansible by Ansible, Inc.](https://launchpad.net/~ansible/+archive/ubuntu/ansible). `apt install ansible ansible-doc ansible-lint flake8 make yamllint` |
| Ubuntu 22.04 LTS (Jammy Jellyfish) | `apt install ansible ansible-lint flake8 make yamllint` |
| Ubuntu 24.04 LTS (Noble Numbat) | `apt install ansible ansible-lint flake8 make yamllint` |
Have a look at the included [`Makefile`](Makefile) for
several frequently used commands, to e.g. build and lint a collection.
## More Information
- [Ansible Collection Overview](https://github.com/ansible-collections/overview)
- [Ansible User Guide](https://docs.ansible.com/ansible/latest/user_guide/index.html)
- [Ansible Developer Guide](https://docs.ansible.com/ansible/latest/dev_guide/index.html)
- [Ansible Community Code of Conduct](https://docs.ansible.com/ansible/latest/community/code_of_conduct.html)
## License
GNU General Public License v3.0 or later
See [LICENSE.md](LICENSE.md) to see the full text.
## Author
Jakob Meng
@jm1 ([github](https://github.com/jm1), [galaxy](https://galaxy.ansible.com/jm1), [web](http://www.jakobmeng.de))