Introdução à sua conta do GitHub

Este guia descreverá a configuração da sua conta do GitHub e uma introdução aos recursos de colaboração e comunidade do GitHub Enterprise Server.

Parte 1: Configurando sua conta de GitHub

As primeiras etapas para começar a usar o GitHub Enterprise Server são acessar sua conta, configurar a autenticação de dois fatores e ver seu perfil.

Toda pessoa que usar GitHub Enterprise Server terá sua conta pessoal e poderá fazer parte de várias organizações e equipes. Sua conta pessoal é a sua identidade no sua instância do GitHub Enterprise Server e representa você como indivíduo.

1. Como acessar sua conta

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

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

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

Para usar GitHub Enterprise Server 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 Enterprise Server, 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 Enterprise Server 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 Enterprise Server, 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 Enterprise Server 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 sua instância do GitHub Enterprise Server no Git, você precisará se autenticar no GitHub Enterprise Server usando HTTPS ou o SSH. Para saber mais, confira Sobre repositórios remote.

3. Como escolher como interagir com o GitHub Enterprise Server

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 Enterprise Server

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 Enterprise Server

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 Enterprise Server. Você pode pesquisar globalmente em todos os GitHub Enterprise Server 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 Enterprise Server, 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 Enterprise Server

Com GitHub Enterprise Server, 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 Enterprise Server

Qualquer quantidade de pessoas pode trabalhar juntas nos repositórios de GitHub Enterprise Server. É 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 Enterprise Server 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 Enterprise Server, 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

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

Use ferramentas do GitHub Marketplace, da API do GitHub Enterprise Server e os recursos existentes do GitHub Enterprise Server para personalizar e automatizar seu trabalho.

1. Usando o GitHub Enterprise ServerAPI

Há duas versões da API do GitHub Enterprise Server: a API REST e a API do GraphQL. Use as APIs do GitHub Enterprise Server para automatizar tarefas comuns, fazer backup dos seus dados ou criar integrações que estendem o GitHub Enterprise Server. Para obter mais informações, confira "Comparando a API REST do GitHub e a API GraphQL".

2. Como criar GitHub Actions

Com o GitHub Actions, você pode automatizar e personalizar o fluxo de trabalho de desenvolvimento do sua instância do GitHub Enterprise Server no GitHub Enterprise Server. 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".

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

GitHub Enterprise Server 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 Enterprise Server, 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.

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.