Sobre repositórios
Um repositório é o elemento mais básico do 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, internos ou particulares.
Para criar um novo repositório, acesse https://github.com/new. Para obter instruções, confira 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 | Baixar uma cópia completa dos dados de um repositório de sua instância do GitHub Enterprise Server, 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 no GitHub, não no seu 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 da 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, confira Sobre issues.
- É possível usar pull requests para propor alterações em um repositório. Para saber mais, confira Sobre solicitação de pull.
- Você pode usar Projects para organizar e priorizar seus problemas e pull requests. Para saber mais, confira Sobre Projects.
Cada pessoa e organização pode ser o proprietário de repositórios ilimitados e convidar um número ilimitado de colaboradores em todos os repositórios.
Sobre a visibilidade do repositório
É possível restringir quem tem acesso a um repositório escolhendo a visibilidade de um repositório: público, interno ou privado.
Ao criar um repositório, você pode optar por tornar o repositório público ou privado. Se você estiver criando o repositório em uma organização, você também pode optar por tornar o repositório interno.
- Se a sua instância do GitHub Enterprise Server não estiver em modo privado ou protegida por um firewall, os repositórios públicos poderão ser acessados por todos na Internet. Caso contrário, os repositórios públicos estarão disponíveis a todos os usuários de sua instância do GitHub Enterprise Server, incluindo colaboradores externos.
- 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.
- Repositórios internos podem ser acessados por todos os integrantes da empresa. Para obter mais informações, confira Sobre os repositórios internos.
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.
Sobre repositórios internos
Você pode usar repositórios internos para praticar o uso do "InnerSource" na sua empresa. Os integrantes da sua empresa podem colaborar usando metodologias de código aberto sem compartilhar informações proprietárias publicamente, mesmo com o modo privado desabilitado. Para saber mais sobre innersource, confira Usando o innersource em sua empresa.
Os membros da organização têm permissões de leitura para todos os repositórios internos em uma empresa, incluindo aqueles em organizações das quais não são membros. Repositórios internos não são visíveis para as pessoas que não são membros de nenhuma organização, incluindo colaboradores externos em repositórios da organização. Para saber mais, confira Habilidades de funções em uma empresa e Funções de repositório para uma organização.
Por padrão, os membros enterprise podem bifurcar um repositório interno em qualquer organização em que o usuário possa criar repositórios. Os proprietários da organização também podem permitir que os usuários criem uma bifurcação de propriedade de uma conta de usuário e podem gerenciar a política de forking para uma organização. Os proprietários de empresas podem gerenciar a política de bifurcação para algumas ou todas as organizações dentro de uma empresa. Para saber mais, confira Gerenciar a política de bifurcação da sua organização e Aplicar as políticas de gerenciamento do repositório na sua empresa.
Próximas etapas
Aqui estão alguns recursos úteis para as próximas etapas com repositórios.
-
[AUTOTITLE](/repositories/creating-and-managing-repositories/best-practices-for-repositories): saiba como usar os repositórios de maneira mais eficaz. -
[AUTOTITLE](/repositories/creating-and-managing-repositories/creating-a-new-repository): crie um novo repositório. -
[AUTOTITLE](/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/creating-and-deleting-branches-within-your-repository): saiba como criar e excluir branches em seu repositório. -
[AUTOTITLE](/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/creating-a-pull-request): crie uma pull request para propor e colaborar em alterações em um repositório.