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 a usar GitHub são acessar sua conta, configurar a autenticação de dois fatores e visualizar seu perfil.

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 sua instância do GitHub Enterprise Server e representa você como um indivíduo.

1. Como acessar sua conta

O administrador de sua GitHub Enterprise Server instância notificará você sobre como autenticar e acessar sua conta. O processo varia dependendo do modo de autenticação que eles configuraram para a instância.

2. 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.

3. 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 sua instância do GitHub Enterprise Server 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

Ao adicionar arquivos como diretrizes de contribuição, um código de conduta e recursos de suporte ao repositório, você pode criar um ambiente em que seja mais fácil para os colaboradores fazer contribuições significativas e úteis. 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.sua instância do GitHub Enterprise Server 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 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.

2. 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.

3. 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.

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.

Neste artigo