Как создать репозиторий git в Windows

Обновлено: 31.10.2024

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

Чтобы внести свой вклад, вы выполняете эти разовые действия по настройке:

Определите подходящий репозиторий
Подключите репозиторий к своей учетной записи GitHub
Выберите локальную папку для клонированных файлов.
Клонируйте репозиторий на локальный компьютер
Настройте удаленное значение восходящего потока

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

Обзор

Чтобы внести свой вклад в сайт документации Microsoft, вы можете создавать и редактировать файлы Markdown локально, клонируя соответствующий репозиторий документации. Microsoft требует, чтобы вы разветвили соответствующий репозиторий в свою собственную учетную запись GitHub, чтобы у вас были права на чтение и запись для сохранения предлагаемых изменений. Затем вы используете запросы на вытягивание, чтобы объединить изменения в центральный общий репозиторий, доступный только для чтения.

Определить репозиторий

Например, эти популярные репозитории доступны для общего доступа:

Разветвить репозиторий

Используя соответствующий репозиторий, создайте ответвление репозитория в своей собственной учетной записи GitHub с помощью веб-сайта GitHub.

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

Перейдите на страницу GitHub основного репозитория и нажмите кнопку "Разветвление" в правом верхнем углу.

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

Выберите локальную папку

Создайте локальную папку для хранения локальной копии репозитория. Некоторые репозитории могут быть большими; например, до 5 ГБ для azure-docs. Выберите место с доступным дисковым пространством.

Выберите имя папки, которое вам должно быть легко запомнить и ввести. Например, рассмотрите корневую папку C:\docs\ или создайте папку в каталоге вашего профиля пользователя ~/Documents/docs/

Не выбирайте путь к локальной папке, который вложен в другую папку репозитория git. Хотя допустимо хранить клонированные папки git рядом друг с другом, вложение папок git друг в друга приводит к ошибкам при отслеживании файлов.

Запустить Git Bash

Расположением по умолчанию, в котором запускается Git Bash, обычно является домашний каталог (~) или /c/users/ / в ОС Windows.

Чтобы определить текущий каталог, введите pwd в строке $.

Измените каталог (cd) на папку, которую вы создали для локального размещения репозитория. Обратите внимание, что Git Bash использует соглашение Linux о прямой косой черте вместо обратной косой черты для путей к папкам.

Например, cd /c/docs/ или cd ~/Documents/docs/

Создать локальный клон

Используя Git Bash, подготовьтесь к запуску команды clone, чтобы получить копию репозитория (вашего ответвления) на ваше устройство в текущем каталоге.

Аутентификация с помощью Git Credential Manager

Если вы установили последнюю версию Git для Windows и приняли установку по умолчанию, Git Credential Manager включен по умолчанию. Git Credential Manager значительно упрощает аутентификацию, поскольку вам не нужно отзывать свой личный токен доступа при повторном установлении аутентифицированных подключений и удаленных устройств с GitHub.

Запустите команду clone, указав имя репозитория. Клонирование загружает (клонирует) разветвленный репозиторий на ваш локальный компьютер.

Вы можете получить URL-адрес своего форка GitHub для команды клонирования с помощью кнопки «Клонировать» или «Загрузить» в пользовательском интерфейсе GitHub:

Ваша команда clone должна выглядеть примерно так:

При появлении запроса введите свои учетные данные GitHub.

При появлении запроса введите код двухфакторной аутентификации.

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

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

Настроить удаленный восходящий канал

После клонирования репозитория настройте удаленное подключение только для чтения к основному репозиторию с именем upstream. Вы используете восходящий URL-адрес, чтобы синхронизировать локальный репозиторий с последними изменениями, внесенными другими. Команда git remote используется для установки значения конфигурации. Вы используете команду fetch, чтобы обновить информацию о ветке из вышестоящего репозитория.

Если вы используете Git Credential Manager, используйте следующие команды. Замените заполнители и.

Просмотрите настроенные значения и убедитесь, что URL-адреса указаны правильно. Убедитесь, что исходные URL-адреса указывают на вашу личную вилку. Убедитесь, что исходящие URL-адреса указывают на основной репозиторий, например MicrosoftDocs или Azure.

Показан пример удаленного вывода. Вымышленная учетная запись git с именем MyGitAccount настроена с помощью личного токена доступа для доступа к репозиторию azure-docs:

