Pular para conteúdo

Guia

Estamos felizes em tê-lo(a) a bordo! Este guia foi elaborado para ajudá-lo(a) a dar os primeiros passos no mundo do empacotamento Debian, fornecendo recursos essenciais e orientações práticas.

O que é o Empacotamento Debian?

Empacotar no Debian significa criar pacotes que permitem que softwares sejam instalados, atualizados e removidos de forma eficiente em sistemas Debian. O processo envolve a criação de arquivos de controle, scripts de instalação e a configuração adequada para garantir que o software funcione corretamente dentro do ecossistema Debian.

Para uma introdução detalhada, consulte o guia Empacotamento 101.

Recursos de Aprendizado

Requisitos Básicos

Preparando seu Ambiente

Antes de começar, é importante configurar seu ambiente de desenvolvimento:

  1. Instale as ferramentas necessárias: 

    sudo apt update
sudo apt install build-essential devscripts lintian

  2. Configure seu ambiente Git: 

    git config --global user.name "Seu Nome"
git config --global user.email "seuemail@example.com"

  3. Crie uma conta no Salsa: Acesse https://salsa.debian.org e crie uma conta. O Salsa é a plataforma de hospedagem de código do Debian.(Cada conta criada tem que ser aprovada manualmente, o que leva em tono de 2 á 5 dias, caso sua conta seja rejeitada tente criar denovo e entre em contato com outros membros da Debian-Brasil para te ajudar)

  4. Familiarize-se com o git-buildpackage: Esta ferramenta facilita o processo de construção de pacotes Debian a partir do código-fonte.

Como Contribuir

  1. Escolha um pacote: Consulte a lista de pacotes que precisam de manutenção ou que você gostaria de empacotar.

  2. Crie um fork: No Salsa, faça um fork do repositório do pacote escolhido.

  3. Empacote o software: Siga as diretrizes do Debian para criar o pacote.

  4. Submeta uma Merge Request: Após empacotar, submeta uma Merge Request para revisão.

  5. Revisão e Upload: Um mantenedor revisará seu pacote e, se aprovado, fará o upload para os repositórios oficiais do Debian.

Para detalhes completos, consulte o guia Empacotamento 101.

Diretrizes de Empacotamento

  • Garanta que todos os pacotes estejam em conformidade com a política Debian vigente.
  • Sempre rode lintian no pacote antes de abrir um Pull Request: 
    lintian ../nomedopacote_version_arch.changes
  • Utilize versionamento semântico (X.Y.Z) no debian/changelog.
  • Atualize o arquivo debian/changelog com as suas alterações:
  • Use o formato do dch: 
    dch -i "Descrição breve da alteração."

Checklist antes de enviar um Pull Request

  • O pacote constrói sem erros (dpkg-buildpackage -us -uc).
  • O pacote passou nas verificações do lintian.
  • O debian/changelog foi atualizado.
  • O código está documentado quando aplicável.
  • Os commits seguem a convenção abaixo.

Padrão de Commits

Adotamos um formato simplificado baseado no Conventional Commits:

tipo(pacote): descrição curta

Tipos aceitos: - feat: Nova funcionalidade de empacotamento - fix: Correção de problema no pacote - docs: Alterações de documentação - chore: Atualizações menores (ex: ajustes de CI, formatação) - refactor: Melhorias de estrutura sem mudar funcionalidade

Exemplos: 

feat(meu-pacote): adicionar suporte ao Debian Bookworm
fix(outro-pacote): corrigir dependência faltante no control
docs: atualizar guia de empacotamento

Código de Conduta

Todos os contribuidores devem seguir nosso Código de Conduta. A colaboração respeitosa e inclusiva é obrigatória.

Dúvidas ou Problemas?

  • Para dúvidas técnicas, abra uma Discussion ou uma Issue com a label question.
  • Para problemas específicos no empacotamento, crie uma Issue descrevendo o erro encontrado.
  • Para ajuda geral, consulte os materiais do Debian Brasil.

Recursos Importantes

Como Entrar em Contato

Se tiver dúvidas ou precisar de ajuda, entre em contato com os membros do Debian-Brasil: