https://github.com/ansible-community/molecule-openstack

Molecule OpenStack Driver
https://github.com/ansible-community/molecule-openstack

ansible hacktoberfest molecule molecule-driver

Last synced: about 1 month ago
JSON representation

Molecule OpenStack Driver

• Host: GitHub
• URL: https://github.com/ansible-community/molecule-openstack
• Owner: ansible-community
• License: mit
• Archived: true
• Created: 2019-10-27T15:13:15.000Z (about 5 years ago)
• Default Branch: main
• Last Pushed: 2022-12-26T19:44:06.000Z (almost 2 years ago)
• Last Synced: 2024-09-23T17:01:54.800Z (about 1 month ago)
• Topics: ansible, hacktoberfest, molecule, molecule-driver
• Language: Python
• Homepage: https://github.com/ansible-community/molecule-plugins/discussions
• Size: 62.5 KB
• Stars: 15
• Watchers: 20
• Forks: 12
• Open Issues: 5
• Metadata Files:
  • Readme: README.rst
  • License: LICENSE

Awesome Lists containing this project

README

        
*************************

Molecule OpenStack Plugin

*************************

.. image:: https://badge.fury.io/py/molecule-openstack.svg

   :target: https://badge.fury.io/py/molecule-openstack

   :alt: PyPI Package

.. image:: https://img.shields.io/badge/code%20style-black-000000.svg

   :target: https://github.com/python/black

   :alt: Python Black Code Style

.. image:: https://img.shields.io/badge/Code%20of%20Conduct-Ansible-silver.svg

   :target: https://docs.ansible.com/ansible/latest/community/code_of_conduct.html

   :alt: Ansible Code of Conduct

.. image:: https://img.shields.io/badge/Mailing%20lists-Ansible-orange.svg

   :target: https://docs.ansible.com/ansible/latest/community/communication.html#mailing-list-information

   :alt: Ansible mailing lists

.. image:: https://img.shields.io/badge/license-MIT-brightgreen.svg

   :target: LICENSE

   :alt: Repository License

Molecule OpenStack is designed to allow use of OpenStack Clouds for

provisioning test resources.

Please note that this driver is currently in its early stage of development.

.. _installation-and-usage:

Installation and Usage

======================

Install molecule-openstack and pre-requisites:

.. code-block::

   pip install molecule-openstack ansible openstacksdk

Create a new role with molecule using the openstack driver:

.. code-block::

   molecule init role  -d openstack

Configure ``/molecule/default/molecule.yaml`` with required

parameters based on your openstack cloud. A simple config is:

.. code-block:: yaml

   dependency:

      name: galaxy

   driver:

      name: openstack

   platforms:

   - name: molecule-foo

      image: "ubuntu"

      flavor: "m1.medium"

      network: "private"

      fip_pool: "public"

      ssh_user: "ubuntu"

   provisioner:

      name: ansible

   verifier:

      name: ansible

Argument ``fip_pool`` in only required when network is not an external

network. Instead of configuring

``/molecule/default/molecule.yaml`` the following environment

variables can be exported:

.. code-block::

   $ export MOLECULE_OPENSTACK_IMAGE=ubuntu

   $ export MOLECULE_OPENSTACK_FLAVOR=m1.medium

   $ export MOLECULE_OPENSTACK_NETWORK=private

   $ export MOLECULE_OPENSTACK_FIP_POOL=public

   $ export MOLECULE_OPENSTACK_SSH_USER=ubuntu

After this molecule can be run from the base-dir of the role:

.. code-block::

   source ~/.openrc

   molecule test

.. _functional-tests:

Functional Tests

================

Functional tests can be run with tox but require access to an openstack

cluster. They are not part of `ci` yet. To run them locally:

.. code-block::

   $ export MOLECULE_OPENSTACK_IMAGE=

   $ export MOLECULE_OPENSTACK_FLAVOR=

   $ export MOLECULE_OPENSTACK_NETWORK=

   $ export MOLECULE_OPENSTACK_FIP_POOL=

   $ export MOLECULE_OPENSTACK_SSH_USER=

   $ source openstack_openrc.sh

   $ tox -e py38-functional   # or 39,310

.. _get-involved:

Get Involved

============

* Join us in the ``#ansible-devtools`` channel on `Libera`_.

* Join the discussion in `molecule-users Forum`_.

* Join the community working group by checking the `wiki`_.

* Want to know about releases, subscribe to `ansible-announce list`_.

* For the full list of Ansible email Lists, IRC channels see the

  `communication page`_.

.. _`Libera`: https://web.libera.chat/?channel=#ansible-devtools

.. _`molecule-users Forum`: https://groups.google.com/forum/#!forum/molecule-users

.. _`wiki`: https://github.com/ansible/community/wiki/Molecule

.. _`ansible-announce list`: https://groups.google.com/group/ansible-announce

.. _`communication page`: https://docs.ansible.com/ansible/latest/community/communication.html

.. _license:

License

=======

The `MIT`_ License.

.. _`MIT`: https://github.com/ansible/molecule/blob/master/LICENSE

The logo is licensed under the `Creative Commons NoDerivatives 4.0 License`_.

If you have some other use in mind, contact us.

.. _`Creative Commons NoDerivatives 4.0 License`: https://creativecommons.org/licenses/by-nd/4.0/