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 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 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 sua instância do GitHub Enterprise Server e representa você como indivíduo.
1. Acessando a 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. 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".
3. Visualizando seu GitHub Enterprise Server perfil e gráfico de contribuição
Seu perfil de GitHub Enterprise Server 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 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. 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 Enterprise Server 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 Enterprise Server, 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 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. Quando você se conecta a um repositório do GitHub Enterprise Server a partir do Git, precisa fazer a autenticação no GitHub Enterprise Server usando HTTPS ou SSH. Para obter mais informações, consulte "Sobre repositórios remotos."
3. Escolhendo como interagir com 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 como efetuar a autenticação em GitHub Enterprise Server 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 Enterprise Server 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 Enterprise Server. |
| 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 Enterprise Server, 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. |
| API de GitHub | GitHub tem uma API REST e uma API do GraphQL que você pode usar para interagir com GitHub Enterprise Server. Para obter mais informações, consulte "Primeiros passos com a API". | A API do 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 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 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 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 em GitHub Enterprise Server, 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 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 obter mais informações, consulte "Gerenciar arquivos em GitHub".
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 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 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. 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 Enterprise Server, 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
Ao adicionar 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 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 Enterprise Server 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 de um repositório do GitHub Enterprise Server. For more information, see "About GitHub Pages."
Parte 4: Personalizando e automatizando seu trabalho em GitHub Enterprise Server
You can use tools from the GitHub Marketplace, the GitHub Enterprise Server API, and existing GitHub Enterprise Server features to customize and automate your work.
1. Usando a API deGitHub
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 Enterprise Server. For more information, see "About GitHub's APIs."
2. Criando GitHub Actions
With GitHub Actions, you can automate and customize sua instância do GitHub Enterprise Server's development workflow on 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, consulte "Aprenda GitHub Actions".
3. 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. For more information, see “Introduction to GitHub Package Registry."
Parte 5: 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.
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 Enterprise Server staff.
3. 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.
For more information, see “Git and GitHub learning resources."