Este guia descreverá a configuração da sua conta do GitHub e uma introdução aos recursos de colaboração e comunidade do GitHub AE.
Parte 1: Configurando sua conta de GitHub
As primeiras etapas para começar a usar o GitHub AE são acessar sua conta e ver seu perfil.
Toda pessoa que usar GitHub AE terá sua conta pessoal e poderá fazer parte de várias organizações e equipes. Sua conta pessoal é a sua identidade no sua empresa e representa você como indivíduo.
1. Como acessar sua conta
Você receberá uma notificação por e-mail assim que o proprietário corporativo de GitHub AE tiver configurado a sua conta permitindo que você efetue a autenticação com o SSO (logon único) do SAML e acesse sua conta.
2. 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 obter mais informações, confira "Sobre seu perfil" e "Exibir contribuições no perfil."
Parte 2: Usando ferramentas e processos de GitHub AE
Para usar GitHub AE 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 AE, 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 AE 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 AE, 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 obter mais informações, 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 obter mais informações, confira "Introdução ao GitHub Desktop".
Depois de instalar o Git, você poderá conectar-se aos repositórios de GitHub AE 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 GitHub AE por meio do Git, você precisará fazer a autenticação com o GitHub AE usando HTTPS ou SSH. Para obter mais informações, confira "Sobre repositórios remote".
3. Como escolher como interagir com o GitHub AE
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 se autenticar no GitHub AE com cada um desses métodos, confira "Sobre a autenticação no GitHub".
| Método | Descrição | Casos de uso |
|---|---|---|
| Acesse GitHub.com | Se você não precisar trabalhar com arquivos localmente, GitHub AE 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 a usar o GitHub Desktop, confira "Introdução ao 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 AE. |
| Editor de IDE ou de texto | Você pode definir um editor de texto padrão como o 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, confira "Associar 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 AE, você pode usar a linha de comando. Para obter mais informações sobre como usar os comandos do Git, confira "Folha de consultas Git". A GitHub CLI é uma ferramenta de linha de comando separada que pode ser instalada para exibir solicitações de pull, problemas, GitHub Actions e outros recursos do GitHub no terminal, para que você possa fazer todo o seu trabalho em um só lugar. Para obter mais informações, confira "Sobre o a CLI do GitHub". | 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 AE API | GitHub tem uma API REST e uma API do GraphQL que você pode usar para interagir com GitHub AE. Para obter mais informações, confira "Sobre as APIs do GitHub". | A API de GitHub AE seria muito útil se você quisesse automatizar tarefas comuns, fazer backup dos seus dados ou criar integrações que estendem GitHub. |
4. Gravação no GitHub AE
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, 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 AE
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 AE. Você pode pesquisar globalmente em todos os GitHub AE 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 AE, 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 AE
Com GitHub AE, 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, confira "Gerenciar arquivos".
Parte 3: Colaborando em GitHub AE
Qualquer quantidade de pessoas pode trabalhar juntas nos repositórios de GitHub AE. É possível configurar configurações, criar quadros de 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 obter mais informações, 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 obter mais informações, confira "Criar um repositório".
Clonar um repositório
Você pode clonar um repositório existente a partir de GitHub AE 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 obter mais informações, 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 obter mais informações, confira "Trabalhar com bifurcações".
2. Como importar seus projetos
Se você tiver projetos existentes que deseja mover para GitHub AE, 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, 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 quadros de projeto do repositório. Você pode convidar outras pessoas para seu repositório como colaboradores na guia Colaboradores nas configurações do repositório. Para obter mais informações, 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 obter mais informações, 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 obter mais informações, 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 obter mais informações, confira "Configurar projeto para contribuições úteis".
6. Como usar os quadros de projetos e os Problemas 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, confira "Sobre problemas" e "Sobre project boards."
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 obter mais informações, confira "Sobre notificações".
8. Como trabalhar com o GitHub Pages
Use o GitHub Pages para criar e hospedar um site diretamente por meio de um repositório no GitHub AE. Para obter mais informações, confira "Sobre o GitHub Pages".
Parte 4: Personalizando e automatizando seu trabalho em GitHub AE
Use ferramentas do GitHub Marketplace, da API do GitHub AE e os recursos existentes do GitHub AE para personalizar e automatizar seu trabalho.
1. Usando o GitHub AEAPI
Há duas versões da API do GitHub AE: a API REST e a API do GraphQL. Use as APIs do GitHub AE para automatizar tarefas comuns, fazer backup dos seus dados ou criar integrações que estendem o GitHub AE. Para obter mais informações, confira "Sobre as APIs do GitHub".
2. Como criar GitHub Actions
Com o GitHub Actions, você pode automatizar e personalizar o fluxo de trabalho de desenvolvimento do sua empresa no GitHub AE. 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 "Aprenda o GitHub Actions".
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 AE
GitHub AE 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 AE, 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 "Proteger o 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.
Encontre recomendações personalizadas para projetos e bons primeiros problemas com base nas suas contribuições anteriores, estrelas e outras atividades em Explorar.
2. Como interagir com o GitHub Community Support
Você pode se conectar com desenvolvedores de todo o mundo para fazer perguntas e responder a elas, aprender e interagir diretamente com a equipe do GitHub AE. Para começar a conversa, confira "GitHub Community Support".
3. Leitura sobre o GitHub AE no GitHub Docs
Leia a documentação que reflete os recursos disponíveis para você no GitHub AE. Para obter mais informações, confira "Sobre versões da Documentação do GitHub".
4. Aprendizagem com o GitHub Skills
Você pode aprender novas habilidades realizando projetos divertidos e realistas em um repositório próprio do GitHub com o GitHub Skills. Cada curso é uma lição prática criada pela comunidade do GitHub e ensinada por um bot amigável.
Para obter mais informações, confira "Recursos de aprendizagem Git e GitHub".