Вилка репозитория

Вилку репозитория GitHub для предложения изменений, совместной работы над проектами и управления собственной копией базы кода.

Кто может использовать эту функцию?

Члены данных корпоративный с управляемыми пользователями не могут вилировать репозитории за пределами предприятия или внутренних репозиториев.

Platform navigation

Tool navigation

В этой статье

Сведения о вилках

Создание вилки репозитория позволяет предлагать изменения в проекте, не затрагивая вышестоящий репозиторий. См . раздел AUTOTITLE.

Необходимые условия

Если вы еще не сделали этого, настройте Git и проверку подлинности с GitHub.com помощью Git. См . раздел AUTOTITLE.

Создание вилки репозитория

Вы можете создать проект, чтобы предложить изменения в вышестоящем репозитории. В этом случае рекомендуется регулярно синхронизировать вилку с вышестоящим репозиторием. Для этого необходимо использовать GIT в командной строке. Вы можете попрактиковаться в настройке вышестоящего репозитория, используя репозиторий octocat/Spoon-Knife, вилку которого вы только что создали.

  1. Войдите GitHubв репозиторий octocat/Spoon-Knife.

  2. В правом верхнем углу страницы щелкните Вилка.

    Снимок экрана: главная страница репозитория. Кнопка, помеченная значком вилки и "Вилкой 59,3k", описывается темно-оранжевым цветом.

  3. В разделе "Владелец" выберите раскрывающееся меню и щелкните владельца для вилированного репозитория.

  4. По умолчанию вилки называются теми же, что и их вышестоящий репозиторий. При необходимости в поле "Имя репозитория" введите другое имя, чтобы отличить вилку.

  5. При необходимости в поле "Описание" введите описание вилки.

  6. При необходимости выберите " Копировать только ветвь DEFAULT".

    Для многих сценариев разветвления, таких как участие в проектах с открытым кодом, необходимо скопировать только ветвь по умолчанию. Если этот параметр не выбран, все ветви будут скопированы в новую вилку.

  7. Нажмите Создать вилку.

Примечание.

Если вы хотите скопировать дополнительные ветви из вышестоящего репозитория, это можно сделать на странице "Ветви ". См . раздел AUTOTITLE.

Примечание.

Дополнительные сведения о GitHub CLIсм. в разделе О GitHub CLI.

Чтобы создать вилку репозитория, используйте подкоманду gh repo fork.

gh repo fork REPOSITORY

Чтобы создать вилку в организации, используйте флаг --org.

gh repo fork REPOSITORY --org "octo-org"

Вы можете вкрепить репозиторий в GitHub.com или в GitHub Desktop. Сведения о вилке GitHub.comсм. в версии веб-браузера этой статьи.

В GitHub Desktop, если клонировать репозиторий, в который у вас нет доступа на запись, а затем попытаться отправить изменение в репозиторий, будет создан вилку.

  1. В меню Файл щелкните Клонировать репозиторий.

    Снимок экрана: строка меню на Компьютере Mac. Раскрывающееся меню "Файл" развернуто, а параметр "Клонировать репозиторий" выделен оранжевым контуром.

    Снимок экрана: строка меню "GitHub Desktop" в Windows. Раскрывающееся меню "Файл" развернуто, а параметр "Клонировать репозиторий" выделен оранжевым цветом.

  2. Щелкните вкладку, соответствующую расположению репозитория, который требуется клонировать. В этом примере щелкните вкладку URL-адреса.

    Снимок экрана: вкладка "URL-адрес" окна "Клонировать репозиторий". Вкладки "GitHub.com", "GitHub Enterprise" и "URL-адрес" представлены в темно-оранжевый цвет.

  3. Введите URL-адрес или путь репозитория, который требуется клонировать.

    Снимок экрана: вкладка "URL-адрес" окна "Клонировать репозиторий". Входные данные, содержащие "octocat/Spoon-Нож", выделены оранжевым контуром.

  4. Чтобы выбрать локальный каталог, в который требуется клонировать репозиторий, рядом с полем "Локальный путь" нажмите кнопку " Выбрать... и перейдите к каталогу".

    Снимок экрана: вкладка "URL-адрес" окна "Клонировать репозиторий". Кнопка с надписью "Выбрать" выделена оранжевым контуром.

  5. В нижней части окна "Клонировать репозиторий" нажмите кнопку "Клонировать".

  6. Чтобы создать вилку, попытайтесь отправить изменение в репозиторий. Например, создайте новую ветвь и опубликуйте ее. Появится запрос на создание вилки этого репозитория.

    Снимок экрана: окно "Создание вилки запроса". Кнопка, помеченная как "Вилка этого репозитория", выделена оранжевым контуром.

  7. Ознакомьтесь с информацией в разделе "Как вы планируете использовать этот вилку?" интервалу времени.

    • Если вы планируете использовать эту вилку для участия в исходном вышестоящем репозитории, щелкните Участие в родительском проекте.
    • Если вы будете использовать эту вилку для проекта, не связанного с вышестоящим, щелкните В своих целях.

  8. Нажмите кнопку Продолжить.

