Este guia irá ajudar você a configurar sua conta de GitHub e dar os primeiros passos com as funcionalidades de GitHub para colaboração e comunidade.
Parte 1: Configurando sua conta de GitHub
Os primeiros passos para começar com GitHub são criar uma conta, escolher um produto que se adeque melhor às suas necessidades, verificar o seu e-mail, configurar a autenticação de dois fatores e verificar o seu perfil.
Existem vários tipos de contas em GitHub. Toda pessoa que usar GitHub terá sua própria conta de usuário e poderá fazer parte de várias organizações e equipes. A sua conta de usuário é sua identidade em GitHub.com e representa você como indivíduo.
1. Criar uma conta
Para se inscrever em uma conta em GitHub.com, acesse https://github.com/ e siga as instruções.
Para manter a sua conta de GitHub segura, você deverá usar uma senha forte e exclusiva. Para obter mais informações, consulte "Criar uma senha forte".
2. Escolhendo seu produto de 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 todos os planos de GitHub, consulte "Produtos de GitHubde".
3. Verificar endereço de e-mail
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 obter mais informações, consulte "Verificar o endereço de e-mail".
4. Configurando 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 obter mais informações, consulte "Sobre a autenticação de dois fatores".
5. Visualizando seu GitHub perfil e gráfico de contribuição
Seu perfil de GitHub conta a história do seu trabalho por meio dos repositórios e dos gists que você fixou, as associações da organização que você escolheu divulgar, as contribuições que você fez e os projetos que você criou. Para obter mais informações, consulte "Sobre o seu perfil" e "Visualizando as contribuições no seu 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. Aprendendo 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, consulte o guia "Manual do Git". Para obter mais informações sobre como Git é usado em GitHub, consulte "Fuxo de GitHub".
2. 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 obter mais informações, consulte "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 obter mais informações, consulte "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 conectar-se a a um repositório no GitHub.com do Git, você deveá efetuar a autenticação com GitHub usando HTTPS ou SSH. Para obter mais informações, consulte "Sobre repositórios remotos."
3. Escolhendo como interagir com 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 como efetuar a autenticação em GitHub com cada um desses métodos, consulte "Sobre autenticação em GitHub".
| Método | Descrição | Casos de uso |
|---|---|---|
| Acesse GitHub.com | Se você não precisar trabalhar com arquivos localmente, GitHub permite que você realize a maioria das ações relacionadas ao Gits diretamente no navegador, da criação e bifurcação de repositórios até a edição de arquivos e abertura de pull requests. | Esse método é útil se você quiser uma interface visual e precisar fazer mudanças rápidas e simples que não requerem trabalho local. |
| GitHub Desktop | O GitHub Desktop amplia e simplifica o fluxo de trabalho no GitHub.com com uma interface visual, em vez de comandos de texto na linha de comando. Para obter mais informações sobre como começar com GitHub Desktop, consulte "Primeiros passos com o GitHub Desktop". | Este método é melhor se você precisa ou deseja trabalhar com arquivos localmente, mas preferir usar uma interface visual para usar o Git e interagir com GitHub. |
| Editor de IDE ou de texto | Você pode definir um editor de texto padrão, curtir Atom ou Visual Studio Code para abrir e editar seus arquivos com o Git, usar extensões e ver a estrutura do projeto. Para obter mais informações, consulte "Associando editores de texto ao Git". | Isto é conveniente se você estiver trabalhando com arquivos e projetos mais complexos e quiser ter tudo em um só lugar, uma vez que os editores de texto ou IDEs muitas vezes permitem que você acesse diretamente a linha de comando no editor. |
| Linha de comando, com ou sem GitHub CLI | Para o controle e personalização mais granulares de como você usa o Git e interage com GitHub, você pode usar a linha de comando. Para obter mais informações sobre como usar comandos do Git, consulte "Folha de informações do Git. GitHub CLI é uma ferramenta separada de linha de comando separada que você pode instalar e que traz pull requests, problemas, GitHub Actions, e outros recursos de GitHub para o seu terminal, para que você possa fazer todo o seu trabalho em um só lugar. Para obter mais informações, consulte "GitHub CLI". | Isto é muito conveniente se você já estiver trabalhando na linha de comando, o que permite que você evite mudar o contexto, ou se você estiver mais confortável usando a linha de comando. |
| GitHub API | GitHub tem uma API REST e uma API do GraphQL que você pode usar para interagir com GitHub. Para obter mais informações, consulte "Primeiros passos com a API". | A API de GitHub seria muito útil se você quisesse automatizar tarefas comuns, fazer backup dos seus dados ou criar integrações que estendem GitHub. |
4. Escrevendo em 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 obter mais informações, consulte "Sobre gravação e formatação no GitHub".
Você pode aprender o Markdown enriquecido de GitHub com o curso "Comunicando-se usando o Markdown" em GitHub Learning Lab.
5. Pesquisando em 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 em GitHub, consulte "Sobre pesquisar 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 para usar na pesquisa, consulte "Pesquisando em GitHub".
6. Gerenciando arquivos em 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 obter mais informações, consulte "Gerenciar arquivos em GitHub".
Parte 3: Colaborando em GitHub
Qualquer quantidade de pessoas pode trabalhar juntas nos repositórios de GitHub. É possível configurar configurações, criar quadros de projetos e gerenciar suas notificações para incentivar uma colaboração eficaz.
1. Trabalhando 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 de usuário. 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 obter mais informações, consulte "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 obter mais informações, consulte "Criar um novo 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. Clonar 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 obter mais informações, consulte "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 obter mais informações, consulte "Trabalhando com as bifurcações".
2. Importar seus projetos
Se você tiver projetos existentes que deseja mover para GitHub, você poderá importar projetos usando o Importador de GitHub, a linha de comando ou as ferramentas externas de migração. Para obter mais informações, consulte "Importando código-fonte para GitHub".
3. Gerenciando colaboradores e permissões
Você pode colaborar em seu projeto com outras pessoas usando os problemas, as pull requests e os quadros de projeto do repositório. Você pode convidar outras pessoas para o seu repositório como colaboradores na aba Colaboradores nas configurações do repositório. Para obter mais informações, consulte "Convidar colaboradores para um repositório pessoal".
Você é o proprietário de qualquer repositório que você cria na sua conta de usuário 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 obter mais informações, consulte "Níveis de permissão para um repositório de conta de usuário".
4. Gerenciar 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 obter mais informações, consulte "Gerenciar configurações do repositório".
5. Configurar projeto para contribuições úteis
Para incentivar os colaboradores do seu repositório, você precisa de uma comunidade que incentive as pessoas a usar, contribuir e evangelizar o seu projeto. Para obter mais informações, consulte "Criando comunidades de bem-estar" 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 obter mais informações, consulte "Configurando seu projeto para Contribuições Úteis."
6. Usando os problemas e os quadros de projeto do GitHub
Você pode usar os problemas do GitHub para organizar seu trabalho com problemas e pull requests, bem como gerenciar seu fluxo de trabalho com quadros de projetos. Para obter mais informações, consulte "Sobre os problemas" e "Sobre os quadros de projeto".
7. Gerenciando notificações
As notificações fornecem atualizações sobre a atividade em GitHub que você assinou ou da qual você 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 obter mais informações, consulte "Sobre notificações".
8. Trabalhar com o GitHub Pages
Você pode usar GitHub Pages para criar e hospedar um site diretamente a partir de um repositório em GitHub.com. Para obter mais informações, consulte "Sobre GitHub Pages".
9. Usar 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 obter mais informações, consulte "Sobre discussões".
Parte 4: Personalizando e automatizando seu trabalho em GitHub
You can use tools from the GitHub Marketplace, the GitHub API, and existing GitHub features to customize and automate your work.
1. Usar GitHub Marketplace
GitHub Marketplace contains integrations that add functionality and improve your workflow. Você pode descobrir, navegar e instalar ferramentas gratuitas e pagas, incluindo aplicativo GitHubs, aplicativo OAuths, e GitHub Actions em GitHub Marketplace. Para obter mais informações, consulte "Sobre GitHub Marketplace".
2. Usando o GitHub
There are two versions of the GitHub API: the REST API and the GraphQL API. You can use the GitHub APIs to automate common tasks, back up your data, or create integrations that extend GitHub. For more information, see "About GitHub's APIs."
3. Criando GitHub Actions
With GitHub Actions, you can automate and customize GitHub.com's development workflow on 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, consulte "Aprenda GitHub Actions".
4. Publicando e gerenciando GitHub Package Registry
GitHub Package Registry é 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, consulte "Introdução a GitHub Package Registry".
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 Segurança Avançada GitHub. Para uma visão geral das funcionalidades de segurança de GitHub, consulte "Funcionalidades de segurança de GitHub".
1. Proteger o 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 Segurança Avançada GitHub 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 medidas que você pode tomar para proteger seus repositórios, consulte "Protegendo seu repositório".
2. Gerenciando 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 obter mais informações, consulte "Protegendo a cadeia de suprimentos do seu software".
Parte 6: Participando da comunidade de GitHub
There are many ways to participate in the GitHub community. You can contribute to open source projects, interact with people in the Suporte à Comunidade GitHub, or learn with GitHub Learning Lab.
1. Contribuindo para projetos de código aberto
Contributing to open source projects on GitHub can be a rewarding way to learn, teach, and build experience in just about any skill you can imagine. For more information, see "How to Contribute to Open Source" in the Open Source Guides.
You can find personalized recommendations for projects and good first issues based on your past contributions, stars, and other activities in Explore. For more information, see "Finding ways to contribute to open source on GitHub."
2. Interagindo com Suporte à Comunidade GitHub
You can connect with developers around the world in Suporte à Comunidade GitHub to ask and answer questions, learn, and interact directly with GitHub staff.
3. Lendo sobre GitHub em GitHub Docs
You can read documentation that reflects the features available to you on GitHub. Para obter mais informações, consulte "Sobre as versões do GitHub Docs."
4. Aprendendo com GitHub Learning Lab
You can learn new skills by completing fun, realistic projects in your very own GitHub repository with GitHub Learning Lab. Each course is a hands-on lesson created by the GitHub community and taught by the friendly Learning Lab bot.
Para obter mais informações, consulte "Git e recursos de aprendizado de GitHub. "
5. Apoiar a comunidade de código aberto
GitHub Sponsors allows you to make a monthly recurring payment to a developer or organization who designs, creates, or maintains open source projects you depend on. Para obter mais informações, consulte "Sobre GitHub Sponsors."
6. 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, consulte "Sobre Suporte do GitHub".