VMware Guest File Operation

4 min

Resumo

Módulo para copiar um arquivo para uma VM, buscar um arquivo de uma VM e criar ou excluir um diretório no sistema operacional convidado.

Parâmetros

Parâmetro	Tipo	Escolhas \| Valor Padrão	Comentários
cluster	string		O cluster que hospeda a máquina virtual.Se definido, ajudará a acelerar a pesquisa de máquina virtual.
copy	dictionary		Copie o arquivo para vm sem a necessidade de rede.Os atributos válidos são:src: fonte do arquivo absoluta ou relativadest: destino do arquivo, caminho deve existirsobrescrever: False ou True (não obrigatório, padrão False)
datacenter	string		O datacenter que hospeda a máquina virtual.Se definido, ajudará a acelerar a pesquisa de máquina virtual.
directory	dictionary		Crie ou exclua um diretório.Pode ser usado para criar um diretório temporário dentro do convidado usando a operação mktemp.mktemp define a variável dirno resultado com o nome do novo diretório.A opção de operação mktemp foi adicionada na versão 2.8Os atributos válidos são:operação (str): os valores válidos são: criar, excluir, mktempcaminho (str): caminho do diretório (necessário para criar ou remover)prefixo (str): prefixo do diretório temporário (necessário para mktemp)sufixo (str): sufixo do diretório temporário (necessário para mktemp)recurse (booleano): Não obrigatório, padrão (falso)
fetch	dictionary		Obtenha o arquivo da máquina virtual sem a necessidade de rede.Os atributos válidos são:src: O arquivo no sistema remoto a ser buscado. Este deve ser um arquivo, não um diretóriodest: destino do arquivo em localhost, o caminho deve existir
folder	string		Pasta de destino, caminho absoluto para encontrar um convidado existente ou criar o novo convidado.A pasta deve incluir o datacenter. O datacenter da ESX é ha-datacenterUsado apenas se vm_id_typefor inventory_path.Exemplos:pasta: / ha-datacenter / vmpasta: ha-datacenter / vmpasta: / datacenter1 / vmpasta: datacenter1 / vmpasta: / datacenter1 / vm / pasta1pasta: datacenter1 / vm / pasta1pasta: / pasta1 / datacenter1 / vmpasta: pasta1 / datacenter1 / vmpasta: / pasta1 / datacenter1 / vm / pasta2pasta: vm / pasta2pasta: pasta2
hostname	string		O nome do host ou endereço IP do servidor vSphere vCenter ou ESXi.Se o valor não for especificado na tarefa, o valor da variável de ambiente VMWARE_HOSTserá usado em seu lugar.Suporte a variável de ambiente adicionado em Ansible 2.6.
password	string		A senha do servidor vSphere vCenter ou ESXi.Se o valor não for especificado na tarefa, o valor da variável de ambiente VMWARE_PASSWORDserá usado em seu lugar.Suporte a variável de ambiente adicionado em Ansible 2.6. aliases: pass, pwd
port	integer	Default: 443	O número da porta do servidor vSphere vCenter ou ESXi.Se o valor não for especificado na tarefa, o valor da variável de ambiente VMWARE_PORTserá usado em seu lugar.Suporte a variável de ambiente adicionado em Ansible 2.6.
proxy_host	string		Endereço de um proxy que receberá todas as solicitações HTTPS e as retransmitirá.O formato é um nome de host ou IP.Se o valor não for especificado na tarefa, o valor da variável de ambiente VMWARE_PROXY_HOSTserá usado em seu lugar.Este recurso depende de uma versão do pyvmomi superior a v6.7.1.2018.12
proxy_port	integer		Porta do proxy HTTP que receberá todas as solicitações HTTPS e as retransmitirá.Se o valor não for especificado na tarefa, o valor da variável de ambiente VMWARE_PROXY_PORTserá usado em seu lugar.
username	string		O nome de usuário do servidor vSphere vCenter ou ESXi.Se o valor não for especificado na tarefa, o valor da variável de ambiente VMWARE_USERserá usado em seu lugar.Suporte a variável de ambiente adicionado em Ansible 2.6. aliases: admin, usuário
validate_certs	boolean	Escolhas: - "false" - "true" (default)	Permite a conexão quando os certificados SSL não são válidos. Definido para falsequando os certificados não são confiáveis.Se o valor não for especificado na tarefa, o valor da variável de ambiente VMWARE_VALIDATE_CERTSserá usado em seu lugar.Suporte a variável de ambiente adicionado em Ansible 2.6.Se definido como yes, certifique-se de que Python> = 2.7.9 esteja instalado na máquina fornecida.
vm_id - required	string		Nome da máquina virtual com a qual trabalhar.
vm_id_type	string	Escolhas: - "uuid" - "instance_uuid" - "dns_name" - "vm_name" (default)	O método de identificação VMware pelo qual a máquina virtual será identificada.
vm_password - required	string		A senha usada para fazer login na máquina virtual.
vm_username - required	string		O usuário para fazer login na máquina virtual.

Notas

Observação

Testado em vSphere 7.0.2
Apenas a primeira correspondência contra vm_id é usada, mesmo se houver várias correspondências

Exemplos

- name: Crie um diretório dentro de um vm
  vmware_guest_file_operation:
    hostname: "{{ vcenter_hostname }}"
    username: "{{ vcenter_username }}"
    password: "{{ vcenter_password }}"
    datacenter: "{{ datacenter_name }}"
    validate_certs: no
    vm_id: "{{ guest_name }}"
    vm_username: "{{ guest_username }}"
    vm_password: "{{ guest_userpassword }}"
    directory:
      path: "/test"
      operation: create
      recurse: no
  delegate_to: localhost

- name: copiar arquivo para vm
  vmware_guest_file_operation:
    hostname: "{{ vcenter_hostname }}"
    username: "{{ vcenter_username }}"
    password: "{{ vcenter_password }}"
    datacenter: "{{ datacenter_name }}"
    vm_id: "{{ guest_name }}"
    vm_username: "{{ guest_username }}"
    vm_password: "{{ guest_userpassword }}"
    copy:
        src: "files/test.zip"
        dest: "/root/test.zip"
        overwrite: False
  delegate_to: localhost

- name: buscar arquivo de vm
  vmware_guest_file_operation:
    hostname: "{{ vcenter_hostname }}"
    username: "{{ vcenter_username }}"
    password: "{{ vcenter_password }}"
    datacenter: "{{ datacenter_name }}"
    vm_id: "{{ guest_name }}"
    vm_username: "{{ guest_username }}"
    vm_password: "{{ guest_userpassword }}"
    fetch:
        src: "/root/test.zip"
        dest: "files/test.zip"
  delegate_to: localhost