ansible / ansible.builtin / v2.4.0.0-1 / module / gce_pd utilize GCE persistent disk resources | "added in version" 1.4 of ansible.builtin" Authors: Eric Johnson (@erjohnso) <erjohnso@google.com> preview | supported by communityansible.builtin.gce_pd (v2.4.0.0-1) — module
pip
Install with pip install ansible==2.4.0.0.post1
This module can create and destroy unformatted GCE persistent disks U(https://developers.google.com/compute/docs/disks#persistentdisks). It also supports attaching and detaching disks from running instances. Full install/configuration instructions for the gce* modules can be found in the comments of ansible/test/gce_tests.py.
# Simple attachment action to an existing instance - local_action: module: gce_pd instance_name: notlocalhost size_gb: 5 name: pd
mode: aliases: [] choices: - READ_WRITE - READ_ONLY default: READ_ONLY description: - GCE mount mode of disk, READ_ONLY (default) or READ_WRITE required: false name: aliases: [] default: null description: - name of the disk required: true zone: aliases: [] default: us-central1-b description: - zone in which to create the disk required: false image: aliases: [] default: null description: - the source image to use for the disk required: false version_added: '1.7' version_added_collection: ansible.builtin state: aliases: [] choices: - active - present - absent - deleted default: present description: - desired state of the persistent disk required: false size_gb: aliases: [] default: 10 description: - whole integer size of disk (in GB) to create, default is 10 GB required: false pem_file: aliases: [] default: null description: - path to the pem file associated with the service account email This option is deprecated. Use 'credentials_file'. required: false version_added: '1.6' version_added_collection: ansible.builtin snapshot: aliases: [] default: null description: - the source snapshot to use for the disk required: false version_added: '1.7' version_added_collection: ansible.builtin disk_type: aliases: [] choices: - pd-standard - pd-ssd default: pd-standard description: - type of disk provisioned required: false version_added: '1.9' version_added_collection: ansible.builtin project_id: aliases: [] default: null description: - your GCE project ID required: false version_added: '1.6' version_added_collection: ansible.builtin detach_only: aliases: [] choices: - 'yes' - 'no' default: 'no' description: - do not destroy the disk, merely detach it from an instance required: false instance_name: aliases: [] default: null description: - instance name if you wish to attach or detach the disk required: false credentials_file: aliases: [] default: null description: - path to the JSON file associated with the service account email required: false version_added: 2.1.0 version_added_collection: ansible.builtin delete_on_termination: choices: - 'yes' - 'no' default: false description: - If yes, deletes the volume when instance is terminated version_added: '2.3' version_added_collection: ansible.builtin service_account_email: aliases: [] default: null description: - service account email required: false version_added: '1.6' version_added_collection: ansible.builtin