# Importação programática de repositórios

Você pode importar repositórios programaticamente para GitHub.

## Sobre a importação programática de repositórios

No guia a seguir, você pode aprender a executar programaticamente migrações de "origem e histórico" de repositórios Git para GitHub. Diferentes opções estão disponíveis, dependendo de onde o repositório está armazenado.

Para saber mais sobre "origem e histórico" e outros tipos de migrações, confira [Como planejar sua migração para o GitHub](/pt/enterprise-cloud@latest/migrations/overview/planning-your-migration-to-github).

O termo "repositório de origem" refere-se ao repositório que você está importando, e "repositório importado" refere-se ao novo repositório que você está criando.

## Uso de forks

Se o repositório de origem estiver no GitHub, talvez seja possível usar um fork em vez de importar o repositório. Os forks permitem fazer alterações em um projeto sem afetar o repositório original, também conhecido como repositório "upstream".

Depois de bifurcar um repositório, você pode:

* Buscar atualizações do repositório upstream para manter seu fork atualizado
* Contribuir para o projeto original criando pull requests do fork. Para obter mais informações, confira [Garfos](/pt/enterprise-cloud@latest/pull-requests/reference/forks).

Você pode criar fork de um repositório de maneira programática usando a API REST. Para saber mais, confira [Pontos de extremidade de API REST para forks](/pt/enterprise-cloud@latest/rest/repos/forks).

Se o seu caso de uso atender a qualquer um dos critérios a seguir, você não poderá usar o fork em vez de importar diretamente o repositório.

* Você deseja que o repositório importado seja de propriedade do mesmo usuário ou organização que o repositório de origem.
* Você deseja que um usuário ou organização possa importar o mesmo repositório de origem várias vezes.

## Usando modelos de repositório

Se o repositório de origem estiver no GitHub, talvez você possa usar modelos de repositório.
Você pode criar um modelo a partir de um repositório existente. Qualquer pessoa com acesso ao repositório de modelos pode criar um novo repositório baseado no modelo com a mesma estrutura de diretórios, branchs e arquivos. Para obter mais detalhes, consulte [Criar um repositório de modelos](/pt/enterprise-cloud@latest/repositories/creating-and-managing-repositories/creating-a-template-repository).

Para usar modelos de repositório, você deve ter acesso de leitura a um repositório existente que seja um modelo ou deve ter acesso para criar um modelo.

Você pode criar programaticamente um repositório a partir de um modelo de repositório usando a API REST. Para saber mais, confira [Pontos de extremidade da API REST para repositórios](/pt/enterprise-cloud@latest/rest/repos/repos).

## Usando GitHub Enterprise Importer

Se o repositório de origem estiver hospedado em GitHub, GitHub Enterprise Serverserviços de Azure DevOps, Servidor Bitbucket ou Data Center do Bitbucket, você poderá importar o repositório usando GitHub Enterprise Importer. Para saber mais, confira [Sobre o GitHub Enterprise Importer](/pt/enterprise-cloud@latest/migrations/using-github-enterprise-importer/understanding-github-enterprise-importer/about-github-enterprise-importer).

Além do histórico de controle de origem e versão, GitHub Enterprise Importer também migra problemas, solicitações de pull, configurações e muito mais.

Para usar GitHub Enterprise Importer, você deve ter acesso de administrador ao repositório de origem.

Você pode importar repositórios programaticamente usando GitHub Enterprise Importer a API do GraphQL.

## Usando a CLI do Git

Se o repositório de origem for um repositório Git, você poderá chamar a CLI do Git programaticamente a partir do seu código. Você pode criar programaticamente um repositório usando GitHuba API REST e, em seguida, usar comandos como `git clone` e `git push` importar o repositório para GitHub.

A forma como você chama a CLI do Git varia de acordo com a linguagem do seu código. Por exemplo, no Node.js, você pode usar o módulo `child_process` ou, no Ruby, pode usar o módulo `open3`. Para obter mais informações, consulte o [processo filho](https://nodejs.org/api/child_process.html) na documentação do Node.js ou no [repositório ruby/open3](https://github.com/ruby/open3) em GitHub.

Para usar a CLI do Git, você deve ter acesso para instalar o Git no sistema que hospeda seu aplicativo. Para obter mais informações, consulte [Introdução - Instalação do Git](https://git-scm.com/book/en/v2/Getting-Started-Installing-Git) na documentação do Git.

## Usando GitHub CLI

Se o repositório de origem for um repositório Git, você poderá chamar o GitHub CLI programaticamente do seu código. Você pode usar o `gh repo create` para criar um repositório. Para saber mais, confira [Sobre GitHub CLI](/pt/enterprise-cloud@latest/github-cli/github-cli/about-github-cli).

## Leitura adicional

* [Pontos de extremidade da API REST para repositórios](/pt/enterprise-cloud@latest/rest/repos/repos)