From 0ca0085bfd15c4db4ec12de4cd0684f2fe096e95 Mon Sep 17 00:00:00 2001 From: rhatto Date: Tue, 22 May 2007 22:51:48 +0000 Subject: updating pt_BR docs git-svn-id: svn+slack://slack.fluxo.info/var/svn/simplepkg@371 04377dda-e619-0410-9926-eae83683ac58 --- trunk/doc/README.pt_BR | 198 +++++++++++++++++++++++++++++++++++-------------- 1 file changed, 143 insertions(+), 55 deletions(-) diff --git a/trunk/doc/README.pt_BR b/trunk/doc/README.pt_BR index fc03e94..f5d73db 100644 --- a/trunk/doc/README.pt_BR +++ b/trunk/doc/README.pt_BR @@ -4,21 +4,16 @@ Simplepkg: gerenciamento de instala Autor: Silvio Rhatto Licença: GPL -O simplepkg é um sistema de gerenciamento de pacotes que roda sobre o pkgtool. Ele é composto -por vários scripts que desempenham funções de administração e desenvolvimento de sistemas -do tipo Slackware, procurando fechar um circuito de produção, envolvendo a construção, a -instalação de pacotes e até mesmo a instalação do sistema de forma automatizada. +O simplepkg é um sistema de gerenciamento de sistemas slackware que roda sobre o pkgtool. +Ele é composto por vários scripts que desempenham funções de administração e desenvolvimento de +sistemas do tipo Slackware, procurando fechar um circuito de produção, envolvendo a construção, +a instalação de pacotes e até mesmo a instalação do sistema de forma automatizada. Do lado do desenvolvedor/a, ele ajuda na criação de SlackBuilds e construção de pacotes. Do lado do administrador/a, ele possibilita a instalação automatizada de sistemas, instalação de pacotes e a criação de "templates" de instalação -- que contém todos os arquivos de configuração, informações de permissões e scripts de pós-instalação de uma dada máquina ou jaula. -Ele trabalha com templates -- listas com pacotes instalados, scripts e arquivos de configuração --- permitindo criar perfis de instalação que podem ser então usados para instalar o sistema numa -outra partição, criar um chroot específico ou até trabalhar com o conceito de metapacotes: uma -lista de pacotes que pode ser instalada e removida com apenas um comando. - Documentação ------------ @@ -46,13 +41,17 @@ comando instalar o template numa parti para obter pacotes de um repositório local ou remoto. Gerenciar instalações e pacotes não é tudo o que o simplepkg faz. Ele pode ser usado até na -criação de jaula e vservers. +criação de jaula e vservers, podendo manter toda a configuração das máquinas num repositório +Subversion. + +O simplepkg funciona não apenas com o Slackware mas com qualquer port (oficial ou não) que +siga minimamente os padrões oficiais. Arquitetura ----------- -O simplepkg é um conjunto de scripts escritos com a filosofia KISS em mente. Ele é um sistema muito -simples, composto pelos seguintes comandos: +O simplepkg é um conjunto de scripts escritos com a filosofia KISS (Keep It Simple, Stupid) em mente. +Ele é um sistema muito simples, composto pelos seguintes comandos: - mkjail: constrói uma jaula/instalação de slackware numa pasta - templatepkg: criar ou adiciona pacotes a um template @@ -61,74 +60,158 @@ simples, composto pelos seguintes comandos: - jail-commit: atualiza o template - rebuildpkg: reconstrói um pacote a partir de sua entrada no /var/log/packages - simplaret: obtém pacotes de repositórios locais ou remotos - - createpkg: baixa, compila e empacota software de acordo com http://slack.sarava.org/slackbuilds + - createpkg: baixa, compila e empacota software de acordo com scripts presentes num repositório - repos: cria e mantém repositórios - mkbuild: cria scripts de construção de pacotes Instalando o simplepkg ---------------------- -Para baixar o pacote do simplepkg, vá em http://slack.sarava.org/packages/noarch/. +Para baixar o pacote do simplepkg, vá em http://slack.sarava.org/packages/noarch/. Depois, basta usar +o comando installpkg simplepkg-VERSAO-noarch-BUILD.tgz +Usando o simplepkg +------------------ + +As três principais aplicações desse conjunto são: + + - Gerenciamento de pacotes + - Criação e manutenção de jaulas + - Criação de pacotes + +O gerencamento de pacotes é feito através do simplaret, e por ser algo bem específico está detalhado +no artigo correspondente. As seções a seguir mostrarão como o simplepkg pode ser utilizado para criar +e manter jaulas, assim como também criar pacotes. + +Criando templates de instalação +------------------------------- + +Originalmente, o simplepkg foi desenvolvido para ajudar na automatização de instalações de sistemas +slackware. Para isso, ele trabalha com templates -- listas com pacotes instalados, scripts e arquivos +de configuração -- permitindo criar perfis de instalação que podem ser então usados para instalar o +sistema numa outra partição ou criar um chroot. + +A construção de um template é feita através do programa templatepkg. Para criar um template de nome +"meu-slackware" contendo a lista de pacotes atualmente instalados no seu sistema, digite + + templatepkg -c meu-slackware + +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 + +Esses três 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. + +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 + + 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 + + templatepkg -a meu-slackware /etc/hosts + +Isso adicionará o arquivo /etc/hosts no template "meu-slackware". Além de salvar o arquivo e copiá-lo +automaticamente quando você instalar seu sistema, o simplepkg ainda pode tomar conta de qualquer alteração +que o /etc/hosts sofrer no sistema, seja mudança no conteúdo do arquivo, dono ou permissão. Se você ainda +estiver armazenando seus templates num repositório svn (o que veremos a seguir), o simplepkg pode ainda +manter um histórico completo das alterações do arquivo. + +ATENÇÂO: evite ao máximo deixar arquivos contendo senhas ou chaves privadas num template. O lugar mais +adequado para deixar esse tipo de coisa é num backup seguro. + Criando jaulas e replicando instalações --------------------------------------- - templatepkg meu-slackware - mkjail jaula meu-slackware +Uma vez que um template foi criado com uma lista de pacotes e opcionalmente com arquivos de configuração +e scripts de pós-instalação (que serão detalhados a seguir), você pode replicar sua instalação de slackware +utilizando o comando -Isso cria o template meu-slackware a partir da sua lista de pacotes em /var/log/packages e cria uma nova árvore -com esses pacotes na pasta /vservers/jaula (dependendo de qual o valor da variável JAIL_ROOT do simplepkg.conf, é claro). + mkjail jaula meu-slackware -Se você quiser que alguns arquivos de configuração e executar scripts após a instalação dessa jaula, basta colocarmos na -pasta /etc/simplepkg/meu-slackware.d/ os arquivos de configuração (dentro da hierarquia de pastas do sistema, isto é, -/etc/simplepkg/meu-slackware.d/etc/apache/httpd.conf) e os script em /etc/simplepkg/meu-slackware.s/. O template vserver, -que já vem no mkjail contém um exemplo de script. +Isso cria uma nova árvore do slackware em /vserver/jaula contendo todos os pacotes e arquivos de configuração +do template "meu-slackware". A instalação dos pacotes será feita pelo aplicativo simplaret, que deve estar +configurado corretamente e cuja configuração padrão deve funcionar para a maioria dos casos. -Você pode especificar também destinos alternativos para sua jaula, através de um comando do tipo +Se você quiser instalar essa jaula em outro local que não seja a pasta /vservers (esse local padrão pode ser +mudado pelo arquivo de configuração do simplepkg), basta usar um comando do tipo ROOT=/mnt mkjail hda2 meu-slackware -O comando acima faz exatamente o que você está pensando: replica sua instalação slackware em /mnt/hda2, dispensando -totalmente o programa de instalação do slackware! +O comando acima faz exatamente o que você está pensando: replica sua instalação slackware em /mnt/hda2, +dispensando totalmente o programa de instalação do slackware! -Caso nenhum template for especificado, o mkjail utiliza o template /etc/simplepkg/default.template. +Caso nenhum template for especificado, o mkjail utiliza o template /etc/simplepkg/default. O simplepkg já vem +com alguns templates padrões, presentes em /etc/simplepkg/defaults/template. -Se você manter uma jaula em JAIL_ROOT com o mesmo nome que um template, é possível ainda usar o script jail-update -para copiar todas as alterações de arquivos da jaula na pasta de arquivos do seu template (/etc/simplepkg/nome-da-jaula.d). -Assim, basta que você copie todos os arquivos de configuração que você editou para essa pasta e deixar o jail-update numa -crontab para que você tenha sempre um template atualizado e baseado nas jaulas / instalações que você tem rodando e que -estiverem listadas no arquivo /etc/simplepkg/jailist: +Scripts de pós-instalação +------------------------- - jail-update - -Para adicionar ou remover pacotes de um template, basta editar o arquivo de template. Uma outra forma de adicionar -arquivos é usando o templatepkg com a opção -a, que adiciona apenas novos pacotes ao template. Se você quiser que o -templatepkg crie um template a partir de uma jaula, simplesmente use + templatepkg -b nome-do-script.sh - templatepkg jaula /vservers/jaula - -Upgrade de jaulas ------------------ +Listando o conteúdo de um template +---------------------------------- + + templatepkg -l -O upgrade de jaulas que estejam em JAIL_ROOT pode ser efetuado com o comando jail-upgrade. Simplesmente coloque -os patches em PATCHES_DIR e dê o comando +Removendo arquivos de um template +--------------------------------- - jail-upgrade + templatepkg -d -Se você quiser atualizar apenas uma das jaulas que estão em JAIL_ROOT, use +Apagando um template +-------------------- - jail-upgrade nome-da-jaula - -Para especificar uma pasta contendo patches diferente de PATCHES_DIR (útil quando você possui jaulas com -diferentes versões do slackware), simplesmente use + templatepkg -r - PATCHES=/local/dos/patches jail-upgrade nome-da-jaula - -De modo análogo ao mkjail, é possível indicar ao jail-upgrade uma outra pasta onde a jaula está armazenada: +Atualizando um template +----------------------- + + jail-commit + +Para atualizar apenas a lista de pacotes de um template, use + + templatepkg -u meu-template + +Editando manualmente a lista de pacotes +--------------------------------------- - ROOT=/otherroot jail-upgrade + templatepkg -e nome-do-template + +Restaurando arquivos de configuração numa jaula +----------------------------------------------- + + jail-update + +Armazenando as configurações no repositório Subversion +------------------------------------------------------ + + svnadmin create /var/svn/simplepkg --fs-type fsfs + templatepkg -e file:///var/svn/simplepkg + + jail-commit + jail-commit --all + 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. Arquiteturas e versões diferentes --------------------------------- @@ -159,9 +242,14 @@ da arquitetura e vers Desse modo, mesmo que você tenha jaulas de versões e arquiteturas diversas, usar o comando "jail-upgrade" faz a atualização sem problemas, desde que seus patches estejam organizados por arquitetura e versão, conforme é detalhado na documentação do simplaret, em http://slack.sarava.org/node/16. + +Criando um pacote de um template +-------------------------------- + + templatepkg -p nome-do-template -Aplicativos auxiliares: rebuildpkg e createpkg ----------------------------------------------- +Aplicativos auxiliares: rebuildpkg, createpkg, lspkg e repos +------------------------------------------------------------ O simplepkg acompanha ainda um aplicativo auxiliar que ajuda a recuperar pacotes instalados cujo tgz original foi perdido. O comando rebuildpkg reconstrói um pacote a partir de uma entrada no /var/log/packages. O comando @@ -179,7 +267,7 @@ http://slack.sarava.org/slackbuilds, basta utilizar o createpkg: Parâmetros de configuração -------------------------- -A escrever... + /etc/simplepkg/simplepkg.conf Fonte ----- -- cgit v1.2.3