Если вы допустили ошибку, удаленное значение можно удалить. Чтобы удалить исходное значение, выполните команду git remote remove upstream .

Что такое репозиторий Git?

Задачей Git является управление проектом или набором файлов, которые изменяются с течением времени. Git хранит эту информацию в структуре данных, называемой репозиторием. Короче говоря, репозиторий Git — это коллекция всех файлов проекта вместе с их историей. Это виртуальное хранилище вашего проекта, где вы храните все ресурсы/файлы проекта вместе со специальной папкой с именем .git. Папка .git в репозитории git. используется программами GIT для хранения информации о репозитории, такой как Журналы, Положение руководителя и т. д. Он позволяет сохранять версии вашего кода, к которым можно получить доступ, отслеживать и управлять ими.

В этой статье мы мало что знаем об этих терминах, поэтому сведем обсуждение папки .git к минимуму. Пока просто помните, что каждый репозиторий GIT будет иметь скрытую папку .git, чтобы программы GIT могли отслеживать изменения в репозитории.

Различные способы создания репозитория Git

Мы можем создать репозиторий Git, используя один из трех перечисленных ниже подходов:

Создать чистый репозиторий
Инициализировать репозиторий в существующем каталоге проекта
Клонировать удаленный репозиторий из Github

Мы будем использовать инструмент командной строки Git для создания репозиториев, а также для изучения всех операций Git в этой серии руководств. Использование инструмента командной строки Git поможет вам ознакомиться с командами GIT. Использование инструмента командной строки Git обеспечивает большую гибкость, чем клиенты Git или графические интерфейсы пользователя, поскольку они предоставляют только часть функций GIT. Таким образом, чтобы использовать всю мощь Git на профессиональном уровне, рекомендуется использовать инструменты командной строки Git.

Создать чистый репозиторий Git

Создание репозитория Bare Git для нового проекта состоит из трех шагов:

Создать новый проект/папку
Перейти к новому проекту
Инициализировать репозиторий Git для проекта

Установив Git, просто найдите git cmd в строке поиска системы. Вы получите инструмент командной строки в списке, как показано на изображении ниже.

Примечание: это системная панель поиска Windows 8, у вас будет другая панель в зависимости от вашей ОС.

Откройте инструмент командной строки Git, вы увидите окно командной строки, как показано на рисунке ниже.

Шаг 1. Создайте новый проект/папку. Теперь, когда у нас открыт инструмент командной строки, давайте создадим папку проекта. Очень важно создать папку проекта с хорошим именем. Если у вашего проекта хорошее и релевантное название, вам будет легче идентифицировать проект и относиться к нему, когда вы вернетесь к нему в будущем.

Примечание. Обычно люди создают папку корневого проекта с названием компании, например toolsqa, amazon, flipkart и т. д., и в этой корневой папке хранят все различные проекты одной компании. .

Команда для создания папки в системах Windows и Mac — mkdir . Где имя папки - это имя проекта. Давайте назовем наш первый проект LocalGit. С этим именем команда становится: mkdir LocalGit

Перейдите в эту папку с помощью команды cd LocalGit в системах Windows и Mac.

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

Плоский репозиторий Git означает пустой каталог со скрытой папкой .git. Назовем проект BareGitRepo. Перед выполнением следующих шагов убедитесь, что вы находитесь в папке LocalGit. Введите команду mkdir BareGitRepo .

Примечание. Итак, теперь у вас есть готовая корневая папка (LocalGit) и внутри нее проект (BareGitRepository)

Шаг 2. Перейдите к новому проекту. Перейдите к проекту, созданному на предыдущем шаге, с помощью команды cd BareGitRepo .

Шаг 3. Инициализация чистого репозитория Git для проекта. Введите команду git init, эта команда используется для создания репозитория Git. Следовательно, выполнение этой команды создает в нем скрытую папку .git. Другими словами, инициализируется пустой репозиторий Git. Вы увидите сообщение о том, что создан пустой репозиторий Git.

Примечание. git init — это стандартная команда GIT, которая инициализирует каталог с помощью папки .git , используемой для отслеживания версий. артефактов проекта.

Давайте посмотрим содержимое только что инициализированного репозитория Git, выполнив команду dir /ah .

После выполнения dir вы увидите пустую папку проекта, как и ожидалось от репозитория Bare Git. Теперь вы можете добавлять файлы проектов в этот репозиторий, и они будут отслеживаться GIT.

