Introdução
GitHub é um aplicativo baseado na Web que permite hospedar arquivos em repositórios, colaborar no trabalho e acompanhar alterações em arquivos ao longo do tempo. O controle de versão em GitHub é baseado no software de código aberto Git. Sempre que você atualiza um repositório GitHub, o Git controla as alterações feitas.
Há muitas maneiras de trabalhar com GitHub, e você pode escolher um método que se adapte ao seu nível de experiência, às suas preferências pessoais e aos repositórios em que você trabalha. Por exemplo, você pode escolher se deseja trabalhar no navegador ou na área de trabalho, como deseja usar o Git e de quais recursos precisa no editor e em outros softwares. Você pode optar por trabalhar com repositórios diferentes de maneiras diferentes.
Se você é novo em GitHub, uma boa maneira de começar a contribuir é fazer alterações no navegador, no sua instância do GitHub Enterprise Server. À medida que você se familiariza mais com GitHub e começa a contribuir com mudanças maiores, talvez você queira começar a usar outras ferramentas. Este artigo explica como progredir nesses estágios e ajuda você a escolher a melhor ferramenta para seus requisitos em cada estágio. Para comparar rapidamente todas as ferramentas disponíveis para trabalhar com GitHub, consulte Comparação de ferramentas para conectar-se a GitHub.
Introdução
Na interface do usuário em sua instância do GitHub Enterprise Server, você pode realizar todo o fluxo "GitHub" para contribuir com um repositório, incluindo criar uma ramificação ou um fork, editar e visualizar arquivos, fazer commit das suas alterações e criar um pull request. Você também pode carregar arquivos de seu computador ou baixá-los do repositório. Para saber mais, confira fluxo de GitHub.
Trabalhar diretamente em sua instância do GitHub Enterprise Server geralmente é a maneira mais rápida de contribuir para um repositório, pelos motivos a seguir.
- Você está trabalhando diretamente com o repositório hospedado GitHube, portanto, não precisa baixar uma cópia do repositório para o computador e manter essa cópia em sincronia.
- Se você já estiver conectado, terá acesso a qualquer repositório em GitHubque tenha as permissões necessárias, portanto, não será necessário configurar nenhuma autenticação adicional em seu computador.
- Você pode confirmar alterações na interface do usuário, para que não precise usar a linha de comando nem memorizar comandos do Git.
Para obter um tutorial que o ajudará a começar a fazer alterações no navegador, confira Olá, Mundo.
Trabalhar diretamente no navegador é melhor para alterações pequenas e simples, geralmente direcionadas a um único arquivo em um repositório. Se você quiser fazer alterações mais complexas, talvez seja necessário se conectar GitHub da área de trabalho e trabalhar com uma cópia local do repositório.
Trabalhar a partir da área de trabalho
Para trabalhar com um repositório da área de trabalho, você precisará baixar (ou "clonar") uma cópia do repositório para o seu computador e, em seguida, enviar por push todas as alterações feitas para GitHub. O trabalho por meio da área de trabalho pode ter várias vantagens em relação ao trabalho no navegador.
- Você pode trabalhar com todos os seus arquivos e ferramentas locais.
- Você tem acesso ao poder de computação. Por exemplo, talvez seja necessário executar um script para criar uma visualização local de um site, para que você possa testar as alterações que está fazendo.
- Você não precisa de uma conexão com a Internet para trabalhar em um projeto.
Se você ainda não trabalhou com um repositório GitHub no seu computador, precisará se autenticar no GitHub usando seu computador para poder acessar os repositórios de que precisa. Talvez você também precise configurar seu ambiente de trabalho com as ferramentas necessárias para contribuir, como Git, um editor e dependências de um projeto. Por esses motivos, poderá levar mais tempo para começar se você quiser trabalhar em sua área de trabalho, em comparação com o trabalho no navegador.
Há várias ferramentas que você pode usar para se conectar a GitHub pelo seu computador. Essas ferramentas permitem que você se autentique em GitHub, clone um repositório, acompanhe suas alterações e envie as alterações para GitHub.
- Se quiser muito controle e flexibilidade, você poderá usar a linha de comando. Você precisará instalar o Git e estar familiarizado com alguns comandos básicos do Git. Você também pode instalar GitHub CLI, uma interface de linha de comando que permite realizar várias ações em GitHub, como criar um pull request ou criar um fork de um repositório. Para saber mais, confira Configurar o git e Sobre GitHub CLI.
- Se você preferir usar uma interface visual, poderá usar um cliente Git visual, como GitHub Desktop. Com GitHub Desktop, você pode visualizar as alterações que está fazendo e acessar a maioria dos comandos do Git em uma interface visual, assim não precisa memorizar nenhum comando. Para saber mais, confira Sobre o GitHub Desktop.
- Se deseja trabalhar em um só lugar, muitas vezes, você pode realizar a maioria das ações no editor. Um editor, como VS Code, inclui um terminal integrado e botões para comandos comuns do Git, para que você possa editar arquivos e enviar suas alterações para GitHub, tudo de um só lugar. Você também pode instalar uma extensão para trabalhar diretamente com solicitações de pull e problemas.GitHub Para começar, consulte Download VS Code.
Comparação de ferramentas para se conectar a GitHub
A tabela a seguir fornece uma comparação entre as ferramentas que você pode usar para trabalhar com repositórios GitHubno navegador e na área de trabalho.
Você pode executar todo GitHub o fluxo com qualquer uma das ferramentas descritas aqui. Cada ferramenta inclui acesso não apenas aos comandos do Git para acompanhar as alterações que você fez, mas também a recursos específicos do GitHub, para que você possa criar um pull request com as alterações que você propôs de onde você estiver trabalhando.
Para obter mais informações sobre como autenticar GitHub com cada uma dessas ferramentas, consulte Sobre a autenticação para GitHub.
| Ferramenta | Caso de uso | Navegador ou desktop |
|---|---|---|
| Em sua instância do GitHub Enterprise Server | Você deseja uma interface visual e precisa fazer alterações rápidas e simples, geralmente envolvendo uma única confirmação. Para obter uma introdução, confira Olá, Mundo. | Navegador |
| GitHub Desktop | Você deseja trabalhar com arquivos localmente e prefere que uma interface visual use o Git, visualize as alterações e interaja com GitHub. Para saber mais, confira Sobre o GitHub Desktop. | Área de trabalho |
| Editor de texto ou IDE | Você está trabalhando com arquivos e projetos mais complexos e quer que tudo esteja em um só lugar. | Área de trabalho |
| Git na linha de comando e GitHub CLI | Você está acostumado a trabalhar por meio da linha de comando e quer evitar a mudança de contexto ou precisa acessar um comando Git complexo que não está integrado a interfaces visuais. Para saber mais, confira Configurar o git e Sobre GitHub CLI. | Área de trabalho |
| GitHub Enterprise Server API | Você deseja automatizar tarefas comuns, como fazer backup de seus dados ou criar integrações que se estendam GitHub. Para saber mais, confira Comparando a API REST do GitHub e a API do GraphQL. | Navegador ou desktop |