Клонирование вилки репозитория

Теперь у вас есть вилка репозитория Spoon-Knife, но у вас нет файлов из этого репозитория на компьютере.

  1. Введите GitHubвилку репозитория Spoon-Knife.

  2. Над списком файлов щелкните Code.

    Снимок экрана: список файлов на целевой странице репозитория. Кнопка "Код" выделена темно-оранжевым контуром.

  3. Скопируйте URL-адрес репозитория.

    • Чтобы клонировать репозиторий с помощью HTTPS, в разделе "HTTPS" нажмите .

    • Чтобы клонировать репозиторий с помощью ключа SSH, включая сертификат, выданный центром сертификации SSH вашей организации, щелкните SSH, а затем щелкните .

    • Чтобы клонировать репозиторий с помощью GitHub CLI, щелкните GitHub CLI, а затем щелкните .

      Снимок экрана: раскрывающееся меню "Код". Справа от URL-адреса HTTPS для репозитория значок копирования описывается темно-оранжевым цветом.

  4. Откройте терминал или Git Bash.

  5. Измените текущий рабочий каталог на расположение, где должен находиться клонированный каталог.

  6. Введите git clone, а затем вставьте URL-адрес, скопированный ранее. Он будет выглядеть следующим образом:GitHubYOUR-USERNAME

    git clone https://github.com/YOUR-USERNAME/Spoon-Knife

  7. Нажмите Enter. Git создает локальный клон.

    $ git clone https://github.com/YOUR-USERNAME/Spoon-Knife
> Cloning into `Spoon-Knife`...
> remote: Counting objects: 10, done.
> remote: Compressing objects: 100% (8/8), done.
> remote: Total 10 (delta 1), reused 10 (delta 1)
> Unpacking objects: 100% (10/10), done.

Клонирование вилки репозитория

Теперь у вас есть вилка репозитория Spoon-Knife, но у вас нет файлов из этого репозитория на компьютере.

Примечание.

Дополнительные сведения о GitHub CLIсм. в разделе О GitHub CLI.

Чтобы создать клон вилки, используйте флаг --clone.

gh repo fork REPOSITORY --clone=true

Настройка Git для синхронизации вилки с вышестоящим репозиторием

При создании проекта для предложения изменений в вышестоящем репозитории вы можете настроить Git для извлечения изменений из вышестоящего репозитория в локальный клон вилки.

  1. Войдите GitHubв репозиторий octocat/Spoon-Knife.

  2. Над списком файлов щелкните Code.

    Снимок экрана: список файлов на целевой странице репозитория. Кнопка "Код" выделена темно-оранжевым контуром.

  3. Скопируйте URL-адрес репозитория.

    • Чтобы клонировать репозиторий с помощью HTTPS, в разделе "HTTPS" нажмите .

    • Чтобы клонировать репозиторий с помощью ключа SSH, включая сертификат, выданный центром сертификации SSH вашей организации, щелкните SSH, а затем щелкните .

    • Чтобы клонировать репозиторий с помощью GitHub CLI, щелкните GitHub CLI, а затем щелкните .

      Снимок экрана: раскрывающееся меню "Код". Справа от URL-адреса HTTPS для репозитория значок копирования описывается темно-оранжевым цветом.

  4. Откройте терминал или Git Bash.

  5. Перейдите в каталог для клонированного клонированного вилки.

    • Чтобы перейти к домашнему каталогу, введите просто cd без дополнительного текста.
    • Чтобы получить список файлов и папок в текущем каталоге, введите ls.
    • Чтобы перейти в один из перечисленных каталогов, введите cd YOUR-LISTED-DIRECTORY.
    • Чтобы перейти на один каталог выше, введите cd ...

  6. Введите git remote -v и нажмите клавишу Enter. Сейчас вы увидите удаленный репозиторий, настроенный для вилки.

    $ git remote -v
