mirror of
https://github.com/ansible-collections/community.general.git
synced 2024-09-14 20:13:21 +02:00
VMware: added documentation for missing netplan support (#46685)
Currently there is no `netplan` support in open-vm-tools. Therefore it's nice to have a quick workaround in our documentation Signed-off-by: Christian Rebischke <chris@nullday.de>
This commit is contained in:
parent
4b2356ff55
commit
704d5642f3
1 changed files with 81 additions and 2 deletions
|
@ -22,8 +22,87 @@ When debugging or creating a new issue, you will need information about your VMw
|
||||||
$ export GOVC_URL=https://ESXI_OR_VCENTER_HOSTNAME:443
|
$ export GOVC_URL=https://ESXI_OR_VCENTER_HOSTNAME:443
|
||||||
$ govc find /
|
$ govc find /
|
||||||
|
|
||||||
|
Known issues
|
||||||
|
============
|
||||||
|
|
||||||
Troubleshooting Item
|
|
||||||
|
Network settings with vmware_guest in Ubuntu 18.04
|
||||||
|
--------------------------------------------------
|
||||||
|
|
||||||
|
Setting the network with ``vmware_guest`` in Ubuntu 18.04 is known to be broken, due to missing support for ``netplan`` in the ``open-vm-tools``.
|
||||||
|
This issue is tracked via:
|
||||||
|
|
||||||
|
* https://github.com/vmware/open-vm-tools/issues/240
|
||||||
|
* https://github.com/ansible/ansible/issues/41133
|
||||||
|
|
||||||
|
Potential Workaround
|
||||||
|
^^^^^^^^^^^^^^^^^^^^
|
||||||
|
|
||||||
|
There are several workarounds for this issue.
|
||||||
|
|
||||||
|
1) Modifying the Ubuntu 18.04 images and installing ``ifupdown`` in them via ``sudo apt install ifupdown``.
|
||||||
|
If so you need to remove ``netplan`` via ``sudo apt remove netplan.io`` and you need stop ``systemd-networkd`` via ``sudo systemctl disable systemctl-networkd``.
|
||||||
|
|
||||||
|
2) You can generate the ``systemd-networkd`` files with a task in your vmware Ansible role:
|
||||||
|
|
||||||
|
.. code-block:: yaml
|
||||||
|
|
||||||
|
- name: make sure cache directory exists
|
||||||
|
file: path="{{ inventory_dir }}/cache" state=directory
|
||||||
|
delegate_to: localhost
|
||||||
|
|
||||||
|
- name: generate network templates
|
||||||
|
template: src=network.j2 dest="{{ inventory_dir }}/cache/{{ inventory_hostname }}.network"
|
||||||
|
delegate_to: localhost
|
||||||
|
|
||||||
|
- name: copy generated files to vm
|
||||||
|
vmware_guest_file_operation:
|
||||||
|
hostname: "{{ vmware_general.hostname }}"
|
||||||
|
username: "{{ vmware_username }}"
|
||||||
|
password: "{{ vmware_password }}"
|
||||||
|
datacenter: "{{ vmware_general.datacenter }}"
|
||||||
|
validate_certs: "{{ vmware_general.validate_certs }}"
|
||||||
|
vm_id: "{{ inventory_hostname }}"
|
||||||
|
vm_username: root
|
||||||
|
vm_password: "{{ template_password }}"
|
||||||
|
copy:
|
||||||
|
src: "{{ inventory_dir }}/cache/{{ inventory_hostname }}.network"
|
||||||
|
dest: "/etc/systemd/network/ens160.network"
|
||||||
|
overwrite: False
|
||||||
|
delegate_to: localhost
|
||||||
|
|
||||||
|
- name: restart systemd-networkd
|
||||||
|
vmware_vm_shell:
|
||||||
|
hostname: "{{ vmware_general.hostname }}"
|
||||||
|
username: "{{ vmware_username }}"
|
||||||
|
password: "{{ vmware_password }}"
|
||||||
|
datacenter: "{{ vmware_general.datacenter }}"
|
||||||
|
folder: /vm
|
||||||
|
vm_id: "{{ inventory_hostname}}"
|
||||||
|
vm_username: root
|
||||||
|
vm_password: "{{ template_password }}"
|
||||||
|
vm_shell: /bin/systemctl
|
||||||
|
vm_shell_args: " restart systemd-networkd"
|
||||||
|
delegate_to: localhost
|
||||||
|
|
||||||
|
- name: restart systemd-resolved
|
||||||
|
vmware_vm_shell:
|
||||||
|
hostname: "{{ vmware_general.hostname }}"
|
||||||
|
username: "{{ vmware_username }}"
|
||||||
|
password: "{{ vmware_password }}"
|
||||||
|
datacenter: "{{ vmware_general.datacenter }}"
|
||||||
|
folder: /vm
|
||||||
|
vm_id: "{{ inventory_hostname}}"
|
||||||
|
vm_username: root
|
||||||
|
vm_password: "{{ template_password }}"
|
||||||
|
vm_shell: /bin/systemctl
|
||||||
|
vm_shell_args: " restart systemd-resolved"
|
||||||
|
delegate_to: localhost
|
||||||
|
|
||||||
|
3) Wait for ``netplan`` support in ``open-vm-tools``
|
||||||
|
|
||||||
|
|
||||||
|
Troubleshooting Item
|
||||||
====================
|
====================
|
||||||
|
|
||||||
Description
|
Description
|
||||||
|
@ -31,4 +110,4 @@ Description
|
||||||
Potential Workaround
|
Potential Workaround
|
||||||
--------------------
|
--------------------
|
||||||
|
|
||||||
How to fix...
|
How to fix...
|
||||||
|
|
Loading…
Reference in a new issue