mirror of
https://opendev.org/openstack/ansible-collections-openstack.git
synced 2026-05-06 21:33:07 +00:00
Moves image_info from cloud to proxy object
This makes image_info compatible with new sdk version - This patch changes get_image (which is a cloud object method) to image.get_image (proxy object method) - image.images accepts **query which is a dict object. So this patch changes the args passed to a dict. If properties is not specified it passes an empty dict. - updates the documentation to reflect the actual returned parameters - adds a ci test to list all images without specifying image name or property and assert no field is missing - changes openstack_image to image in ansible return value Change-Id: Ibf934568f069c305747fc24fbb22ce3fc095286c
This commit is contained in:
anbanerj
Jakob Meng
@@ -4,6 +4,7 @@
|
||||
# GNU General Public License v3.0+ (see COPYING or https://www.gnu.org/licenses/gpl-3.0.txt)
|
||||
|
||||
DOCUMENTATION = '''
|
||||
---
|
||||
module: image_info
|
||||
short_description: Retrieve information about an image within OpenStack.
|
||||
author: OpenStack Ansible SIG
|
||||
@@ -17,11 +18,12 @@ options:
|
||||
- Name or ID of the image
|
||||
required: false
|
||||
type: str
|
||||
properties:
|
||||
filters:
|
||||
description:
|
||||
- Dict of properties of the images used for query
|
||||
type: dict
|
||||
required: false
|
||||
aliases: ['properties']
|
||||
requirements:
|
||||
- "python >= 3.6"
|
||||
- "openstacksdk"
|
||||
@@ -43,7 +45,7 @@ EXAMPLES = '''
|
||||
|
||||
- name: Show openstack information
|
||||
debug:
|
||||
msg: "{{ result.openstack_image }}"
|
||||
msg: "{{ result.image }}"
|
||||
|
||||
# Show all available Openstack images
|
||||
- name: Retrieve all available Openstack images
|
||||
@@ -52,22 +54,22 @@ EXAMPLES = '''
|
||||
|
||||
- name: Show images
|
||||
debug:
|
||||
msg: "{{ result.openstack_image }}"
|
||||
msg: "{{ result.image }}"
|
||||
|
||||
# Show images matching requested properties
|
||||
- name: Retrieve images having properties with desired values
|
||||
openstack.cloud.image_facts:
|
||||
properties:
|
||||
filters:
|
||||
some_property: some_value
|
||||
OtherProp: OtherVal
|
||||
|
||||
- name: Show images
|
||||
debug:
|
||||
msg: "{{ result.openstack_image }}"
|
||||
msg: "{{ result.image }}"
|
||||
'''
|
||||
|
||||
RETURN = '''
|
||||
openstack_image:
|
||||
images:
|
||||
description: has all the openstack information about the image
|
||||
returned: always, but can be null
|
||||
type: complex
|
||||
@@ -84,6 +86,12 @@ openstack_image:
|
||||
description: Image status.
|
||||
returned: success
|
||||
type: str
|
||||
architecture:
|
||||
description: >
|
||||
The CPU architecture that must be supported by
|
||||
the hypervisor.
|
||||
returned: success
|
||||
type: str
|
||||
created_at:
|
||||
description: Image created at timestamp.
|
||||
returned: success
|
||||
@@ -92,6 +100,10 @@ openstack_image:
|
||||
description: Container format of the image.
|
||||
returned: success
|
||||
type: str
|
||||
direct_url:
|
||||
description: URL to access the image file kept in external store.
|
||||
returned: success
|
||||
type: str
|
||||
min_ram:
|
||||
description: Min amount of RAM required for this image.
|
||||
returned: success
|
||||
@@ -100,11 +112,233 @@ openstack_image:
|
||||
description: Disk format of the image.
|
||||
returned: success
|
||||
type: str
|
||||
file:
|
||||
description: The URL for the virtual machine image file.
|
||||
returned: success
|
||||
type: str
|
||||
has_auto_disk_config:
|
||||
description: >
|
||||
If root partition on disk is automatically resized
|
||||
before the instance boots.
|
||||
returned: success
|
||||
type: bool
|
||||
hash_algo:
|
||||
description: >
|
||||
The algorithm used to compute a secure hash of the
|
||||
image data.
|
||||
returned: success
|
||||
type: str
|
||||
hash_value:
|
||||
description: >
|
||||
The hexdigest of the secure hash of the image data
|
||||
computed using the algorithm whose name is the value of the os_hash_algo property.
|
||||
returned: success
|
||||
type: str
|
||||
hw_cpu_cores:
|
||||
description: >
|
||||
Used to pin the virtual CPUs (vCPUs) of instances to
|
||||
the host's physical CPU cores (pCPUs).
|
||||
returned: success
|
||||
type: str
|
||||
hw_cpu_policy:
|
||||
description: The hexdigest of the secure hash of the image data.
|
||||
returned: success
|
||||
type: str
|
||||
hw_cpu_sockets:
|
||||
description: Preferred number of sockets to expose to the guest.
|
||||
returned: success
|
||||
type: str
|
||||
hw_cpu_thread_policy:
|
||||
description: >
|
||||
Defines how hardware CPU threads in a simultaneous
|
||||
multithreading-based (SMT) architecture be used.
|
||||
returned: success
|
||||
type: str
|
||||
hw_cpu_threads:
|
||||
description: >
|
||||
The preferred number of threads to expose to the guest.
|
||||
returned: success
|
||||
type: str
|
||||
hw_disk_bus:
|
||||
description: >
|
||||
Specifies the type of disk controller to attach disk
|
||||
devices to.
|
||||
returned: success
|
||||
type: str
|
||||
hw_machine_type:
|
||||
description: >
|
||||
Enables booting an ARM system using the
|
||||
specified machine type.
|
||||
returned: success
|
||||
type: str
|
||||
hw_qemu_guest_agent:
|
||||
description: >
|
||||
A string boolean, which if "true", QEMU guest agent
|
||||
will be exposed to the instance.
|
||||
returned: success
|
||||
type: str
|
||||
hw_rng_model:
|
||||
description: Adds a random-number generator device to the image's instances.
|
||||
returned: success
|
||||
type: str
|
||||
hw_scsi_model:
|
||||
description: >
|
||||
Enables the use of VirtIO SCSI (virtio-scsi) to
|
||||
provide block device access for compute instances.
|
||||
returned: success
|
||||
type: str
|
||||
hw_video_model:
|
||||
description: The video image driver used.
|
||||
returned: success
|
||||
type: str
|
||||
hw_video_ram:
|
||||
description: Maximum RAM for the video image.
|
||||
returned: success
|
||||
type: str
|
||||
hw_vif_model:
|
||||
description: Specifies the model of virtual network interface device to use.
|
||||
returned: success
|
||||
type: str
|
||||
hw_watchdog_action:
|
||||
description: >
|
||||
Enables a virtual hardware watchdog device that
|
||||
carries out the specified action if the server hangs.
|
||||
returned: success
|
||||
type: str
|
||||
hypervisor_type:
|
||||
description: The hypervisor type.
|
||||
returned: success
|
||||
type: str
|
||||
instance_type_rxtx_factor:
|
||||
description: >
|
||||
Optional property allows created servers to have a
|
||||
different bandwidth cap than that defined in the network they are attached to.
|
||||
returned: success
|
||||
type: str
|
||||
instance_uuid:
|
||||
description: >
|
||||
For snapshot images, this is the UUID of the server
|
||||
used to create this image.
|
||||
returned: success
|
||||
type: str
|
||||
is_hidden:
|
||||
description: Controls whether an image is displayed in the default image-list response
|
||||
returned: success
|
||||
type: bool
|
||||
is_hw_boot_menu_enabled:
|
||||
description: Enables the BIOS bootmenu.
|
||||
returned: success
|
||||
type: bool
|
||||
is_hw_vif_multiqueue_enabled:
|
||||
description: >
|
||||
Enables the virtio-net multiqueue
|
||||
feature.
|
||||
returned: success
|
||||
type: bool
|
||||
kernel_id:
|
||||
description: >
|
||||
The ID of an image stored in the Image service that
|
||||
should be used as the kernel when booting an AMI-style image.
|
||||
returned: success
|
||||
type: str
|
||||
locations:
|
||||
description: A list of URLs to access the image file in external store.
|
||||
returned: success
|
||||
type: str
|
||||
metadata:
|
||||
description: The location metadata.
|
||||
returned: success
|
||||
type: str
|
||||
needs_config_drive:
|
||||
description: Specifies whether the image needs a config drive.
|
||||
returned: success
|
||||
type: bool
|
||||
needs_secure_boot:
|
||||
description: Whether Secure Boot is needed.
|
||||
returned: success
|
||||
type: bool
|
||||
os_admin_user:
|
||||
description: The operating system admin username.
|
||||
returned: success
|
||||
type: str
|
||||
os_command_line:
|
||||
description: The kernel command line to be used by libvirt driver.
|
||||
returned: success
|
||||
type: str
|
||||
os_distro:
|
||||
description: >
|
||||
The common name of the operating system distribution
|
||||
in lowercase.
|
||||
returned: success
|
||||
type: str
|
||||
os_require_quiesce:
|
||||
description: >
|
||||
If true, require quiesce on snapshot via
|
||||
QEMU guest agent.
|
||||
returned: success
|
||||
type: str
|
||||
os_shutdown_timeout:
|
||||
description: Time for graceful shutdown.
|
||||
returned: success
|
||||
type: str
|
||||
os_type:
|
||||
description: The operating system installed on the image.
|
||||
returned: success
|
||||
type: str
|
||||
os_version:
|
||||
description: >
|
||||
The operating system version as specified by
|
||||
the distributor.
|
||||
returned: success
|
||||
type: str
|
||||
owner_id:
|
||||
description: The ID of the owner, or project, of the image.
|
||||
returned: success
|
||||
type: str
|
||||
ramdisk_id:
|
||||
description: >
|
||||
The ID of image stored in the Image service that
|
||||
should be used as the ramdisk when booting an AMI-style image.
|
||||
returned: success
|
||||
type: str
|
||||
schema:
|
||||
description: URL for the schema describing a virtual machine image.
|
||||
returned: success
|
||||
type: str
|
||||
store:
|
||||
description: >
|
||||
Glance will attempt to store the disk
|
||||
image data in the backing store indicated by the value of the
|
||||
header.
|
||||
returned: success
|
||||
type: str
|
||||
updated_at:
|
||||
description: Image updated at timestamp.
|
||||
returned: success
|
||||
type: str
|
||||
properties:
|
||||
url:
|
||||
description: URL to access the image file kept in external store.
|
||||
returned: success
|
||||
type: str
|
||||
virtual_size:
|
||||
description: The virtual size of the image.
|
||||
returned: success
|
||||
type: str
|
||||
vm_mode:
|
||||
description: The virtual machine mode.
|
||||
returned: success
|
||||
type: str
|
||||
vmware_adaptertype:
|
||||
description: >
|
||||
The virtual SCSI or IDE controller used by the
|
||||
hypervisor.
|
||||
returned: success
|
||||
type: str
|
||||
vmware_ostype:
|
||||
description: Operating system installed in the image.
|
||||
returned: success
|
||||
type: str
|
||||
filters:
|
||||
description: Additional properties associated with the image.
|
||||
returned: success
|
||||
type: dict
|
||||
@@ -112,7 +346,7 @@ openstack_image:
|
||||
description: Min amount of disk space required for this image.
|
||||
returned: success
|
||||
type: int
|
||||
protected:
|
||||
is_protected:
|
||||
description: Image protected flag.
|
||||
returned: success
|
||||
type: bool
|
||||
@@ -124,10 +358,10 @@ openstack_image:
|
||||
description: Owner for the image.
|
||||
returned: success
|
||||
type: str
|
||||
is_public:
|
||||
description: Is public flag of the image.
|
||||
visibility:
|
||||
description: Indicates who has access to the image.
|
||||
returned: success
|
||||
type: bool
|
||||
type: str
|
||||
size:
|
||||
description: Size of the image.
|
||||
returned: success
|
||||
@@ -137,7 +371,6 @@ openstack_image:
|
||||
returned: success
|
||||
type: list
|
||||
'''
|
||||
|
||||
from ansible_collections.openstack.cloud.plugins.module_utils.openstack import OpenStackModule
|
||||
|
||||
|
||||
@@ -147,20 +380,21 @@ class ImageInfoModule(OpenStackModule):
|
||||
|
||||
argument_spec = dict(
|
||||
image=dict(type='str', required=False),
|
||||
properties=dict(type='dict', required=False),
|
||||
filters=dict(type='dict', required=False, aliases=['properties']),
|
||||
)
|
||||
module_kwargs = dict(
|
||||
supports_check_mode=True
|
||||
)
|
||||
|
||||
def run(self):
|
||||
|
||||
if self.params['image']:
|
||||
image = self.conn.get_image(self.params['image'])
|
||||
self.exit(changed=False, openstack_image=image)
|
||||
else:
|
||||
images = self.conn.search_images(filters=self.params['properties'])
|
||||
self.exit(changed=False, openstack_image=images)
|
||||
args = {
|
||||
'name_or_id': self.params['image'],
|
||||
'filters': self.params['filters'],
|
||||
}
|
||||
args = {k: v for k, v in args.items() if v is not None}
|
||||
images = [image.to_dict(computed=False) for image in
|
||||
self.conn.search_images(**args)]
|
||||
self.exit(changed=False, images=images)
|
||||
|
||||
|
||||
def main():
|
||||
|
||||
Reference in New Issue
Block a user