Linux / Comando apt-get: simular e revisar mudanças de pacotes

O comando apt-get instala, remove e atualiza pacotes em sistemas Debian e Ubuntu e é uma escolha apropriada para automação com APT. Use -s para examinar uma simulação antes de alterar o sistema; -y aceita perguntas automaticamente e exige uma decisão prévia sobre o plano.

Um pacote reúne software e informações sobre suas dependências, os outros pacotes de que precisa. O APT usa índices dos repositórios configurados para selecionar versões e resolver essas dependências. update renova os índices; upgrade atualiza programas instalados. O apt voltado ao uso interativo oferece operações semelhantes, mas suas opções padrão e sua interface não são idênticas às do apt-get.

Sintaxe básica e requisitos

apt-get [opções] comando [pacotes...]

Essa linha descreve a sintaxe; substitua os nomes indicativos pela operação e pelos pacotes reais. Confira a distribuição com cat /etc/os-release, a versão do APT com apt-get --version e as opções locais com man apt-get. Os exemplos pressupõem um sistema Debian ou Ubuntu com fontes de pacotes configuradas.

Tenha conectividade com essas fontes, espaço disponível e cópias dos dados e configurações importantes antes de instalar, remover ou atualizar. As alterações reais e a atualização dos índices normalmente exigem privilégios de administrador, representados por sudo nos exemplos. Uma simulação pode ser consultada sem esses privilégios, com as limitações explicadas adiante.

Exemplos de atualização e instalação

Renovar a lista dos repositórios

Obtenha os índices atuais das fontes já configuradas:

sudo apt-get update

A operação renova informações sobre os candidatos à instalação, mas não atualiza, por si só, os programas já instalados. Leia erros e avisos de download ou de assinatura. Uma fonte que não pôde ser consultada pode deixar informação antiga disponível; não considere o catálogo inteiro atualizado apenas porque outras fontes responderam.

Examinar uma atualização sem aplicá-la

Confira a proposta para os pacotes instalados:

apt-get -s upgrade

No comportamento padrão documentado, apt-get upgrade não remove pacotes nem acrescenta pacotes ainda não instalados. Uma atualização que exija essas mudanças pode ficar retida. Isso difere de apt upgrade, que pode instalar dependências novas. Leia o plano e os pacotes mantidos; uma retenção não é motivo para escolher automaticamente uma operação que permita remoções.

Instalar curl após revisar o plano

O curl é uma ferramenta de transferência de dados por linha de comando. Se a instalação é desejada, execute sem aprovação automática:

sudo apt-get install curl

Confira os pacotes adicionais, as atualizações ou remoções propostas e os tamanhos de download e de ocupação do disco antes de confirmar. install também pode atualizar um pacote já instalado. Se a seleção não for a esperada, recuse a confirmação e investigue; não acrescente -y apenas para eliminar a pergunta.

Para conferir a candidata antes da alteração, use apt-cache policy curl. Após a conclusão, dpkg-query -s curl permite consultar o estado registrado localmente, e curl --version informa qual programa é encontrado pelo seu shell. A existência de um executável no caminho de busca não comprova, sozinha, que ele veio do pacote que você acabou de instalar.

Simular uma instalação e interpretar a saída

A opção -s, também chamada --simulate, apresenta operações previstas sem instalar ou remover pacotes:

apt-get -s install curl

Exemplo apenas do formato de algumas linhas, sem uma versão real fixada:

Inst curl (...)
Conf curl (...)

Inst representa o desempacotamento previsto de um pacote, que pode ser uma instalação ou atualização. Conf indica configuração, e linhas Remv, quando presentes, indicam remoção. Os pontos entre parênteses omitem detalhes ilustrativos: versões, dependências e até a presença dessas linhas variam conforme o sistema; se o pacote já estiver atualizado, essa sequência pode nem aparecer.

A simulação depende do catálogo e do estado existentes naquele momento. Ela não impede que outro processo altere os pacotes enquanto você analisa a proposta. Além disso, um usuário sem privilégios pode não conseguir ler toda a configuração do APT; o próprio programa pode avisar que a simulação tem essa limitação. Releia o plano da operação real antes da confirmação, mesmo após uma simulação aceitável.

1. Renove os índices e resolva os erros das fontes antes de usar os candidatos exibidos para decidir uma alteração.
2. Consulte a versão candidata e simule a operação desejada, usando o mesmo pacote e as opções que pretende aplicar.
3. Leia cada instalação, atualização, retenção e remoção relevante, além do resumo. Confira efeitos sobre serviços e espaço em disco.
4. Faça a alteração real somente após essa avaliação; ao terminar, confira o código de saída, o estado instalado e o funcionamento esperado. Uma simulação não verifica a execução futura dos scripts dos pacotes nem garante que o download posterior terá sucesso.

Operações e opções principais

Para apt-get, o manual documenta dist-upgrade como operação que permite resolver mudanças de dependências com possíveis remoções; apt full-upgrade tem papel semelhante na interface apt. Não confunda essa diferença de interface com a troca de versão da distribuição: uma migração de lançamento exige o procedimento próprio da distribuição, não apenas executar um comando de atualização.

Cuidados com scripts e aprovação automática

O manual recomenda ferramentas dedicadas como apt-get e apt-cache para scripts, em vez de depender da apresentação interativa do apt. Essa preferência não dispensa verificar as opções da versão instalada e tratar falhas. A documentação de apt-get define 0 para a operação normal e 100 para erro; capture o resultado imediatamente, antes de outro comando substituí-lo.

Uma sequência como sudo apt-get update && apt-get -s install curl só inicia a simulação se o primeiro comando retornar sucesso. Isso não garante que todas as fontes foram renovadas: leia os avisos. Nas versões que oferecem --error-on=any, sudo apt-get --error-on=any update permite tratar também erros transitórios de atualização como falha. Confira essa opção no manual local antes de usá-la em um script.

A opção -y não garante que qualquer operação será concluída sem intervenção. O manual descreve situações protegidas que provocam a interrupção, como certas mudanças em pacotes retidos ou essenciais e a tentativa de instalar pacotes não autenticados. Preserve essas proteções; não desative a verificação de assinatura para contornar um problema de repositório.

Antes de alterações em máquinas que oferecem serviços, prepare cópias e uma janela de manutenção que considere possíveis reinicializações. Remover um pacote não desfaz necessariamente todos os efeitos de sua instalação, nem restaura dados e configurações anteriores; a recuperação depende do material preservado e do procedimento da aplicação. Examine a proposta de dist-upgrade com atenção especial às remoções.

Pergunta frequente

É obrigatório usar apt-get em vez de apt?

Não. O apt é conveniente para uso interativo. Para automação, a documentação recomenda priorizar ferramentas dedicadas como apt-get e apt-cache, cuja compatibilidade é mais adequada a esse uso. Revise as opções padrão, pois comandos parecidos podem ter comportamentos diferentes, como ocorre com upgrade.

Documentação oficial

Consulte o manual do apt-get publicado pelo Debian para as operações, a simulação e os códigos de saída, e o manual do apt sobre diferenças entre interfaces e uso em scripts. A página man apt-get do sistema mostra as opções da versão instalada.