Dica: os proprietários podem restringir as permissões de criação de repositórios em uma organização. Para obter mais informações, confira "Restringir a criação de repositórios na organização".
Dica: crie também um repositório usando a GitHub CLI. Para obter mais informações, confira "gh repo create
" na documentação da GitHub CLI.
Criar um repositório a partir da interface do usuário da web
-
No canto superior direito de qualquer página, selecione e clique em Novo repositório.
-
Opcionalmente, para criar um repositório com a estrutura de diretório e os arquivos de um repositório existente, selecione o menu suspenso Escolher um modelo e clique em um repositório de modelo. Você verá repositórios de modelo que pertencem a você e às organizações das quais você é integrante ou que usou antes. Para obter mais informações, confira "Criar um repositório a partir de um modelo".
-
Opcionalmente, se você escolheu usar um modelo para incluir a estrutura do diretório e os arquivos de todos os branches no modelo, não apenas o branch padrão, selecione Incluir todos os branches.
-
Use o menu suspenso Proprietário para selecionar a conta que deseja atribuir como proprietário do repositório.
-
Digite um nome para o seu repositório e uma descrição opcional.
-
Escolha uma visibilidade do repositório. Para obter mais informações, confira "Sobre repositórios".
-
Se você não estiver usando um modelo, haverá um número de itens opcionais com os quais você pode preencher previamente o seu repositório. Se for importar um repositório existente para o GitHub Enterprise Server, não escolha qualquer uma destas opções, pois isso poderá criar um conflito de merge. É possível adicionar ou criar arquivos usando a interface de usuário ou optar por adicionar novos arquivos posteriormente usando a linha de comando. Para saber mais, confira "Como importar um repositório Git externo usando a linha de comando", "Adicionar um arquivo a um repositório" e "Resolvendo conflitos de mesclagem".
- Você pode criar um README, que é um documento que descreve seu projeto. Para obter mais informações, confira "Sobre LEIAMEs".
- Você pode criar um arquivo .gitignore, que é um conjunto de regras a serem ignoradas. Para mais informações, confira "Ignorar arquivos".
-
Defina as propriedades personalizadas para a criação do repositório, se forem necessárias. Para obter mais informações, consulte "Como gerenciar propriedades personalizadas para repositórios na sua organização." 1. Clique em Criar repositório.
Criar um repositório a partir de uma consulta de URL
É possível usar parâmetros de consulta para preencher previamente os campos do formulário ao criar um repositório. Os parâmetros de consulta são partes opcionais de uma URL que podem ser personalizadas para compartilhar uma exibição de página web específica, como resultados do filtro de pesquisa ou um modelo de problemas no GitHub. Para especificar valores para os parâmetros de consulta predefinidos, é necessário corresponder ao par de chave e valor.
O preenchimento prévio de campos de formulário com uma consulta de URL pode ser útil se você deseja criar repositórios com as mesmas configurações padrão. Por exemplo, um professor pode querer que cada aluno de uma turma crie um repositório em sua conta pessoal com o mesmo nome, descrição e visibilidade. Usando uma consulta de URL, o professor pode criar um link que preencha previamente o nome do repositório, a descrição e os campos de visibilidade e compartilhá-lo com toda a turma.
Você deve ter as permissões adequadas para qualquer ação para usar o parâmetro de consulta equivalente. Por exemplo, é necessário ter permissão para criar um repositório em uma organização para especificar a organização como o proprietário do repositório em um parâmetro de consulta. Para obter mais informações, confira "Funções de repositório para uma organização".
Se você criar um URL inválido usando parâmetros de consulta ou se não tiver as permissões adequadas, os parâmetros de consulta inválidos serão ignorados e o restante do URL funcionará normalmente. Se você criar uma URL que exceda o limite do servidor, a URL retornará uma página de erro 414 URI Too Long
.
Parâmetro de consulta | Exemplo | Valores válidos |
---|---|---|
name | O https://HOSTNAME/new?name=test-repo&owner=avocado-corp cria um repositório chamado "test-repo" de propriedade da organização "avocado-corp". | Qualquer nome de repositório válido. Os espaços devem ser substituídos por + ou %20 . |
description | O https://HOSTNAME/new?description=An+exciting+repository&visibility=private&owner=octocat cria um repositório com a descrição "Um repositório interessante" com visibilidade privada pertencente a @octocat. | Qualquer cadeia de caracteres. Os espaços devem ser substituídos por + ou %20 . |
visibility | O https://HOSTNAME/new?visibility=private cria um repositório com visibilidade privada. | public private internal |
owner | O https://HOSTNAME/new?owner=avocado-corp&visibility=public cria um repositório público de propriedade da organização "avocado-corp". | Qualquer nome de organização ou nome de usuário válido. Como alternativa, enquanto estiver conectado, use @me para especificar sua conta de usuário como o proprietário. |
template_owner e template_name | O https://HOSTNAME/new?owner=avocado-corp&template_owner=avocado-corp&template_name=octo-repo cria um repositório de propriedade de "avocado-corp" usando o modelo "octo-repo" da avocado-corp. | O nome de usuário do proprietário do modelo e o nome do modelo de repositório. |