Introdução à sua conta de GitHub

Este guia orientará você na configuração da sua conta GitHub e em como começar a usar os recursos de colaboração e comunidade do GitHub.

Parte 1: Configurando sua GitHub conta

As primeiras etapas para começar GitHub são criar uma conta, escolher um produto que melhor atenda às suas necessidades, verificar seu email, configurar a autenticação de dois fatores e exibir seu perfil.

Há vários tipos de contas em GitHub.

Cada pessoa que usa GitHub tem sua própria conta pessoal, que pode fazer parte de várias organizações e equipes. Sua conta pessoal é sua identidade em GitHub.com e representa você como um 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 sua GitHub conta segura, você deve usar uma senha forte e exclusiva. Para saber mais, confira Criar uma senha forte.

2. Escolhendo seu GitHub produto

Você pode escolher GitHub Free ou GitHub Pro obter acesso a diferentes recursos para sua conta pessoal. Você pode fazer a atualização a qualquer momento se não tiver certeza qual o produto você deseja.

Para mais informações sobre todos os planos de GitHub, consulte Planos do GitHub.

3. Como confirmar seu endereço de email

Para garantir que você possa usar todos os recursos em seu GitHub plano, verifique seu endereço de email depois de se inscrever em uma nova conta. Para saber mais, confira Verificar endereço de e-mail.

4. 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. Exibindo seu GitHub perfil e grafo de contribuição

Seu perfil GitHub mostra às pessoas a trajetória do seu trabalho por meio dos repositórios e gists que você fixou, das participações em organizações que você escolheu tornar públicas, das contribuições que você fez e dos projetos que você criou. Para saber mais, confira Sobre seu perfil e Exibir contribuições no perfil.

Parte 2: Usando as ferramentas e os processos de GitHub

Para melhor usar GitHub, você precisará configurar o Git. O Git é responsável por tudo relacionado ao GitHub que acontece localmente no seu computador. Para colaborar GitHubefetivamente, você escreverá em problemas e solicitações de pull usando GitHub o Flavored Markdown.

1. Como aprender a usar o Git

GitHubA abordagem colaborativa para o desenvolvimento depende da publicação de commits do seu repositório local em GitHub para que outras pessoas possam visualizá-los, obtê-los e atualizá-los usando o Git. Para obter mais informações sobre o Git, confira o guia Manual do Git. Para obter mais informações sobre como o Git é usado GitHub, consulte fluxo de 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, poderá baixar e usar GitHub Desktop. GitHub Desktop vem empacotado com o Git, portanto, não é necessário instalar o Git separadamente. Para saber mais, confira Introdução ao GitHub Desktop.

Depois de instalar o Git, você pode se conectar a repositórios GitHub a partir do seu computador local, seja ao seu próprio repositório ou ao fork de outro usuário. Ao se conectar a um repositório no GitHub.com Git, você precisará se autenticar usando GitHub HTTPS ou SSH. Para saber mais, confira Sobre repositórios remotos.

3. Escolhendo como interagir com GitHub

Cada pessoa tem seu próprio fluxo de trabalho para interagir com GitHub; as interfaces e os métodos que você usa dependem da sua preferência e do que funciona melhor para atender às suas necessidades.

Para obter mais informações sobre as diferentes abordagens para interagir com GitHub e uma comparação das ferramentas que você pode usar, consulte Conectando-se ao GitHub.

4. Escrevendo em GitHub

Para tornar sua comunicação clara e organizada em problemas e solicitações de pull, você pode usar GitHub o Flavored Markdown para formatação, que combina uma sintaxe fácil de ler e fácil de gravar com algumas funcionalidades personalizadas. Para saber mais, confira Sobre como escrever e formatar em GitHub.

Você pode aprender GitHub o Flavored Markdown com o curso Comunicar usando Markdown em GitHub Skills.

5. Pesquisando em GitHub

Nossa pesquisa integrada permite que você encontre o que está procurando entre os muitos repositórios, usuários e linhas de código.GitHub Você pode pesquisar globalmente em todo o GitHub ou limitar sua pesquisa a um repositório ou organização específica. Para obter mais informações sobre os tipos de pesquisas em GitHubque você pode fazer, consulte 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 Pesquisando em GitHub.

