Skip to main content

Criar um repositório

Para colocar seu projeto no GitHub, você precisará criar um repositório no qual ele residirá.

Criar um repositório

Você pode armazenar uma série de projetos em repositórios de GitHub Enterprise Server, incluindo projetos de innersource. Com o innersource, você pode compartilhar código para criar um software melhor e mais confiável. Para obter mais informações sobre o InnerSource, confira o white paper "Uma introdução ao InnerSource" do GitHub.

  1. No canto superior direito de qualquer página, use o menu suspenso e selecione Novo repositório. Menu suspenso com a opção para criação de um repositório
  2. Digite um nome breve e memorável para o repositório. Por exemplo, "olá mundo". Campo usado para inserir um nome de repositório
  3. Opcionalmente, adicione uma descrição do repositório. Por exemplo, "Meu primeiro repositório no GitHub Enterprise Server". Campo usado para inserir uma descrição do repositório 1. Escolha uma visibilidade do repositório. Para obter mais informações, confira "Sobre os repositórios". Botões de opção usados para selecionar a visibilidade do repositório 1. Selecione Inicializar este repositório com um LEIAME. Caixa de seleção Inicializar este repositório com um LEIAME 1. Clique em Criar repositório. Botão usado para criar um repositório

Parabéns! Você criou com sucesso seu primeiro repositório e o inicializou com um arquivo LEIAME.

Para saber mais sobre a GitHub CLI, confira "Sobre a GitHub CLI".

  1. Na linha de comando, acesse o diretório onde você gostaria de criar um clone local do seu novo projeto.
  2. Para criar um repositório para seu projeto, use o subcomando gh repo create. Quando solicitado, selecione Criar um repositório no GitHub do zero e insira o nome do novo projeto. Caso você deseje que o seu projeto pertença a uma organização em vez da sua conta pessoal, especifique o nome da organização e o nome do projeto com organization-name/project-name.
  3. Siga as instruções interativas. Para clonar o repositório localmente, marque sim quando perguntarem se você deseja clonar o diretório do projeto remoto.
  4. Como alternativa, para ignorar os prompts, forneça o nome do repositório e um sinalizador de visibilidade (--public, --private ou --internal). Por exemplo, gh repo create project-name --public. Para clonar o repositório localmente, transmita o sinalizador --clone. Para obter mais informações sobre os possíveis argumentos, confira o manual da CLI do GitHub.

Fazer commit da primeira alteração

Um commit é como um instantâneo de todos os arquivos do seu projeto em determinado momento.

Na criação do repositório, você o inicializou com um arquivo LEIAME. Os arquivos LEIAME são um ótimo lugar para descrever o projeto com mais detalhes ou adicionar alguma documentação (por exemplo, como instalar ou usar o projeto). O conteúdo do arquivo LEIAME é mostrado automaticamente na página inicial do repositório.

Vamos fazer commit de uma alteração no arquivo README.

  1. Na lista de arquivos do repositório, clique em README.md. Arquivo README na lista de arquivos
  2. Acima do conteúdo do arquivo, clique em .
  3. Na guia Editar arquivo, digite algumas informações sobre você mesmo. Novo conteúdo no arquivo 1. Acima do novo conteúdo, clique em Visualizar alterações. Botão Visualização de arquivo
  4. Revise as alterações feitas no arquivo. Você verá o novo conteúdo em verde. Exibição de visualização de arquivo 1. No final da página, digite uma mensagem de commit curta e significativa que descreva a alteração feita no arquivo. Você pode atribuir o commit a mais de um autor na mensagem de commit. Para obter mais informações, confira "Como criar um commit com vários coautores". Mensagem de commit para a alteração 1. Abaixo dos campos de mensagem do commit, opte por adicionar o commit ao branch atual ou a um novo branch. Se seu branch atual for o branch-padrão, você deverá optar por criar um novo branch para seu commit e, em seguida, criar um pull request. Para obter mais informações, confira "Como criar uma solicitação de pull". Opções de commit no branch 1. Clique em Propor alteração de arquivo. Botão Propor alteração de arquivo

Agora que você criou um projeto, você pode começar a fazer commit das alterações.

Os arquivos LEIAME são um ótimo lugar para descrever o projeto com mais detalhes ou adicionar alguma documentação (por exemplo, como instalar ou usar o projeto). O conteúdo do arquivo LEIAME é mostrado automaticamente na página inicial do repositório. Siga estas etapas para adicionar um arquivo README.

  1. Na linha de comando, acesse o diretório raiz do seu novo projeto. (Esse diretório foi criado quando você executou o comando gh repo create).

  2. Crie um arquivo README com algumas informações sobre o projeto.

    echo "info about this project" >> README.md
  3. Insira git status. Você verá que tem um arquivo README.md não controlado.

    $ git status
    
    Untracked files:
      (use "git add ..." to include in what will be committed)
      README.md
    
    nothing added to commit but untracked files present (use "git add" to track)
  4. Stage e commit do arquivo.

    git add README.md && git commit -m "Add README"
  5. Faça push das alterações para seu branch.

    git push --set-upstream origin HEAD

Próximas etapas

Você acabou de criar um repositório, incluindo um arquivo README, e seu primeiro commit no your GitHub Enterprise Server instance.

  • Você já pode clonar um repositório do GitHub para criar uma cópia local no computador. A partir do seu repositório local, você pode fazer commit e criar um pull request para atualizar as alterações no repositório upstream. Para obter mais informações, confira "Como clonar um repositório" e "Configurar o Git".
  • Encontre projetos e repositórios interessantes no GitHub e faça alterações neles criando um fork do repositório. A bifurcação de um repositório permitirá que você faça alterações em outro repositório sem afetar o original. Para obter mais informações, confira "Criar um fork de um repositório".

  • Cada repositório em GitHub pertence a uma pessoa ou organização. Você pode interagir com as pessoas, repositórios e organizações, conectando-se e seguindo-as em GitHub Enterprise Server. Para obter mais informações, confira "Seja social".

  • O GitHub tem uma ótima comunidade de suporte na qual você pode pedir ajuda e conversar com pessoas de todo o mundo. Participe da conversa na GitHub Community.