From 770f5155faf4ba4a31f6f733bf1657400e5e5e89 Mon Sep 17 00:00:00 2001 From: rhatto Date: Wed, 23 May 2007 16:47:07 +0000 Subject: updating pt_BR docs git-svn-id: svn+slack://slack.fluxo.info/var/svn/simplepkg@372 04377dda-e619-0410-9926-eae83683ac58 --- trunk/doc/README.pt_BR | 126 ++++++++++++++++++++++++++++++++++++++++--------- 1 file changed, 105 insertions(+), 21 deletions(-) (limited to 'trunk/doc/README.pt_BR') diff --git a/trunk/doc/README.pt_BR b/trunk/doc/README.pt_BR index f5d73db..f6f48a3 100644 --- a/trunk/doc/README.pt_BR +++ b/trunk/doc/README.pt_BR @@ -101,15 +101,17 @@ A constru A opção -c (ou --create) criará a pasta /etc/simplepkg/templates/meu-slackware, que conterá os seguintes componentes: - - /etc/simplepkg/templates/meu-slackware/meu-slackware.template: lista de pacotes - /etc/simplepkg/templates/meu-slackware/meu-slackware.d: cópia de arquivos de configuração - /etc/simplepkg/templates/meu-slackware/meu-slackware.s: scripts de pós-instalação + - /etc/simplepkg/templates/meu-slackware/meu-slackware.perms: informações sobre arquivos + - /etc/simplepkg/templates/meu-slackware/meu-slackware.template: lista de pacotes -Esses três componentes são suficientes para armazenar todas as características de uma instalação +Esses quatro componentes são suficientes para armazenar todas as características de uma instalação de slackware: a lista de pacotes controla o software instalado (a partir do conteúdo da pasta /var/log/packages), a cópia dos arquivos de configuração controla as personalizações feitas para o uso dos aplicativos e os scripts de pós-instalação cuidam de qualquer rotina que precisa ser realizada -exatamente após a instalação do sistema. +exatamente após a instalação do sistema. Já o arquivo de informações sobre arquivos contém as permissões, +o dono/a e grupo de cada arquivo de configuração presente no template. Se você quiser criar um template a partir de uma instalação de slackware presente numa outra partição do sistema que não seja a raíz, basta usar um comando do tipo @@ -117,8 +119,13 @@ do sistema que n templatepkg -c meu-slackware /mnt/slackware onde /mnt/slackware é o local onde o sistema alternativo está instalado. Após criado, o template possuirá -apenas a lista de pacotes contendo o nome dos aplicativos instalados no seu sistema. Para adicionar um -arquivo de configuração, basta dar um comando como +apenas a lista de pacotes contendo o nome dos aplicativos instalados no seu sistema. Como a pasta +/var/log/packages não preserva a ordem de instalação dos pacotes, então talvez você queira editar manualmente +a lista de pacotes de um template. Para isso, use o comando + + templatepkg -e meu-slackware + +Para adicionar um arquivo de configuração no seu novo template, basta dar um comando como templatepkg -a meu-slackware /etc/hosts @@ -158,60 +165,131 @@ com alguns templates padr Scripts de pós-instalação ------------------------- - templatepkg -b nome-do-script.sh +Opcionalmente, é possível manter scripts de pós-instalação num template. Tais script são executados exatamente +após a instalação de uma jaula e cópia de arquivos de configuração pelo mkjail. Para criar ou editar um script +de pós-instalação, use um comando como + + templatepkg -b meu-slackware nome-do-script.sh + +Isso adicionará o script nome-do-script.sh no template "meu-slackware". O mkjail passa dois argumentos para +cada script de pós-instalação: a pasta superior e o nome da jaula ("/mnt" e "hda2" no nosso exemplo anterior). +Assim, um exemplo de script seria algo como + + #!/bin/bash + chroot $1/$2/ sbin/ldconfig Listando o conteúdo de um template ---------------------------------- +Para listar os templates disponíveis ou o conteúdo de um template, use comandos como + templatepkg -l + templatepkg -l meu-slackware Removendo arquivos de um template --------------------------------- - templatepkg -d +Analogamente à forma como se adicona arquivos num template, removê-los pode ser feito com o seguinte comando: + + templatepkg -d meu-slackware /etc/hosts + +Isso remove o arquivo /etc/hosts do template "meu-slackware". Apagando um template -------------------- - templatepkg -r +Para apagar um template, basta utilizar um comando como + + templatepkg -r meu-slackware Atualizando um template ----------------------- - jail-commit +Agora que já abordamos as opções do templatepkg, é hora de visitarmos um outro aplicativo, desta vez utilizado +para manter um template atualizado. O jail-commit é um script que copia as alterações dos arquivos (conteúdo, +propriedade e permissões) de um template a partir do conteúdo de uma jaula ou instalação. + +Por exemplo, caso se queira copiar as alterações da jaula /mnt/hda2 no template "meu-slackware", basta usar o +comando + + jail-commit /mnt/hda2 meu-slackware -Para atualizar apenas a lista de pacotes de um template, use +Além da lista de pacotes do template "meu-slackware" ser atualizada de acordo com a lista de pacotes presente +em /mnt/hda2/var/log/packages, todos os arquivos de configuração presentes no template "meu-slackware" serão +comparados com os correspondentes da pasta /mnt/hda2 e as diferenças são copiadas para o template. Da mesma +forma, as permissões e informação de dono/grupo dos arquivos também é atualizada no template. + +O comando jail-commit possibilita que um template sempre esteja atualizado e refletindo a configuração atual +de uma instalação de slackware. Se você quiser atualizar apenas a lista de pacotes de um template, porém, use templatepkg -u meu-template -Editando manualmente a lista de pacotes ---------------------------------------- +Para facilitar ainda mais o controle das alterações do sistema, existe ainda uma facilidade do arquivo +/etc/simplepkg/jailist. Esse arquivo serve, além de outros propósitos descritos na documentação do simplaret, +para que o jail-commit saiba de antemão quais são as instalações de sistema do tipo Slackware presentes numa +máquina, além da instalação principal na raíz do sistema. + +Suponha que uma máquina possua duas instalações de slackware, além da principal (raíz): + + - /mnt/slackware-1 usando o template "slackware-1" + - /mnt/slackware-2 usando o template "slackware-2" - templatepkg -e nome-do-template +Se o arquivo /etc/simplepkg/jailist contiver as seguintes linhas, + + /mnt/slackware-1 + /mnt/slackware-2 + +então o comando + + jail-commit + +atualizará o template "slackware-1" de acordo com o conteúdo da jaula /mnt/slackware-1 e o template "slackware-2" +com o conteúdo da jaula /mnt/slackware-2. Se, além desses dois templates, existir um outro de nome "main", então +o jail-commit sem argumentos também copiará as atualizações da instalação raíz, deixando-as no template "main". + +Você pode inclusive colocar uma entrada no crontab do tipo + + 20 4 * * * jail-commit + +para que seus templates sejam atualizados diariamente. Se você ainda possui o envio de emails configurado na sua +máquina, então a saída do jail-commit será enviada pelo cron diariamente para seu email, contendo diffs das alterações +de arquivos de configuração a lista de pacotes adicionados ou removidos no sistema. Restaurando arquivos de configuração numa jaula ----------------------------------------------- - jail-update +A operação contrária ao que o jail-commit faz também é possível: suponha que você mexeu na configuração do sistema +mas se arrependeu das alterações e deseja voltar a configuração para o modo como ela se encontra no seu template, +basta usar o comando + + jail-update /mnt/hda2 meu-slackware Armazenando as configurações no repositório Subversion ------------------------------------------------------ +Para aumentar ainda mais a flexibilidade e o controle do conteúdo dos templates, é possível armazená-los num +repositório Subversion. Para isso, edite o arquivo /etc/simplepkg/simplepkg.conf e deixe o parâmetro de configuração +TEMPLATES_UNDER_SVN com o valor "yes". + +Depois, crie um repositório subversion para armazenar seus templates, usando algo como + svnadmin create /var/svn/simplepkg --fs-type fsfs + +Com o repositório criado, basta importar seus templates com o comando + templatepkg -e file:///var/svn/simplepkg - jail-commit - jail-commit --all +A partir daí, o comando jail-commit enviará automaticamente todas as alterações dos templates para o repositório +subversion. Se, por outro lado, você quiser baixar as alterações dos templates que estão no repositório remoto +para sua cópia local, use o comando + templatepkg -s Atualização de jaulas --------------------- -Existe ainda uma facilidade para que a obtenção e aplicação de atualizações seja feita de forma única, -através do arquivo /etc/simplepkg/jailist. Esse arquivo serve, além de outros propósitos descritos na -documentação do simplepkg, para que o simplaret saiba de antemão quais são as instalações de sistema -do tipo Slackware presentes numa máquina, além da instalação principal na raíz do sistema. Veja a -documentação do simplaret para mais detalhes. +A atualização de jaulas e sistemas instalados é feita através do simplaret e também utiliza o arquivo +/etc/simplepkg/jailist. Para mais informações a respeito, consulte a documentação do simplaret para mais detalhes. Arquiteturas e versões diferentes --------------------------------- @@ -246,7 +324,13 @@ conforme Criando um pacote de um template -------------------------------- +Se, por algum motivo, você quiser construir um pacote com o conteúdo de um template, experimente +o comando + templatepkg -p nome-do-template + +No entanto, o simplepkg foi criado para que esse tipo de comportamento seja evitado, já que é mais +simples manter templates de configuração do que pacotes contendo a configuração de uma instalação. Aplicativos auxiliares: rebuildpkg, createpkg, lspkg e repos ------------------------------------------------------------ -- cgit v1.2.3