Sobre repositórios
Um repositório é o elemento mais básico de GitHub. É um lugar onde você pode armazenar seu código, seus arquivos e o histórico de revisão de cada arquivo. Os repositórios podem ter vários colaboradores e podem ser públicos ou privados.
Para criar um novo repositório, acesse https://github.com/new. Para obter instruções, confira Guia de início rápido para repositórios.
Terminologia do repositório
Antes de começar a usar repositórios, aprenda esses termos importantes.
| Termo | Definição |
|---|---|
| Branch | Uma versão paralela do código que está contida dentro do repositório, mas não afeta a ramificação primária ou principal. |
| Clone | Para baixar uma cópia completa dos dados de GitHub.comum repositório, incluindo todas as versões de cada arquivo e pasta. |
| Fork | Um novo repositório que compartilha configurações de código e visibilidade com o repositório "upstream" original. |
| Mesclar | Pegar as alterações de um branch e aplicá-las à outra. |
| Solicitação de pull | Uma solicitação para mesclar as alterações de um branch em outro. |
| Remoto | Um repositório armazenado, GitHubnão no computador. |
| Upstream | O branch em um repositório original em que foi criado um fork ou clonado. O branch correspondente no repositório clonado ou em que o fork foi criado é chamado de "downstream". |
Sobre propriedade do repositório
Você pode possuir repositórios individualmente ou compartilhar a propriedade de repositórios com outras pessoas em uma organização.
Em ambos os casos, o acesso aos repositórios é gerenciado por permissões. Para saber mais, confira Níveis de permissão para um repositório de conta pessoal e Funções de repositório para uma organização.
Sobre colaboração
Você pode usar repositórios para gerenciar seu trabalho e colaborar com outras pessoas.
- Você pode usar problemas para coletar feedback do usuário, relatar erros de software e organizar tarefas que você gostaria de realizar. Para obter mais informações, consulte Sobre problemas.
- Use o GitHub Discussions para fazer perguntas e responder a elas, compartilhar informações, fazer comunicados e conduzir uma conversa sobre um projeto ou participar dela. Para saber mais, confira Sobre discussões.
- É possível usar pull requests para propor alterações em um repositório. Para saber mais, confira Solicitações de pull.
- Você pode usar Projects para organizar e priorizar seus problemas e solicitações de pull. Para saber mais, confira Sobre o Projects.
Com GitHub Free contas pessoais e organizações, você pode trabalhar com colaboradores ilimitados em repositórios públicos ilimitados com um conjunto de recursos completo ou repositórios privados ilimitados com um conjunto de recursos limitado. Para obter ferramentas avançadas para repositórios privados, você pode atualizar para GitHub Pro, GitHub Teamou GitHub Enterprise Cloud. Consulte Planos do GitHub.
Sobre a visibilidade do repositório
Você pode restringir quem tem acesso a um repositório escolhendo a visibilidade de um repositório: ou privada.
Ao criar um repositório, você pode optar por tornar o repositório público ou privado. Repositórios em organizações que usam GitHub Enterprise Cloud e pertencem a uma conta corporativa também podem ser criados com visibilidade interna. Para obter mais informações, consulte a GitHub Enterprise Cloud documentação.
- Repositórios públicos são acessíveis a todos na Internet.
- Os repositórios só podem ser acessados por você, pelas pessoas com as quais você compartilha explicitamente o acesso e, para repositórios da organização, por determinados integrantes da organização.
Considerações de segurança para visibilidade do repositório
Repositórios públicos expõem sua base de código a todos, aumentando o risco de que invasores possam explorar vulnerabilidades ou acessar informações confidenciais. Você pode atenuar esses riscos habilitando GitHub recursos de segurança, como Dependabot, secret scanningproteção por push e code scanning para o repositório. Além disso, adicione uma política de segurança (um arquivo SECURITY.md) ao repositório, descrevendo como as vulnerabilidades devem ser relatadas, para garantir que possíveis ameaças sejam tratadas com eficiência.
Embora repositórios privados restrinjam o acesso a usuários autorizados, ainda é essencial implementar controles de acesso fortes, autenticação multifator e auditorias regulares para reduzir os riscos.
Para saber mais, confira Guia de Início rápido para proteger seu repositório.
Os proprietários da organização sempre têm acesso a todos os repositórios criados em uma organização. Para saber mais, confira Funções de repositório para uma organização.
As pessoas com permissões de administrador para um repositório podem alterar a visibilidade de um repositório existente. Para saber mais, confira Definir a visibilidade do repositório.
Próximas etapas
Aqui estão alguns recursos úteis para as próximas etapas com repositórios.
- Práticas recomendadas para repositórios: saiba como usar os repositórios de maneira mais eficaz.
- Criar um repositório: crie um novo repositório.
- Gerenciando branches em seu repositório: saiba como criar e excluir branches em seu repositório.
- Como criar uma solicitação de pull: crie uma pull request para propor e colaborar em alterações em um repositório.