Однако, если вы хотите, чтобы папка .git отображалась в командной строке, используйте команду dir /a:hd . Это покажет скрытые папки в каталоге, и вы увидите там папку .git.

Создать репозиторий Git для существующего проекта

Мы также хотели бы отслеживать существующий проект с помощью Git. В этом случае мы инициализируем репозиторий Git в существующем каталоге проекта. В создании репозитория git для существующего проекта нет ничего сложного, это то же самое, что и создание репозитория git для нового проекта, с той лишь разницей, что шаг 1 не требуется:

~~Создать новый проект/папку~~
Перейти к существующему проекту
Инициализировать репозиторий Git для проекта

Шаг 2. Перейдите к существующему проекту. Перейдите к каталогу, содержащему артефакты вашего проекта. В этом случае предположим, что проект называется SampleProject в расположении C:\Users\admin1\LocalGit\SampleProject, переместите его в аналогичное место на вашем система. Содержимое каталога можно просмотреть с помощью команды dir .

Примечание. У меня уже есть несколько файлов в SampleProject для демонстрационных целей, так что это не пустая папка.

Шаг 3. Инициализация репозитория Git для проекта. Инициализируйте репозиторий git в этом проекте с помощью той же команды, что и при создании пустого репозитория, т. е. git init .

Просмотрите содержимое каталога и обратите внимание, что в нем создана папка .git.

После инициализации Git проект отслеживается GIT.

Клонирование удаленного репозитория с GitHub

Вот шаги для клонирования (загрузки и отслеживания изменений) этого репозитория.

Шаг 2. В Git CMD перейдите к папке для локального хранения всех репозиториев Git. В данном примере это C:\Users\admin1\LocalGit.

Шаг 3. Создайте каталог с именем RemoteCloneRepo для локального хранения исходного кода репозитория Apache POI с помощью команды mkdir RemoteCloneRepo Перемещайтесь внутри этого вновь созданного каталога с помощью команды cd RemoteCloneRepo

Примечание. git clone — это стандартная команда GIT для клонирования существующего удаленного репозитория.

Шаг 5. Клонирование репозитория зависит от размера репозитория. Обычно для большого репозитория требуется некоторое время. Вам придется подождать, пока все файлы не будут извлечены.

Теперь вы можете вносить изменения в репозиторий. Git будет отслеживать все изменения.

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

В этом руководстве представлен обзор того, как настроить репозиторий (репозиторий) под контролем версий Git. Этот ресурс поможет вам инициализировать репозиторий Git для нового или существующего проекта. Ниже приведены примеры рабочих процессов репозиториев, созданных локально и клонированных из удаленных репозиториев. В этом руководстве предполагается базовое знакомство с интерфейсом командной строки.

Инициализация нового репозитория Git
Клонирование существующего репозитория Git
Передача измененной версии файла в репозиторий
Настройка репозитория Git для удаленной совместной работы
Распространенные команды управления версиями Git

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

Что такое репозиторий Git?

Репозиторий Git — это виртуальное хранилище вашего проекта. Он позволяет сохранять версии вашего кода, к которым вы можете получить доступ при необходимости.

Инициализация нового репозитория: git init

Чтобы создать новый репозиторий, используйте команду git init. git init — это одноразовая команда, которую вы используете во время первоначальной настройки нового репо. Выполнение этой команды создаст новый подкаталог .git в вашем текущем рабочем каталоге. Это также создаст новую основную ветвь.

Управление версиями существующего проекта с новым репозиторием git

В этом примере предполагается, что у вас уже есть папка проекта, в которой вы хотите создать репозиторий.Сначала вы перейдете в корневую папку проекта, а затем выполните команду git init.

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

Посетите страницу git init для получения более подробной информации о git init .

Клонирование существующего репозитория: git clone

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

git clone используется для создания копии или клона удаленных репозиториев. Вы передаете git clone URL-адрес репозитория. Git поддерживает несколько различных сетевых протоколов и соответствующих форматов URL. В этом примере мы будем использовать протокол Git SSH. URL-адреса Git SSH следуют шаблону: git@HOSTNAME:USERNAME/REPONAME.git

При выполнении последняя версия файлов удаленного репо в основной ветке будет извлечена и добавлена в новую папку. Новая папка будет названа в честь REPONAME, в данном случае javascript-data-store. Папка будет содержать полную историю удаленного репозитория и только что созданную основную ветку.

