You cannot select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

History

Monty Taylor 187a4bd505 Add support for network, boot_from_volume and volumes nics is a great flexible parameter, but it's wordy. Shade now supports a simple parameter too, which is just "network" and takes a name or id. Add passthrough support. In addition to supporting booting from a pre-existing volume, nova and shade both support the concept of booting from volume based on an image. Pass the parameters through. Shade supports boot-time attachment of additional volumes for OpenStack instances. Pass through the parameter so that ansible users can also take advantage of this.		10 years ago
..
README.md	Return resource objects from OpenStack modules	11 years ago
__init__.py	added __init__.py to new cloud subcategories so builds work again	11 years ago
_glance_image.py	Add OpenStack Image module	11 years ago
_keystone_user.py	@lorin stepping down as maintainer	10 years ago
_nova_compute.py	The nova_compute module create a list of un-use floating ip by value of fixed_ip.	11 years ago
_nova_keypair.py	Add OpenStack Keypair module	11 years ago
_quantum_floating_ip.py	Add OpenStack Floating IP Module	11 years ago
_quantum_floating_ip_associate.py	Add OpenStack Floating IP Module	11 years ago
_quantum_network.py	fixed quantum_ modules to work with minimum access rights if greater access rights are not needed	10 years ago
_quantum_router.py	fixed quantum_ modules to work with minimum access rights if greater access rights are not needed	10 years ago
_quantum_router_gateway.py	Deprecate older router modules.	10 years ago
_quantum_router_interface.py	fixed quantum_ modules to work with minimum access rights if greater access rights are not needed	10 years ago
_quantum_subnet.py	fixed quantum_ modules to work with minimum access rights if greater access rights are not needed	10 years ago
os_auth.py	Updating cloud modules with proper github author information	11 years ago
os_client_config.py	removed hyphens in module name in examples	10 years ago
os_floating_ip.py	Get new server object after adding floating IP	10 years ago
os_image.py	Bug fix for os_image and min_disk/min_ram	10 years ago
os_image_facts.py	doc fixes	10 years ago
os_ironic.py	minor doc fixes	11 years ago
os_ironic_node.py	minor doc fixes	11 years ago
os_keypair.py	make os_keypair return a top level 'id' key	10 years ago
os_network.py	make os_network correctly report changed status	10 years ago
os_networks_facts.py	doc fixes	10 years ago
os_nova_flavor.py	make os_flavor return a top-level 'id' key	10 years ago
os_object.py	Return resource objects from OpenStack modules	11 years ago
os_port.py	allow os_port to accept a list of security groups	10 years ago
os_router.py	make os_router return a top level 'id' key	10 years ago
os_security_group.py	allow empty description attribute for os_security_group	10 years ago
os_security_group_rule.py	checking remote_group_id while comparing os_security_group_rule	11 years ago
os_server.py	Add support for network, boot_from_volume and volumes	10 years ago
os_server_actions.py	Adding start and stop actions to os_server_actions	10 years ago
os_server_facts.py	os_server_facts returns facts about multiple servers	10 years ago
os_server_volume.py	Updating cloud modules with proper github author information	11 years ago
os_subnet.py	return information about created subnet	10 years ago
os_subnets_facts.py	fixed results docs	10 years ago
os_user.py	Clarify password requirement and add return docs.	10 years ago
os_user_group.py	Fix os_user_group module	10 years ago
os_volume.py	Return resource objects from OpenStack modules	11 years ago

README.md

OpenStack Ansible Modules

These are a set of modules for interacting with OpenStack as either an admin or an end user. If the module does not begin with os_, it's either deprecated or soon to be. This document serves as developer coding guidelines for modules intended to be here.

Naming

All modules should start with os_
If the module is one that a cloud consumer would expect to use, it should be named after the logical resource it manages. Thus, os_server not os_nova. The reasoning for this is that there are more than one resource that are managed by more than one service and which one manages it is a deployment detail. A good example of this are floating IPs, which can come from either Nova or Neutron, but which one they come from is immaterial to an end user.
If the module is one that a cloud admin would expect to use, it should be be named with the service and the resouce, such as os_keystone_domain.
If the module is one that a cloud admin and a cloud consumer could both use, the cloud consumer rules apply.

Interface

If the resource being managed has an id, it should be returned.
If the resource being managed has an associated object more complex than an id, it should also be returned.

Interoperability

It should be assumed that the cloud consumer does not know a bazillion details about the deployment choices their cloud provider made, and a best effort should be made to present one sane interface to the ansible user regardless of deployer insanity.
All modules should work appropriately against all existing known public OpenStack clouds.
It should be assumed that a user may have more than one cloud account that they wish to combine as part of a single ansible managed infrastructure.

Libraries

All modules should use openstack_full_argument_spec to pick up the standard input such as auth and ssl support.
All modules should extends_documentation_fragment: openstack to go along with openstack_full_argument_spec.
All complex cloud interaction or interoperability code should be housed in the shade library.
All OpenStack API interactions should happen via shade and not via OpenStack Client libraries. The OpenStack Client libraries do no have end users as a primary audience, they are for intra-server communication. The python-openstacksdk is the future there, and shade will migrate to it when its ready in a manner that is not noticable to ansible users.