virt-customize - Online na nuvem

PROGRAMA:

NOME

virt-customize - Personalize uma máquina virtual

SINOPSE

virt-personalizar
[-a disk.img [-a disk.img ...] | -d domname]
[--attach ISOFILE] [--attach-format FORMAT]
[-c URI | --connect URI] [-n | --funcionamento a seco ]
[--formato FORMATO] [-m MB | --memsize MB]
[--network | - sem rede]
[-q | --quiet] [--smp N] [-v | --verbose] [-x]
[--chmod PERMISSÕES: ARQUIVO] [--commands-from-file FILENAME]
[--copy FONTE: DEST] [--copy-in LOCALPATH: REMOTEDIR]
[- excluir PATH] [--edit ARQUIVO: EXPR] [--firstboot SCRIPT]
[--firstboot-command 'CMD + ARGS'] [--firstboot-install PKG, PKG ..]
[--hostname HOSTNAME] [--install PKG, PKG ..]
[--link ALVO: LINK [: LINK ..]] [--mkdir DIR] [--mover FONTE: DEST]
[--password USUÁRIO: SELECTOR] [--root-password SELECTOR]
[--run SCRIPT] [--run-command 'CMD + ARGS'] [--scrub FILE]
[--sm-attach SELETOR] [--sm-register] [--sm-remove]
[--sm-unregister] [--ssh-inject USUÁRIO [: SELECTOR]] [--truncate FILE]
[--truncate-recursive PATH] [--timezone TIMEZONE] [--touch FILE]
[--atualizar] [--upload ARQUIVO: DEST] [--escrever ARQUIVO: CONTEÚDO]
[--no-logfile] [--password-crypto md5 | sha256 | sha512]
[--selinux-relabel] [--sm-credentials SELETOR]

virt-customize [-V | --version]

ATENÇÃO

Usando "virt-customize" em máquinas virtuais ativas ou simultaneamente com outra edição de disco
ferramentas, pode ser perigoso, podendo causar corrupção de disco. A máquina virtual deve ser
desligue antes de usar este comando e as imagens de disco não devem ser editadas simultaneamente.

DESCRIÇÃO

Virt-customize pode personalizar uma máquina virtual (imagem de disco) instalando pacotes,
editar arquivos de configuração e assim por diante.

Virt-customize modifica o convidado ou imagem de disco in lugar. O convidado deve ser desligado.
Se você quiser preservar o conteúdo existente do convidado, Você devo instantâneo, cópia or
clonar da disco primeiro.

Você pode fazer não precisa executar virt-customize como root. Na verdade, geralmente recomendamos que você
não.

As ferramentas relacionadas incluem: virt-sysprep(1) e construtor virt(1).

OPÇÕES

--Socorro
Mostra uma breve ajuda.

-a lima
--adicionar lima
Adicionar lima que deve ser uma imagem de disco de uma máquina virtual.

O formato da imagem do disco é detectado automaticamente. Para substituir isso e forçar um
formato particular use o --formato opção.

-a URI
--adicionar URI
Adicione um disco remoto. O formato URI é compatível com guestfish. Veja "ADICIONANDO REMOTO
STORAGE "em peixe convidado(1).

--anexar ISOFIL
O disco fornecido é anexado ao dispositivo libguestfs. Isso é usado para fornecer
repositórios de software ou outros dados para personalização.

Você provavelmente deseja garantir que o (s) volume (s) ou sistemas de arquivos nos discos anexados sejam
rotulados (ou use um nome de volume ISO) para que você possa montá-los por rótulo em sua execução
roteiros:

mkdir / tmp / mount
montagem LABEL = EXTRA / tmp / montagem

Você pode ter vários --anexar opções, e o formato pode ser qualquer formato de disco (não
apenas um ISO).

--anexar-formato FORMATO
Especifique o formato do disco para o próximo --anexar opção. O "FORMATO" é geralmente "bruto"
ou "qcow2". Use "raw" para ISOs.

