mirror of https://github.com/ansible/ansible.git
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.
151 lines
3.5 KiB
ReStructuredText
151 lines
3.5 KiB
ReStructuredText
.. _vmware_rest_vm_hardware_tuning:
|
|
|
|
*******************************
|
|
How to modify a virtual machine
|
|
*******************************
|
|
|
|
.. contents::
|
|
:local:
|
|
|
|
|
|
Introduction
|
|
============
|
|
|
|
This section shows you how to use Ansible to modify an existing virtual machine.
|
|
|
|
Scenario requirements
|
|
=====================
|
|
|
|
You've already followed :ref:`vmware_rest_create_vm` and created a VM.
|
|
|
|
How to add a CDROM drive to a virtual machine
|
|
=============================================
|
|
|
|
In this example, we use the ``vcenter_vm_hardware_*`` modules to add a new CDROM to an existing VM.
|
|
|
|
Add a new SATA adapter
|
|
______________________
|
|
|
|
First we create a new SATA adapter. We specify the ``pci_slot_number``. This way if we run the task again it won't do anything if there is already an adapter there.
|
|
|
|
.. literalinclude:: task_outputs/Create_a_SATA_adapter_at_PCI_slot_34.task.yaml
|
|
|
|
Result
|
|
______
|
|
|
|
.. literalinclude:: task_outputs/Create_a_SATA_adapter_at_PCI_slot_34.result.json
|
|
|
|
Add a CDROM drive
|
|
_________________
|
|
|
|
Now we can create the CDROM drive:
|
|
|
|
.. literalinclude:: task_outputs/Attach_an_ISO_image_to_a_guest_VM.task.yaml
|
|
|
|
Result
|
|
______
|
|
|
|
.. literalinclude:: task_outputs/Attach_an_ISO_image_to_a_guest_VM.result.json
|
|
|
|
|
|
.. _vmware_rest_attach_a_network:
|
|
|
|
How to attach a VM to a network
|
|
===============================
|
|
|
|
Attach a new NIC
|
|
________________
|
|
|
|
Here we attach the VM to the network (through the portgroup). We specify a ``pci_slot_number`` for the same reason.
|
|
|
|
The second task adjusts the NIC configuration.
|
|
|
|
.. literalinclude:: task_outputs/Attach_a_VM_to_a_dvswitch.task.yaml
|
|
|
|
Result
|
|
______
|
|
|
|
.. literalinclude:: task_outputs/Attach_a_VM_to_a_dvswitch.result.json
|
|
|
|
Adjust the configuration of the NIC
|
|
___________________________________
|
|
|
|
.. literalinclude:: task_outputs/Turn_the_NIC's_start_connected_flag_on.task.yaml
|
|
|
|
Result
|
|
______
|
|
|
|
.. literalinclude:: task_outputs/Turn_the_NIC's_start_connected_flag_on.result.json
|
|
|
|
Increase the memory of the VM
|
|
=============================
|
|
|
|
We can also adjust the amount of memory that we dedicate to our VM.
|
|
|
|
.. literalinclude:: task_outputs/Increase_the_memory_of_a_VM.task.yaml
|
|
|
|
Result
|
|
______
|
|
|
|
.. literalinclude:: task_outputs/Increase_the_memory_of_a_VM.result.json
|
|
|
|
Upgrade the hardware version of the VM
|
|
======================================
|
|
|
|
Here we use the ``vcenter_vm_hardware`` module to upgrade the version of the hardware:
|
|
|
|
.. literalinclude:: task_outputs/Upgrade_the_VM_hardware_version.task.yaml
|
|
|
|
Result
|
|
______
|
|
|
|
.. literalinclude:: task_outputs/Upgrade_the_VM_hardware_version.result.json
|
|
|
|
Adjust the number of CPUs of the VM
|
|
===================================
|
|
|
|
You can use ``vcenter_vm_hardware_cpu`` for that:
|
|
|
|
.. literalinclude:: task_outputs/Dedicate_one_core_to_the_VM.task.yaml
|
|
|
|
Result
|
|
______
|
|
|
|
.. literalinclude:: task_outputs/Dedicate_one_core_to_the_VM.result.json
|
|
|
|
Remove a SATA controller
|
|
========================
|
|
|
|
In this example, we remove the SATA controller of the PCI slot 34.
|
|
|
|
.. literalinclude:: task_outputs/Remove_SATA_adapter_at_PCI_slot_34.result.json
|
|
|
|
Result
|
|
______
|
|
|
|
.. literalinclude:: task_outputs/Remove_SATA_adapter_at_PCI_slot_34.result.json
|
|
|
|
Attach a floppy drive
|
|
=====================
|
|
|
|
Here we attach a floppy drive to a VM.
|
|
|
|
.. literalinclude:: task_outputs/Add_a_floppy_disk_drive.task.yaml
|
|
|
|
Result
|
|
______
|
|
|
|
.. literalinclude:: task_outputs/Add_a_floppy_disk_drive.result.json
|
|
|
|
Attach a new disk
|
|
=================
|
|
|
|
Here we attach a tiny disk to the VM. The ``capacity`` is in bytes.
|
|
|
|
.. literalinclude:: task_outputs/Create_a_new_disk.task.yaml
|
|
|
|
Result
|
|
______
|
|
|
|
.. literalinclude:: task_outputs/Create_a_new_disk.result.json
|