Дополнительную документацию по использованию git clone и поддерживаемым форматам URL-адресов Git см. на странице git clone.

Сохранение изменений в репозиторий: git add и git commit

Измените каталоги на /path/to/project
Создайте новый файл CommitTest.txt с содержимым ~"test content for git tutorial"~
git добавить CommitTest.txt в промежуточную область репозитория
Создать новую фиксацию с сообщением о том, какая работа была проделана в фиксации.

После выполнения этого примера ваш репозиторий теперь будет иметь CommitTest.txt, добавленный в историю, и будет отслеживать будущие обновления файла.

В этом примере представлены две дополнительные команды git: add и commit . Это был очень ограниченный пример, но обе команды более подробно описаны на страницах git add и git commit. Другим распространенным вариантом использования git add является параметр --all. Выполнение команды git add --all возьмет все измененные и неотслеживаемые файлы в репозитории, добавит их в репозиторий и обновит рабочее дерево репозитория.

Совместная работа репозиториев: git push

Важно понимать, что идея Git о «рабочей копии» сильно отличается от рабочей копии, которую вы получаете, проверяя исходный код из репозитория SVN. В отличие от SVN, Git не делает различий между рабочими копиями и центральным репозиторием — все они являются полноценными репозиториями Git.

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

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

Голые и клонированные репозитории

Если вы использовали git clone в предыдущем разделе «Инициализация нового репозитория» для настройки локального репозитория, ваш репозиторий уже настроен для удаленной совместной работы. git clone автоматически настроит ваш репозиторий с удаленным указанием URL-адреса Git, с которого вы его клонировали. Это означает, что как только вы внесете изменения в файл и зафиксируете их, вы можете git отправить эти изменения в удаленный репозиторий.

Если вы использовали git init для создания нового репозитория, у вас не будет удаленного репозитория, в который можно было бы отправить изменения. Распространенным шаблоном при инициализации нового репозитория является переход к размещенной службе Git, такой как Bitbucket, и создание там репозитория. Служба предоставит URL-адрес Git, который затем можно добавить в локальный репозиторий Git и выполнить git push в размещенном репозитории. После того, как вы создали удаленное репо с выбранной вами службой, вам нужно будет обновить локальное репо с помощью сопоставления. Мы обсуждаем этот процесс в руководстве по настройке и настройке ниже.

Если вы предпочитаете размещать собственное удаленное репозиторий, вам необходимо настроить «голый репозиторий». И git init, и git clone принимают аргумент --bare. Самый распространенный вариант использования пустого репозитория — создание удаленного центрального репозитория Git

Конфигурация и настройка: git config

После того как вы настроите удаленное репо, вам нужно будет добавить URL-адрес удаленного репо в локальную конфигурацию git и установить восходящую ветвь для ваших локальных ветвей. Удаленная команда git предлагает такую утилиту.

Эта команда сопоставит удаленный репозиторий со ссылкой в вашем локальном репозитории в разделе .После того, как вы сопоставили удаленное репо, вы можете отправить в него локальные ветки.

Эта команда переместит ветку локального репо в удаленное репо по адресу .

Более подробные сведения о git remote см. на странице Git remote .

В дополнение к настройке URL-адреса удаленного репозитория вам также может потребоваться установить глобальные параметры конфигурации Git, такие как имя пользователя или адрес электронной почты. Команда git config позволяет настроить установку Git (или отдельный репозиторий) из командной строки. Эта команда может определить все, от информации о пользователе до настроек и поведения репозитория. Ниже перечислены несколько общих параметров конфигурации.

Git хранит параметры конфигурации в трех отдельных файлах, что позволяет распространять параметры на отдельные репозитории (локальные), пользовательские (глобальные) или всю систему (система):

Локальный: /.git/config — настройки для конкретного репозитория.
Глобальный: /.gitconfig — пользовательские настройки. Здесь хранятся параметры, установленные с помощью флага --global.
Система: $(префикс)/etc/gitconfig — общесистемные настройки.

Укажите имя автора, которое будет использоваться для всех коммитов в текущем репозитории. Как правило, вы хотите использовать флаг --global для установки параметров конфигурации для текущего пользователя.

Укажите имя автора, которое будет использоваться для всех коммитов текущего пользователя.