-c URI
--conectar URI
Se estiver usando libvirt, conecte-se ao URI. Se omitido, então nos conectamos ao
hipervisor libvirt padrão.

Se você especificar dispositivos de bloqueio de convidado diretamente (-a), então o libvirt não é usado.

-d convidado
--domínio convidado
Adicione todos os discos do convidado libvirt nomeado. UUIDs de domínio podem ser usados ​​em vez de
nomes.

-n
--funcionamento a seco
Execute uma "simulação" somente leitura no convidado. Isso executa a operação sysprep, mas
descarta quaisquer alterações no disco no final.

--formato raw | qcow2 | ..
--formato auto
O padrão para o -a opção é detectar automaticamente o formato da imagem do disco. Usando
isso força o formato do disco para -a opções que seguem na linha de comando. Usando
--formato auto muda de volta para a detecção automática para as próximas -a opções.

Por exemplo:

virt-customize --format raw -a disk.img

força o formato bruto (sem detecção automática) para disco.img.

virt-customize --format raw -a disk.img --format auto -a another.img

força o formato bruto (sem detecção automática) para disco.img e reverte para detecção automática para
outro.img.

Se você tiver imagens de disco de convidado não confiáveis ​​em formato raw, você deve usar esta opção para
especifique o formato do disco. Isso evita um possível problema de segurança com programas maliciosos
convidados (CVE-2010-3851).

-m MB
--memsize MB
Altere a quantidade de memória alocada para --corre scripts. Aumente se você encontrar
que --corre scripts ou o --instalar opção está ficando sem memória.

O padrão pode ser encontrado com este comando:

peixe convidado obtém memsize

--rede
--sem rede
Habilite ou desabilite o acesso à rede do convidado durante a instalação.

Ativado é o padrão. Usar --sem rede para desativar o acesso.

A rede só permite conexões de saída e tem outras limitações secundárias. Ver
"NETWORK" em virt-resgate(1).

Se você usar --sem rede em seguida, certas outras opções, como --instalar não funciona.

Isso não afeta se o convidado pode acessar a rede depois de inicializada,
porque isso é controlado pelo seu hipervisor ou ambiente de nuvem e não tem nada para
fazer com virt-customize.

De um modo geral, você deve não usar --sem rede. Mas aqui estão algumas razões pelas quais você
pode querer:

1. Porque o backend libguestfs que você está usando não suporta a rede.
(Veja: "BACKEND" em convidados(3)).

2. Qualquer software que você precisa instalar vem de um ISO anexado, então você não precisa do
rede.

3. Você não quer um código de convidado não confiável tentando acessar sua rede host quando
executando virt-customize. Isso é especialmente um problema quando você não confia no
fonte dos modelos de sistema operacional. (Veja "SEGURANÇA" abaixo).

4. Você não tem uma rede host (por exemplo, em ambientes seguros / restritos).

-q
--quieto
Não imprima mensagens de log.

Para habilitar o registro detalhado de operações de arquivos individuais, use -x.

--smp N
Habilitar N ≥ 2 CPUs virtuais para --corre scripts para usar.

-v
--verbose
Habilite mensagens detalhadas para depuração.

-V
--versão
Exibe o número da versão e sai.

-x Habilite o rastreamento de chamadas de API libguestfs.

Personalização opções
--chmod PERMISSÕES: ARQUIVO
Altere as permissões de "ARQUIVO" para "PERMISSÕES".

Note: "PERMISSÕES" por padrão seria decimal, a menos que você prefixe com 0 para obter
octal, ou seja, use 0700 não 700.

--comandos-do-arquivo NOME DO ARQUIVO
Leia os comandos de personalização de um arquivo, um (e seus argumentos) de cada linha.

Cada linha contém um único comando de personalização e seus argumentos, por exemplo:

deletar / algum / arquivo
instalar algum pacote
senha algum-usuário: senha: sua-nova-senha

As linhas vazias são ignoradas e as linhas que começam com "#" são comentários e são ignoradas como
Nós vamos. Além disso, os argumentos podem ser espalhados por várias linhas, adicionando um "\"
(caractere de continuação) no final de uma linha, por exemplo

editar / algum / arquivo: \
s / ^ OPT =. * / OPT = ok /

Os comandos são tratados na mesma ordem em que estão no arquivo, como se fossem
especificado como --excluir / algum / arquivo na linha de comando.

--cópia de FONTE: DEST
Copie arquivos ou diretórios recursivamente dentro do convidado.

Curingas não podem ser usados.

--copiar LOCALPATH: REMOTEDIR
Copie arquivos ou diretórios locais recursivamente na imagem do disco, colocando-os no
diretório "REMOTEDIR" (que deve existir).

Curingas não podem ser usados.

--excluir PATH
Exclua um arquivo do convidado. Ou exclua um diretório (e todo o seu conteúdo,
recursivamente).

Veja também: --Envio, --esfregar.

--editar ARQUIVO: EXPR
Edite "FILE" usando a expressão Perl "EXPR".

Tenha o cuidado de citar corretamente a expressão para evitar que seja alterada pelo
Concha.

Observe que esta opção está disponível apenas quando o Perl 5 está instalado.

Consulte "EDIÇÃO NÃO INTERATIVA" em edição virt(1).

--firstboot SCRIPT
Instale o "SCRIPT" dentro do convidado, de modo que, quando o convidado for inicializado pela primeira vez, o script
é executado (como root, no final do processo de inicialização).

O script é automaticamente chmod + x após a instalação no convidado.

A versão alternativa --firstboot-comando é o mesmo, mas convenientemente envolve o
comando em um script de linha única para você.

Você pode ter vários --firstboot opções. Eles correm na mesma ordem que eles
aparecem na linha de comando.

Por favor, dê uma olhada em "PRIMEIROS SCRIPTS DE INICIALIZAÇÃO" em construtor virt(1) para mais informações e
advertências sobre os primeiros scripts de inicialização.

Veja também --corre.

--firstboot-comando 'CMD + ARGS'
Execute o comando (e argumentos) dentro do convidado quando o convidado inicializa pela primeira vez (como root,
no final do processo de inicialização).

Você pode ter vários --firstboot opções. Eles correm na mesma ordem que eles
aparecem na linha de comando.

Por favor, dê uma olhada em "PRIMEIROS SCRIPTS DE INICIALIZAÇÃO" em construtor virt(1) para mais informações e
advertências sobre os primeiros scripts de inicialização.

Veja também --corre.

--firstboot-instalar PKG, PKG ..
Instale os pacotes nomeados (uma lista separada por vírgulas). Estes são instalados quando o
o convidado inicializa primeiro usando o gerenciador de pacotes do convidado (por exemplo, apt, yum, etc.) e o
conexão de rede do convidado.

Para uma visão geral sobre as diferentes maneiras de instalar pacotes, consulte "INSTALANDO PACOTES"
in construtor virt(1).

--nome de anfitrião NOME DE ANFITRIÃO
Defina o nome do host do convidado como "HOSTNAME". Você pode usar um hostname.domainname com pontos
(FQDN) se você quiser.

--instalar PKG, PKG ..
Instale os pacotes nomeados (uma lista separada por vírgulas). Estes são instalados durante o
imagem construída usando o gerenciador de pacotes do convidado (por exemplo, apt, yum, etc.) e o do host
conexão de rede.

Para uma visão geral sobre as diferentes maneiras de instalar pacotes, consulte "INSTALANDO PACOTES"
in construtor virt(1).

Veja também --atualizar.

--ligação ALVO: LINK [: LINK ..]
Crie link (s) simbólico (s) no convidado, começando em "LINK" e apontando para "TARGET".

--mkdir DIR
Crie um diretório no convidado.

Isso usa "mkdir -p" para que quaisquer diretórios intermediários sejam criados, e também funciona se
o diretório já existe.

--mover FONTE: DEST
Mova arquivos ou diretórios dentro do convidado.

Curingas não podem ser usados.

--no-logfile
Scrub "builder.log" (arquivo de log dos comandos de compilação) da imagem após a compilação é
completo. Se você não quiser revelar precisamente como a imagem foi construída, use este
opção.

Veja também: "LOG FILE".

--senha USUÁRIO: SELETOR
Defina a senha para "USUÁRIO". (Observe que esta opção não crie a conta do usuário).

Veja "USUÁRIOS E SENHAS" em construtor virt(1) para o formato do campo "SELECTOR",
e também como configurar contas de usuário.

--senha-criptografia md5 | sha256 | sha512
Quando as ferramentas virt mudam ou definem uma senha no convidado, esta opção define o
criptografia de senha dessa senha para "md5", "sha256" ou "sha512".

"sha256" e "sha512" requerem glibc ≥ 2.7 (verifique cripta(3) dentro do convidado).

"md5" funcionará com convidados Linux relativamente antigos (por exemplo, RHEL 3), mas não é seguro
contra ataques modernos.

O padrão é "sha512" a menos que libguestfs detecte um convidado antigo que não tinha
suporte para SHA-512, caso em que usará "md5". Você pode substituir libguestfs por
especificando esta opção.

Observe que isso não altera a criptografia de senha padrão usada pelo convidado quando você
crie novas contas de usuário dentro do convidado. Se você quiser fazer isso, você deve
use o --editar opção para modificar "/ etc / sysconfig / authconfig" (Fedora, RHEL) ou
"/etc/pam.d/common-password"(Debian, Ubuntu).

--senha-raiz SELETOR
Defina a senha de root.

Veja "USUÁRIOS E SENHAS" em construtor virt(1) para o formato do campo "SELECTOR",
e também como configurar contas de usuário.

Nota: No virt-builder, se você não conjunto --senha-raiz então o convidado recebe um
acaso senha de root.

--corre SCRIPT
Execute o script de shell (ou qualquer programa) chamado "SCRIPT" na imagem do disco. O roteiro
é executado virtualizado dentro de um pequeno dispositivo, chrootado no sistema de arquivos convidado.

O script é automaticamente chmod + x.

Se libguestfs suporta, então uma conexão de rede limitada está disponível, mas apenas
permite conexões de rede de saída. Você também pode anexar discos de dados (por exemplo, arquivos ISO)
como outra forma de fornecer dados (por exemplo, pacotes de software) para o script sem a necessidade de um
conexão de rede (--anexar) Você também pode fazer upload de arquivos de dados (--Envio).

Você pode ter vários --corre opções. Eles são executados na mesma ordem em que aparecem no
a linha de comando.

Veja também: --firstboot, --anexar, --Envio.

--comando de execução 'CMD + ARGS'
Execute o comando e os argumentos na imagem de disco. O comando é executado virtualizado dentro
um pequeno dispositivo, chrootado no sistema de arquivos convidado.

Se libguestfs suporta, então uma conexão de rede limitada está disponível, mas apenas
permite conexões de rede de saída. Você também pode anexar discos de dados (por exemplo, arquivos ISO)
como outra forma de fornecer dados (por exemplo, pacotes de software) para o script sem a necessidade de um
conexão de rede (--anexar) Você também pode fazer upload de arquivos de dados (--Envio).

Você pode ter vários --comando de execução opções. Eles correm na mesma ordem que eles
aparecem na linha de comando.

Veja também: --firstboot, --anexar, --Envio.

--esfregar ARQUIVO
Limpe um arquivo do convidado. Isto é como --excluir exceto aquilo:

· Ele limpa os dados para que um convidado não possa recuperá-los.

· Não pode deletar diretórios, apenas arquivos regulares.

--selinux-relabel
Identifique novamente os arquivos no convidado para que tenham o rótulo SELinux correto.

Você só deve usar esta opção para convidados que suportam SELinux.

--sm-anexar SELETOR
Anexe a um pool usando "gerenciador de assinaturas".

Consulte "ASSINATURA-MANAGER" em construtor virt(1) para o formato do campo "SELECTOR".

--sm-credenciais SELETOR
Defina as credenciais para "gerenciador de assinaturas".

Consulte "ASSINATURA-MANAGER" em construtor virt(1) para o formato do campo "SELECTOR".

--sm-registro
Registre o convidado usando o "gerenciador de assinaturas".

Isso requer que as credenciais sejam definidas usando --sm-credenciais.

--sm-remover
Remova todas as assinaturas do convidado usando o "gerenciador de assinaturas".

--sm-cancelar registro
Cancele o registro do convidado usando o "gerenciador de assinaturas".

--ssh-injetar USUÁRIO [: SELETOR]
Injetar uma chave ssh para que o "USUÁRIO" fornecido seja capaz de logar no ssh sem
fornecendo uma senha. O "USUÁRIO" já deve existir no convidado.

Veja "CHAVES SSH" em construtor virt(1) para o formato do campo "SELECTOR".

Você pode ter vários --ssh-injetar opções, para diferentes usuários e também para mais chaves
para cada usuário.

--fuso horário FUSO HORÁRIO
Defina o fuso horário padrão do convidado como "TIMEZONE". Use uma string de localização como
"Europa / Londres"

--tocar ARQUIVO
Este comando executa um contacto(1) operação semelhante a "ARQUIVO".

--truncar ARQUIVO
Este comando trunca o "caminho" para um arquivo de comprimento zero. O arquivo já deve existir.

--truncar-recursivo PATH
Este comando trunca recursivamente todos os arquivos em "caminho" para comprimento zero.

--atualizar
Faça o equivalente a "yum update", "apt-get upgrade" ou qualquer outro comando necessário
para atualizar os pacotes já instalados no modelo para suas versões mais recentes.

Veja também --instalar.

--Envio ARQUIVO: DEST
Carregue o arquivo local "FILE" para o destino "DEST" na imagem do disco. Proprietário do arquivo e
as permissões do original são preservadas, então você deve configurá-las como quiser
para que eles estejam na imagem de disco.

"DEST" pode ser o nome do arquivo final. Isso pode ser usado para renomear o arquivo no upload.

Se "DEST" é um nome de diretório (que já deve existir no convidado), o arquivo é
carregado nesse diretório e mantém o mesmo nome do sistema de arquivos local.

Veja também: --mkdir, --excluir, --esfregar.

--escrever ARQUIVO: CONTEÚDO
Escreva "CONTEÚDO" em "ARQUIVO".

SELINUX

Para convidados que fazem uso do SELinux, um tratamento especial para eles pode ser necessário ao usar
operações que criam novos arquivos ou alteram os existentes.

Para obter mais detalhes, consulte "SELINUX" em construtor virt(1).

SAIR STATUS

Este programa retorna 0 em caso de sucesso ou 1 se houver um erro.

MEIO AMBIENTE VARIÁVEIS

"VIRT_TOOLS_DATA_DIR"
Isso pode apontar para o diretório que contém os arquivos de dados usados ​​para o firstboot do Windows
instalação.

Normalmente você não precisa definir isso. Se não for definido, um padrão compilado será usado
(algo como / usr / share / virt-tools).

Este diretório pode conter os seguintes arquivos:

rhsrvany.exe
Este é o binário RHSrvAny do Windows, usado para instalar um script "firstboot" em
Convidados do Windows. É necessário se você pretende usar o --firstboot or
--firstboot-comando opções com convidados Windows.

Veja também: "https://github.com/rwmjones/rhsrvany"

Para outras variáveis ​​de ambiente, consulte "VARIÁVEIS DE AMBIENTE" em convidados(3).

Use virt-customize online usando serviços onworks.net