6. Gerenciamento de arquivos em GitHub

Com GitHub, você pode criar, editar, mover e excluir arquivos no seu repositório ou em qualquer repositório no qual você tenha permissão de gravação. Você também pode monitorar o histórico de alterações de um arquivo linha por linha. Para saber mais, confira Gerenciar arquivos.

Parte 3: Colaborando em GitHub

Qualquer quantidade de pessoas pode trabalhar juntas em repositórios em 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 de GitHub para o seu computador local, o que facilita adicionar ou remover arquivos, corrigir conflitos de mesclagem ou fazer commits complexos. A clonagem de um repositório retira uma cópia completa de todos os dados do repositório que GitHub têm naquele 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

Um fork é uma cópia de um repositório que você gerencia, onde quaisquer alterações que você fizer não afetarão o repositório original, a menos que você envie um pull request ao 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ê tem projetos existentes que gostaria de migrar para GitHub, pode importá-los usando o GitHub Importer, a linha de comando ou 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 do repositório, solicitações de pull e projetos. 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, mas o que eles podem fazer é limitado. Para saber mais, confira Níveis de permissão para um repositório de 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 os recursos do repositório.

5. Como configurar seu projeto para contribuições úteis

Para incentivar os colaboradores em seu repositório, você precisa de uma comunidade que incentive as pessoas a usar, contribuir e evangelizar 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 seu projeto para contribuições saudáveis.

6. Usando GitHub Issues e Projects

Você pode usar GitHub Issues para organizar seu trabalho com issues e pull requests e usar Projects para gerenciar seu fluxo de trabalho. Para saber mais, confira Sobre problemas e Sobre Projects.

7. Como gerenciar notificações

As notificações fornecem atualizações sobre a atividade GitHub na qual 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. Trabalhando com GitHub Pages

Você pode usar GitHub Pages para criar e hospedar um site diretamente de um repositório.GitHub.com Para saber mais, confira O que é GitHub Pages?.

9. Usando GitHub Discussions

Você pode habilitar GitHub Discussions para o seu repositório para 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

Você pode usar as ferramentas do GitHub Marketplace, a API do GitHub e os recursos existentes do GitHub para personalizar e automatizar seu trabalho.

1. Usando 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 a GitHub API

Há duas versões da API do GitHub: a API REST e a API do GraphQL. Você pode usar as APIs do GitHub para automatizar tarefas comuns, fazer backup dos seus dados ou criar integrações que estendem o GitHub. Para saber mais, confira Comparando a API REST do GitHub e a API do GraphQL.

3. Edifício GitHub Actions

Com o GitHub Actions, você pode automatizar e personalizar o fluxo de trabalho de desenvolvimento da sua empresa no GitHub. Você pode criar suas ações, além de usar e personalizar ações compartilhadas pela comunidade do GitHub. Para saber mais, confira Escrevendo fluxos de trabalho.

4. Publicando e gerenciando 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 saber mais, confira Introdução ao GitHub Packages.

Parte 5: Desenvolvendo com segurança no GitHub

GitHub tem uma variedade de recursos de segurança que ajudam a manter o código e os segredos seguros em repositórios. Alguns recursos estão disponíveis para todos os repositórios, enquanto outros estão disponíveis apenas para repositórios públicos e repositórios com uma GitHub Code Security ou GitHub Secret Protection licença. Para ter uma visão geral dos recursos de segurança, confira GitHub recursos de segurança.

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 repositórios privados pertencentes a organizações com licenças para os recursos, você também pode configurar a verificação de código e segredo para identificar automaticamente vulnerabilidades e garantir que 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 de construir de forma segura é gerenciar as dependências do seu projeto, assegurando 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 grafo de dependências do seu repositório, usando o Dependabot para criar pull requests automaticamente e manter suas dependências atualizadas, além de receber alertas do Dependabot e atualizações de segurança para dependências vulneráveis.

Para saber mais, confira Protegendo sua cadeia de suprimentos.

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. Contribuindo 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 saber mais, 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 o GitHub. Para saber mais, confira Encontrar maneiras de contribuir para open source no GitHub.

Introdução ao GitHub Team

Introdução à sua conta de GitHub

Neste artigo