Добавление параметра --local или вообще отсутствие передачи параметра уровня конфигурации приведет к установке user.name для текущего локального репозитория.

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

Создайте ярлык для команды Git. Это мощная утилита для создания пользовательских ярлыков для часто используемых команд git. Упрощенный пример:

При этом создается команда ci, которую можно выполнить как ярлык для git commit . Чтобы узнать больше о псевдонимах git, посетите страницу конфигурации git.

Определить текстовый редактор, используемый такими командами, как git commit, для всех пользователей на текущем компьютере. Аргументом должна быть команда, запускающая нужный редактор (например, vi). В этом примере представлена опция --system. Параметр --system установит конфигурацию для всей системы, то есть для всех пользователей и репозиториев на машине. Для получения более подробной информации об уровнях конфигурации посетите страницу конфигурации git.

Откройте файл глобальной конфигурации в текстовом редакторе для редактирования вручную. Подробное руководство по настройке текстового редактора для работы с git можно найти на странице конфигурации Git.

Обсуждение

Все параметры конфигурации хранятся в файлах с открытым текстом, поэтому команда git config на самом деле является просто удобным интерфейсом командной строки. Как правило, вам нужно настроить установку Git только в первый раз, когда вы начинаете работать на новой машине для разработки, и практически во всех случаях вам нужно использовать флаг --global. Одним из важных исключений является переопределение адреса электронной почты автора. Вы можете указать свой личный адрес электронной почты для личных и открытых репозиториев, а также свой профессиональный адрес электронной почты для рабочих репозиториев.

Git хранит параметры конфигурации в трех отдельных файлах, что позволяет применять параметры к отдельным репозиториям, пользователям или всей системе:

/.git/config — настройки для конкретного репозитория.
~/.gitconfig — пользовательские настройки. Здесь хранятся параметры, установленные с помощью флага --global.
$(prefix)/etc/gitconfig — общесистемные настройки.

Когда параметры в этих файлах конфликтуют, локальные настройки переопределяют пользовательские настройки, которые переопределяют общесистемные. Если вы откроете любой из этих файлов, вы увидите примерно следующее:

Вы можете вручную отредактировать эти значения точно так же, как в git config .

Пример

Первое, что вам нужно сделать после установки Git, — это сообщить ему свое имя/адрес электронной почты и настроить некоторые параметры по умолчанию. Типичная начальная конфигурация может выглядеть примерно так:

Сообщите Git, кто вы git config

Выберите свой любимый текстовый редактор

Добавить несколько псевдонимов в стиле SVN

Это создаст файл ~/.gitconfig из предыдущего раздела. Подробно ознакомьтесь с git config на странице git config.

Обзор

Здесь мы продемонстрировали, как создать репозиторий git, используя два метода: git init и git clone. Это руководство можно применять для управления исходным кодом программного обеспечения или другим содержимым, для которого требуется управление версиями. Git add, git commit, git push и git remote также были представлены и использовались на высоком уровне.

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

Если вам нужна помощь в настройке, вот удобное руководство по установке и настройке Git.

Окна

Откройте командную строку из меню "Пуск" > "Система Windows" или нажмите Windows + R, затем введите cmd и нажмите "ОК".

Если вы создали для своего проекта папку с названием shop в папке Projects в вашем домашнем каталоге, вам потребуется выполнить следующую команду:

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

Откройте приложение «Терминал», которое можно найти в разделе «Приложения» > «Утилиты».

< бр />

Кроме того, вы можете щелкнуть и перетащить папку в окно терминала, которое автоматически введет путь к каталогу.

Линукс

Откройте приложение "Терминал" из меню "Пуск" или нажав Ctrl + Alt + T.

Фактическое создание репозитория

Теперь, когда вы находитесь в правильном каталоге, введите git init в командной строке и нажмите клавишу ввода, чтобы создать новый пустой репозиторий Git. В случае успеха вы должны увидеть следующее сообщение:

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

Эта папка .git является вашей локальной копией репозитория. Удаление папки .git не приведет к удалению файлов вашего проекта, однако вы потеряете доступ ко всем историческим изменениям, отслеживаемым Git.

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

Не волнуйтесь, если что-то из этого сейчас не имеет большого смысла. Все, что вам нужно знать, это то, что папка .git создается запуском git init и является вашей собственной версией репозитория проекта.

Читайте также: