Este guia descreverá a configuração da sua conta do GitHub e uma introdução aos recursos de colaboração e comunidade do GitHub.
Parte 1: Configurando sua conta de GitHub
As primeiras etapas para começar a usar o GitHub são criar uma conta, escolher um produto que se adapte melhor às suas necessidades, confirmar seu email, configurar a autenticação de dois fatores e ver seu perfil.
Há vários tipos de contas no GitHub. Toda pessoa que usar GitHub terá sua conta pessoal e poderá fazer parte de várias organizações e equipes. Sua conta pessoal é a sua identidade no GitHub.com e representa você como indivíduo.
1. Como criar uma conta
Para se inscrever em uma conta, navegue até https://github.com/ e siga as solicitações.
Para manter a sua conta de GitHub segura, você deverá usar uma senha forte e exclusiva. Para saber mais, confira Criar uma senha forte.
2. Como escolher seu produto do GitHub
Você pode escolher GitHub Free ou GitHub Pro para obter acesso a diferentes recursos da sua conta pessoal. Você pode fazer a atualização a qualquer momento se não tiver certeza qual o produto você deseja.
Para obter mais informações sobre os planos do GitHub, confira Planos do GitHub.
3. Como confirmar seu endereço de email
Para garantir que você possa utilizar todos os recursos do seu plano de GitHub, verifique o seu endereço de e-mail após inscrever-se em uma nova conta. Para saber mais, confira Verificar endereço de e-mail.
4. Como configurar a autenticação de dois fatores
A autenticação de dois fatores, ou 2FA, é uma camada extra de segurança usada no logon em sites ou apps. É altamente recomendável que você configure a 2FA para a segurança da sua conta. Para saber mais, confira Sobre a autenticação de dois fatores.
Opcionalmente, depois de configurar a 2FA, adicione uma chave de acesso à sua conta para habilitar um logon seguro e sem senha. Confira Gerenciar suas chaves de acesso.
5. Como ver seu perfil e seu grafo de contribuição do GitHub
Seu perfil do GitHub conta às pessoas a história do seu trabalho por meio dos repositórios e dos gists que você fixou, as associações à organização que você optou por divulgar, as contribuições que você fez e os projetos que você criou. Para saber mais, confira Sobre seu perfil e Exibir contribuições no perfil.
Parte 2: Usando ferramentas e processos de GitHub
Para usar GitHub da melhor forma, você deverá configurar o Git. O Git é responsável por tudo relacionado ao GitHub que acontece localmente no computador. Para colaborar de forma efetiva em GitHub, você escreverá em problemas e pull requests usando o Markdown enriquecido de GitHub.
1. Como aprender a usar o Git
A abordagem colaborativa do GitHub para o desenvolvimento depende da publicação dos commits do repositório local para GitHub para que outras pessoas vejam, busquem e atualizem outras pessoas que usam o Git. Para obter mais informações sobre o Git, confira o guia Manual do Git. Para obter mais informações sobre o Git é usado no GitHub, confira Fluxo do GitHub.
2. Como configurar o Git
Se você planeja usar o Git localmente no seu computador, por meio da linha de comando, editor de IDE ou texto, você deverá instalar e configurar o Git. Para saber mais, confira Configurar o git.
Se você preferir usar uma interface visual, você poderá fazer o download e usar GitHub Desktop. GitHub Desktop vem empacotado com o Git. Portanto não há a necessidade de instalar o Git separadamente. Para saber mais, confira Introdução ao GitHub Desktop.
Depois de instalar o Git, você poderá conectar-se aos repositórios de GitHub a partir do seu computador local, independentemente de ser o seu próprio repositório ou a bifurcação de outro usuário. Ao se conectar a um repositório no GitHub.com no Git, você precisará se autenticar no GitHub usando HTTPS ou o SSH. Para saber mais, confira Sobre repositórios remote.
3. Como escolher como interagir com o GitHub
Todos têm seu próprio fluxo de trabalho único para interagir com GitHub; as interfaces e métodos que você usa dependem da sua preferência e do que funciona melhor para as suas necessidades.
Para obter mais informações sobre as diferentes abordagens para interagir com o GitHub e uma comparação das ferramentas que você pode usar, confira Conectando-se ao GitHub.
4. Gravação no GitHub
Para deixar sua comunicação clara e organizada nos problemas e pull requests, você pode usar o Markdown enriquecido GitHub para formatação, que combina uma sintaxe fácil de ler e fácil de escrever com algumas funcionalidades personalizadas. Para saber mais, confira Sobre gravação e formatação no GitHub.
Aprenda a usar o GitHub Flavored Markdown no curso Comunicação usando Markdown no GitHub Skills.
5. Pesquisa no GitHub
Nossa pesquisa integrada permite que você encontre o que você está procurando entre os muitos repositórios, usuários e linhas de código em GitHub. Você pode pesquisar globalmente em todos os GitHub ou limitar sua pesquisa a um repositório ou organização em particular. Para obter mais informações sobre os tipos de pesquisas que você pode fazer no GitHub, confira Sobre a pesquisa no GitHub.
Nossa sintaxe de pesquisa permite que você construa consultas usando qualificadores para especificar o que você deseja pesquisar. Para obter mais informações sobre a sintaxe de pesquisa a ser usada na pesquisa, confira Pesquisar no GitHub.
6. Como gerenciar arquivos no GitHub
Com GitHub, você pode criar, editar, mover e excluir arquivos no seu repositório ou em qualquer repositório ao qual você tenha acesso de gravação. Você também pode acompanhar o histórico de alterações de um arquvo linha por linha. Para saber mais, confira Gerenciar arquivos.
Parte 3: Colaborando em GitHub
Qualquer quantidade de pessoas pode trabalhar juntas nos repositórios de GitHub. É possível configurar configurações, criar projetos e gerenciar suas notificações para incentivar uma colaboração eficaz.
1. Como trabalhar com repositórios
Criar um repositório
Um repositório é como uma pasta para seu projeto. Você pode ter qualquer número de repositórios públicos e privados na sua conta pessoal. Os repositórios podem conter pastas e arquivos, imagens, vídeos, planilhas e conjuntos de dados, bem como o histórico de revisão para todos os arquivos no repositório. Para saber mais, confira Sobre repositórios.
Ao criar um novo repositório, você deverá inicializar o repositório com um arquivo README para que as pessoas conheçam o seu projeto. Para saber mais, confira Criar um repositório.
Clonar um repositório
Você pode clonar um repositório existente a partir de GitHub para o seu computador local, facilitando a adição ou remoção dos arquivos, correção de conflitos de merge ou realização de commits complexos. A clonagem de um repositório extrai uma cópia completa de todos os dados do repositório que o GitHub tem nesse momento, incluindo todas as versões de cada arquivo e pasta do projeto. Para saber mais, confira Clonar um repositório.
Bifurcar um repositório
Uma bifurcação é uma cópia de um repositório que você gerencia, em que todas as alterações que você fizer não afetarão o repositório original a menos que você envie um pull request para o proprietário do projeto. O uso mais comum das bifurcações são propostas de mudanças no projeto de alguma outra pessoa ou o uso do projeto de outra pessoa como ponto de partida para sua própria ideia. Para saber mais, confira Trabalhar com bifurcações.
2. Como importar seus projetos
Se você tiver projetos existentes que deseja mover para GitHub, você poderá importar projetos usando o Importador de GitHub Importer, a linha de comando ou as ferramentas externas de migração. Para saber mais, confira Como importar o código-fonte.
3. Como gerenciar colaboradores e permissões
Você pode colaborar em seu projeto com outras pessoas usando os problemas, as pull requests e os projects do repositório. Você pode convidar outras pessoas para seu repositório como colaboradores na guia Colaboradores nas configurações do repositório. Para saber mais, confira Convidar colaboradores para um repositório pessoal.
Você é o proprietário de qualquer repositório que você cria na sua conta pessoal e você tem controle total sobre repositório. Os colaboradores têm acesso de gravação ao seu repositório, limitando o que eles têm permissão para fazer. Para saber mais, confira Níveis de permissão para um repositório da conta pessoal.
4. Como gerenciar as configurações do repositório
Como proprietário de um repositório, você pode configurar diversas configurações, incluindo a visibilidade do repositório, tópicos e a pré-visualização das mídias sociais. Para saber mais, confira Gerenciando as configurações e funcionalidades do seu repositório.
5. Como configurar seu projeto para contribuições úteis
Para incentivar os colaboradores do seu repositório, você precisa ter uma comunidade que incentive as pessoas a usar, contribuir e divulgar seu projeto. Para obter mais informações, confira Como criar comunidades receptivas nos Guias de Código Aberto.
Ao adicionar arquivos como diretrizes de contribuição, um código de conduta e uma licença para o repositório é possível criar um ambiente em que seja mais fácil para os colaboradores fazerem contribuições úteis e significativas. Para saber mais, confira Configurar projeto para contribuições úteis.
6. Uso dos GitHub Issues e dos Projects
Você pode usar GitHub Issues para organizar seu trabalho com problemas e pull requests e gerenciar seu fluxo de trabalho com Projects. Para saber mais, confira Sobre issues e Sobre Projects.
7. Como gerenciar notificações
As notificações fornecem atualizações sobre as atividades do GitHub nas quais você se inscreveu ou participou. Se não estiver mais interessado em uma conversa, cancele a assinatura dela, deixe de acompanhar ou personalize os tipos de notificações que você receberá no futuro. Para saber mais, confira Sobre notificações.
8. Como trabalhar com o GitHub Pages
É possível usar as GitHub Pages para criar e hospedar um site diretamente por meio de um repositório em GitHub.com. Para saber mais, confira Sobre o GitHub Pages.
9. Como usar as GitHub Discussions
Você pode habilitar GitHub Discussions para o repositório ajudar a criar uma comunidade em torno do seu projeto. Mantenedores, colaboradores e visitantes podem usar discussões para compartilhar anúncios, fazer e responder a perguntas e participar de conversas sobre objetivos. Para saber mais, confira Sobre discussões.
Parte 4: Personalizando e automatizando seu trabalho em GitHub
Use ferramentas do GitHub Marketplace, da API do GitHub e os recursos existentes do GitHub para personalizar e automatizar seu trabalho.
1. Como usar o GitHub Marketplace
O GitHub Marketplace contém integrações que adicionam funcionalidade e aprimoram seu fluxo de trabalho. Você pode descobrir, procurar e instalar ferramentas gratuitas e pagas, incluindo GitHub Apps, OAuth apps e GitHub Actions, no GitHub Marketplace.
2. Usando o GitHub
Há duas versões da API do GitHub: a API REST e a API do GraphQL. Use as APIs do GitHub para automatizar tarefas comuns, fazer backup dos seus dados ou criar integrações que estendem o GitHub. Para obter mais informações, confira "Comparando a API REST do GitHub e a API GraphQL".
3. Como criar GitHub Actions
Com o GitHub Actions, você pode automatizar e personalizar o fluxo de trabalho de desenvolvimento do GitHub.com no GitHub. Você pode criar as suas próprias ações e usar e personalizar ações compartilhadas pela comunidade GitHub. Para obter mais informações, confira "Escrevendo fluxos de trabalho".
4. Como publicar e gerenciar o GitHub Packages
GitHub Packages é um serviço de hospedagem de pacotes de software que permite que você hospede os seus pacotes de software de forma privada ou pública e que você use os pacotes como dependências nos seus projetos. Para obter mais informações, confira "Introdução ao GitHub Packages".
Parte 5: Criando com segurança em GitHub
GitHub tem uma variedade de recursos de segurança que ajudam a manter códigos e segredos seguros nos repositórios. Algumas funcionalidades estão disponíveis para todos os repositórios, enquanto outras estão disponíveis apenas para repositórios públicos e repositórios com uma licença de GitHub Advanced Security. Para ter uma visão geral dos recursos de segurança do GitHub, confira Recursos de segurança do GitHub.
1. Como proteger seu repositório
Como administrador do repositório, você pode proteger os seus repositórios definindo as configurações de segurança do repositório. Elas incluem o gerenciamento de acesso ao seu repositório, a definição de uma política de segurança e o gerenciamento de dependências. Para repositórios públicos e para repositórios privados pertencentes a organizações em que o GitHub Advanced Security está habilitado, você também pode configurar o código e a digitalização de segredos para identificar automaticamente vulnerabilidades e garantir que os tokens e chaves não sejam expostos.
Para obter mais informações sobre as etapas que você pode executar para proteger seus repositórios, confira Guia de início rápido para proteger seu repositório.
2. Como gerenciar suas dependências
Uma grande parte da criação é manter as dependências do seu projeto para garantir que todos os pacotes e aplicativos dos quais você depende estejam atualizados e seguros. Você pode gerenciar as dependências do seu repositório em GitHub, explorando o gráfico de dependências para o seu repositório, usando o Dependabot para aumentar automaticamente os pull requests para manter as suas dependências atualizadas e receber alertas de dependência e atualizações de segurança para dependências vulneráveis.
Para saber mais, confira Proteger a sua cadeia de suprimentos de software.
Parte 6: Participando da comunidade de GitHub
Há várias maneiras de participar da comunidade do GitHub. Você pode contribuir com projetos de código aberto, interagir com as pessoas no GitHub Community Support ou aprender mais com o GitHub Skills.
1. Como contribuir para projetos de código aberto
Contribuir com projetos de código aberto no GitHub pode ser uma forma gratificante de aprender, ensinar e ganhar experiência em praticamente qualquer habilidade que você possa imaginar. Para obter mais informações, confira "Como contribuir com o código aberto" nos Guias de Código Aberto.
Você pode encontrar recomendações personalizadas para projetos e bons primeiros problemas com base em suas contribuições anteriores, favoritos e outras atividades em Explorar.GitHub. Para obter mais informações, confira "Encontrando maneiras de contribuir com o código aberto no GitHub".
2. Como interagir com o GitHub Community Support
Você pode se conectar com desenvolvedores de todo o mundo para fazer perguntas e responder a elas, aprender e interagir diretamente com a equipe do GitHub. Para começar a conversa, confira "GitHub Community Support".
3. Leitura sobre o GitHub no GitHub Docs
Leia a documentação que reflete os recursos disponíveis para você no GitHub. Para obter mais informações, confira "Sobre versões da Documentação do GitHub".
4. Aprendizagem com o GitHub Skills
Você pode aprender novas habilidades realizando projetos divertidos e realistas em um repositório próprio do GitHub com o GitHub Skills. Cada curso é uma lição prática criada pela comunidade do GitHub e ensinada por um bot amigável.
Para obter mais informações, confira "Recursos de aprendizagem Git e GitHub".
5. Como apoiar a comunidade de código aberto
O GitHub Sponsors permite que você faça um pagamento mensal recorrente a um desenvolvedor ou a uma organização que projeta, cria ou mantém projetos de código aberto dos quais você depende. Para obter mais informações, confira "Sobre o GitHub Sponsors".
6. Como entrar em contato com o Suporte do GitHub
O Suporte do GitHub pode ajudar a solucionar problemas que você encontra ao usar o GitHub. Para obter mais informações, confira "Sobre o suporte do GitHub".