> origin  https://github.com/YOUR-USERNAME/YOUR-FORK.git (fetch)
> origin  https://github.com/YOUR-USERNAME/YOUR-FORK.git (push)

  7. Введите git remote add upstream, вставьте URL-адрес, скопированный на шаге 3, и нажмите клавишу ВВОД. Он будет выглядеть следующим образом.

    git remote add upstream https://github.com/ORIGINAL-OWNER/Spoon-Knife.git

  8. Чтобы проверить новый вышестоящий репозиторий, указанный для вилки, введите git remote -v еще раз. Url-адрес для вилки должен отображаться как origin и URL-адрес для вышестоящего репозитория upstream.

    $ git remote -v
> origin    https://github.com/YOUR-USERNAME/YOUR-FORK.git (fetch)
> origin    https://github.com/YOUR-USERNAME/YOUR-FORK.git (push)
> upstream  https://github.com/ORIGINAL-OWNER/ORIGINAL-REPOSITORY.git (fetch)
> upstream  https://github.com/ORIGINAL-OWNER/ORIGINAL-REPOSITORY.git (push)

Теперь вы можете синхронизировать вилку с вышестоящим репозиторием с несколькими командами Git. См . раздел AUTOTITLE.

Примечание.

Дополнительные сведения о GitHub CLIсм. в разделе О GitHub CLI.

Чтобы настроить удаленный репозиторий для вилки репозитория, используйте флаг --remote.

gh repo fork REPOSITORY --remote=true

Чтобы указать имя удаленного репозитория, используйте флаг --remote-name.

gh repo fork REPOSITORY --remote-name "main-remote-repo"

Редактирование вилки

Вы можете вносить любые изменения в вилку, в том числе указанные ниже.

  • Создание ветвей.Ветви позволяют создавать новые функции или проверять идеи, не подвергая риску главный проект.
  • Открытие запросов на вытягивание: Если вы хотите внести свой вклад обратно в вышестоящий репозиторий, отправьте запрос на вытягивание, чтобы попросить исходного автора извлечь вилку в свой репозиторий. См . раздел AUTOTITLE.

Поиск репозитория для создания вилки

Создайте вилку репозитория, чтобы приступить к участию в проекте. Вы можете ввести частный или внутренний репозиторий в личная учетная запись или в организацию на GitHub, где у вас есть разрешение на создание репозиториев, при условии, что параметры репозитория и корпоративные политики позволяют вилки.

Как правило, вы можете ввести любые общедоступный репозиторий в личная учетная запись или в организацию, где у вас есть разрешение на создание репозиториев, если вы не являетесь членом корпоративный с управляемыми пользователями.

Дополнительные сведения о том, когда можно вкрепить репозиторий, см. в разделе Вилки.

Вы можете просмотреть обзорGitHub, чтобы найти проекты и начать участие в открытый код репозиториях. См . раздел AUTOTITLE.

Дальнейшие действия

Вы создали вилку репозитория, клонировали ее и настроили вышестоящий репозиторий.

  • Дополнительные сведения об использовании Git в командной строке для клонирования и синхронизации изменений см. в разделе Настройка Git.

  • Вы также можете создать новый репозиторий для хранения проектов и совместного использования кода GitHub. Создание репозитория для проекта позволяет хранить код на GitHub. Таким образом вы получаете резервную копию результатов работы, которую можно предоставить другим разработчикам. Дополнительные сведения см. в разделе Краткое руководство по репозиториям.

  • Каждый репозиторий GitHub принадлежит человеку или организации. Вы можете взаимодействовать с людьми, репозиториями и организациями, подключаясь и следуя за ними GitHub. Дополнительные сведения см. в разделе Обнаружение проектов на GitHub.

  • У GitHub большое сообщество поддержки, где можно обратиться за помощью и поговорить с людьми со всего мира. Присоединиться к беседе можно в GitHub Community.