Pesquisa de site

Um guia para iniciantes para contribuir com o Apache Cassandra

Comece a participar de um projeto de banco de dados de código aberto usado para potencializar serviços de Internet em todo o mundo.

Apache Cassandra é um banco de dados NoSQL de código aberto confiável por milhares de empresas em todo o mundo por sua escalabilidade e alta disponibilidade que não compromete o desempenho. Contribuir para um sistema distribuído tão amplamente utilizado pode parecer assustador, por isso este artigo tem como objetivo fornecer um ponto de entrada fácil.

Existem bons motivos para contribuir com Cassandra, como:

  • Obtendo reconhecimento da Apache Software Foundation (ASF) como contribuidor
  • Contribuir para um projeto de código aberto usado por milhões de pessoas em todo o mundo que alimenta serviços de Internet para empresas como American Express, Bloomberg, Netflix, Yelp e muito mais
  • Fazer parte de uma comunidade adicionando novos recursos e aproveitando o lançamento do Cassandra 4.0, o mais estável na história do projeto

Como começar

Apache Cassandra é um grande projeto, o que significa que você encontrará algo dentro de seu conjunto de habilidades para contribuir. Cada contribuição, por menor que seja, conta e é muito apreciada. Um excelente lugar para começar é o guia de primeiros passos.

O projeto Apache Cassandra também participa do Google Summer of Code. Para ter uma ideia do que está envolvido, leia esta postagem no blog do membro do PMC Paolo Motta.

Escolha no que trabalhar

Os patches enviados podem incluir correções de bugs, alterações na base de código Java, melhorias nas ferramentas (Java ou Python), documentação, testes ou quaisquer outras alterações na base de código. Embora o processo de contribuição de código seja sempre o mesmo, a quantidade de trabalho e o tempo necessários para que um patch seja aceito depende do tipo de problema que você está abordando.

Rever os patches de outras pessoas é sempre apreciado. Para saber mais, leia a Lista de verificação de revisão. Se você é usuário do Cassandra e pode ajudar respondendo a algumas das perguntas da lista de usuários, isso é uma excelente contribuição.

A maneira mais simples de encontrar um ticket para trabalhar é pesquisar no Jira de Cassandra por problemas marcados como Frutas mais fáceis de alcançar. Usamos esse rótulo para sinalizar problemas que são boas tarefas iniciais para iniciantes. Se você não possui um login no Jira do ASF, você precisará se cadastrar.

Algumas maneiras fáceis de começar a se envolver incluem:

  • Testes: ao aprender sobre Cassandra, você pode adicionar ou melhorar testes, como CASSANDRA-16191. Você pode aprender mais sobre a estrutura de teste Cassandra em nossa página de testes. Testes adicionais e bugs relatados pelo Jira ou sugestões de melhorias são sempre bem-vindos.
  • Documentação: Isso nem sempre é algo fácil de alcançar, mas é muito importante. Aqui está um exemplo de tíquete: CASSANDRA-16122. Você pode encontrar mais informações sobre como contribuir para a documentação do Cassandra em nossa página Trabalhando na documentação.
  • Investigar ou corrigir bugs relatados: veja um exemplo: CASSANDRA-16151.
  • Responda às perguntas: Inscreva-se na lista de discussão dos usuários, procure perguntas para as quais você sabe a resposta e ajude outras pessoas respondendo. Consulte a página da Comunidade para obter detalhes sobre como se inscrever na lista de discussão.

Estas são apenas quatro maneiras de começar a ajudar o projeto. Se você quiser saber mais sobre sistemas distribuídos e contribuir de outras formas, consulte a documentação.

O que você precisa para contribuir com código

Para fazer contribuições de código, você precisará de:

  • SDK Java
  • Formiga Apache
  • Git
  • Pitão

Obtenha o código e teste

Obtenha o código com Git, trabalhe no tópico, use seu IDE preferido e siga o estilo de codificação Cassandra. Você pode aprender mais em nossa página de integração de construção e IDE.

$ git clone https://git-wip-us.apache.org/repos/asf/cassandra.git cassandra-trunk

Muitos contribuidores nomeiam suas filiais com base no número do ticket e na versão do Cassandra. Por exemplo:

$ git checkout -b CASSANDRA-XXXX-V.V
$ ant

Teste o ambiente:

$ ant test

Testando um banco de dados distribuído

Quando terminar, certifique-se de que todos os testes (incluindo o seu) sejam aprovados usando Ant, conforme descrito em Testes. Se você suspeitar que uma falha no teste não está relacionada à sua alteração, pode ser útil verificar o status do teste pesquisando o rastreador de problemas ou observando os resultados do CI para a versão upstream relevante.

Os conjuntos de testes completos levam muitas horas para serem concluídos, por isso é comum executar testes relevantes localmente antes de enviar um patch. Após o upload de um patch, o revisor ou committer pode ajudar a configurar trabalhos de CI para executar os conjuntos de testes completos.

Recursos adicionais para testar Cassandra incluem:

  • O repositório de testes distribuídos Cassandra. Você pode encontrar informações de configuração e pré-requisitos no arquivo README.
  • LEIA-ME do Cassandra Cluster Manager
  • Uma ótima postagem no blog da comunidade sobre abordagens para testar o Cassandra 4.0
  • Harry, uma ferramenta de teste fuzz para Apache Cassandra.

Enviando seu patch

Antes de enviar um patch, verifique se você segue as convenções de estilo de código do Cassandra. A maneira mais fácil de enviar seu patch é bifurcar o repositório Cassandra no GitHub e enviar seu branch:

$ git push --set-upstream origin CASSANDRA-XXXX-V.V

Envie seu patch publicando o link para sua ramificação recém-criada em seu ticket do Jira. Use o botão Enviar patch.

Para saber mais, leia a documentação completa sobre Contribuindo para Cassandra. Se você ainda tiver dúvidas, entre em contato com a comunidade de desenvolvedores.

O autor deseja agradecer à comunidade Apache Cassandra por suas incansáveis contribuições ao projeto, dedicação aos usuários do projeto e esforços contínuos para melhorar o processo de integração de novos colaboradores.

As contribuições e a dedicação de muitas pessoas ao projeto e à comunidade Apache Cassandra nos permitiram alcançar 4.0 – um marco significativo. Ao olharmos para o futuro e procurarmos incentivar novos contribuidores, queremos reconhecer os esforços de todos desde a sua criação, há mais de 12 anos. Não teria sido possível sem a sua ajuda. Obrigado!