Как подключить локальный репозиторий

Настройка локального репозитория Git для документации

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

Чтобы начать участие, выполните следующие однократные действия по настройке:

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

Если вы вносите только незначительные изменения, вам не нужно выполнить действия, описанные в этой статье. См. статью «Изменить» в браузере , чтобы узнать, как быстро изменять без установки средств.

Обзор

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

Репозиторий Майкрософт называется репозиторием вышестоящий. Используя действие вилки в пользовательском интерфейсе GitHub, пользователь перекваливали репозиторий Майкрософт в собственную учетную запись GitHub. Этот вилки называется источником. Используя клон git, пользователь клонирует источник на локальный компьютер. Наконец, пользователь использует удаленное добавление git вышестоящий для подключения локального клона обратно к репозиторию Microsoft вышестоящий.

Определение репозитория

Документация, размещенная в Microsoft Learn , находится в нескольких репозиториях на GitHub.

1. Если вы не уверены, в каком репозитории находится статья, посетите статью с помощью веб-браузера. Щелкните ссылку «Изменить » (значок карандаша) в правом верхнем углу статьи.
2. Это действие принимает вас в исходный файл на GitHub. Имя репозитория отображается в левом верхнем углу страницы. Ниже приведены некоторые популярные репозитории, доступные для публичный вклад:
   • Документация по Azure https://github.com/MicrosoftDocs/azure-docs
   • Документация по SQL Server https://github.com/MicrosoftDocs/sql-docs
   • Документация по Visual Studio https://github.com/MicrosoftDocs/visualstudio-docs
   • Документация по .NET https://github.com/dotnet/docs
   • Документация по пакету SDK для Azure .NET https://github.com/azure/azure-docs-sdk-dotnet
   • Документация по Configuration Manager https://github.com/MicrosoftDocs/SCCMdocs

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

После определения правильного репозитория следующий шаг — вилку репозитория в собственную учетную запись GitHub.

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

1. На странице GitHub основного репозитория нажмите кнопку «Вилку » в правом верхнем углу.
2. На экране «Создание нового вилки» убедитесь, что для владельца задано имя пользователя, и копировать только основную ветвь проверка. При необходимости измените имя репозитория и поля описания .

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

Клонирование означает создание копии репозитория на локальном компьютере.

1. НЕ клонируйте локальные репозитории в папки, синхронизированные с OneDrive. При выборе папки, в которую вы клонируете репозиторий, избегайте синхронизации папок с OneDrive (например, папка «Документы «). OneDrive может вызвать непреднамеренные конфликт слияния при слиянии изменений обратно в основную ветвь. Вместо этого рекомендуется создать короткий путь к файлу на C:\ диске (например, C:\GitHub).
2. Git в Windows. Включение длинных имен путей. По умолчанию Git для Windows отключает поддержку длинных путей к файлам, что предотвращает клонирование любого файла с целевым путем с длиной больше 255 символов. Включите длинные пути к файлам, чтобы избежать этой проблемы, выполнив следующую команду от имени администратора:
   git config —global core.longpaths true

1. Создайте папку GitHub на локальном компьютере. Например, C:\GitHub. (Не клонируйте приложение синхронизации OneDrive папку.)
2. В браузере перейдите к GitHub.com и войдите в систему.
3. В GitHub справа в раскрывающемся списке профиля выберите репозитории. Откроется страница репозиториев со списком вилированных репозиториев.
4. Выберите репозиторий, который требуется клонировать. Откроется страница репозитория вашего вилки. Убедитесь, что вы находитесь на странице репозитория для вилки, а не на странице рабочего репозитория. Вы можете убедиться, что репозиторий, на который вы работаете, является вилкой, проверка URL-адрес: он должен отображать имя пользователя GitHub, а не организацию Майкрософт (например, https://github.com/nancydavolio/azure-docs и НЕ https://github.com/MicrosoftDocs/azure-docs ). Кроме того, вы увидите свое имя в левом верхнем углу, и вы увидите заметку, которая отображается вилкой, за которой следует имя основного репозитория.
5. Выберите вкладку «Код» <> в левом верхнем углу страницы.
6. В раскрывающемся списке «Код» в раскрывающемся списке «Код» скопируйте URL-адрес в параметре HTTPS.

Вы скопировали URL-адрес клона через Пользовательский интерфейс GitHub. Остальные шаги должны выполняться в терминале VS Code.

Клонирование из Visual Studio Code

1. Откройте Visual Studio Code.
2. В верхнем меню навигации выберите «Вид » и выберите «Терминал«. Представление терминала отображается в нижней части экрана Visual Studio Code.
3. В представлении терминала выполните команду, чтобы изменить каталог (cd) на GitHub папку, созданную для репозиториев на диске на шаге 1 в разделе клонирования репозитория. Пример:

 cd C:\GitHub 

git clone

git clone https://github.com/nancydavolio/azure-docs.git 

Настройка удаленных служб

После клонирования репозитория следует установить удаленное подключение только для чтения, называемое вышестоящим, к основному репозиторию. Удаленные — это псевдонимы , ссылающиеся на удаленные репозитории. Источник ссылается на вилку и вышестоящий ссылается на рабочий репозиторий. Git автоматически создал удаленный origin при выполнении clone команды. С помощью URL-адреса вышестоящего подключения вы сможете обеспечить синхронизацию вашего локального репозитория с последними правками, внесенными другими участниками.

Выполните следующие команды в терминале Git Bash или VS Code.

Измените каталог ( cd ) в папку репозитория, созданную командой clone . Например:

cd repo-name 

git remote add upstream

git remote add upstream https://github.com/MicrosoftDocs/azure-docs.git 

git remote -v 

Пример выходных данных:

origin https://github.com/nancydavolio/azure-docs.git (fetch) origin https://github.com/nancydavolio/azure-docs.git (push) upstream https://github.com/MicrosoftDocs/azure-docs.git (fetch) upstream https://github.com/MicrosoftDocs/azure-docs.git (push) 

git remote remove upstream 

Следующие шаги

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

#5 — Введение в GitHub. Работа с удаленным репозиторием

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

Видеоурок

Полезные ссылки:

1. Официальный сайт GitHub ;
2. Синтаксис Markdown .

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

1. Как подключиться к удаленному репозитарию?

Для загрузки данных в удаленный репозитарию сначала нужно к нему подключиться. В нашем примере мы используем адрес https://github.com/tutorialzine/awesome-project, однако пользователь может создать собственный удаленный репозитарий на GitHub, BitBucket или другом подобном сервисе. Это занимает некоторое время, однако в дальнейшем полностью себя оправдывает, тем более, что подобные службы имеют пошаговые инструкции для правильно выполнения нужных действий.

Для того, чтобы связать созданный нами локальный репозитарий с удаленным, выполним такую команду:

# This is only an example. Replace the URI with your own repository address. $ git remote add origin https://github.com/tutorialzine/awesome-project.git

Первая строка напоминает нам, что URI репозитария, который приведен в примере, нужно изменить на свой.

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

1. Как отправить изменения в удаленный репозитарий?

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

Отправка коммита осуществляется с помощью команды push, которая имеет два параметра — имя удаленного репозитория (в нашем случае origin) и ветку, в которую необходимо внести изменения (master — это ветка по умолчанию для всех репозиториев).

$ git push origin master Counting objects: 3, done. Writing objects: 100% (3/3), 212 bytes | 0 bytes/s, done. Total 3 (delta 0), reused 0 (delta 0) To https://github.com/tutorialzine/awesome-project.git * [new branch] master -> master

Если мы все сделали правильно, то отправленный файл hello.txt на удаленном сервере мы можем увидеть с помощью браузера. Важный момент – некоторые сервисы для отправки изменений могут требовать дополнительной аутентификации.

1. Как клонировать удаленный репозитарий?

Если у других пользователей возникла необходимость клонировать удаленный репозитарий, они могут получить полностью работоспособную копию при помощи команды clone:

$ git clone https://github.com/tutorialzine/awesome-project.git

GitHub автоматически создаст новый локальный репозитарий в виде удаленного на собственном сервере.

1. Как запросить изменения с удаленного репозитария?

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

$ git pull origin master From https://github.com/tutorialzine/awesome-project * branch master -> FETCH_HEAD Already up-to-date.

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

Задание к уроку

Необходимо оформить подписку на проект, чтобы получить доступ ко всем домашним заданиям

Большое задание по курсу

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

Команда git remote add origin для работы с удаленными репозиториями

Как создать удаленный репозиторий, подключиться к нему и какие команды Git использовать.

Эта инструкция — часть курса «Введение в Git».

Смотреть весь курс

Введение

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

Немного теории

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

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

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

Имена веток слежения имеют вид / . Если один из разработчиков произвел отправку на удаленный сервер ветки develop, когда у второго разработчика есть своя локальная ветка develop, то удаленная ветка будет называться origin/develop и соответственно быть веткой слежения. При разработке orgin по умолчанию называется удаленный сервер.

git remote add origin

git remote add origin https://github.com/ИМЯПОЛЬЗОВАТЕЛЯ/РЕПОЗИТОРИЙ.git

git remote add origin git@github.com:ИМЯПОЛЬЗОВАТЕЛЯ/РЕПОЗИТОРИЙ.git

ssh-keygen -t ed25519 -C "ПОЧТА_GitHub_АККАУНТА" ssh-keygen -t rsa -b 4096 -C "ПОЧТА_GitHub_АККАУНТА"

git remote

git ls-remote

git remote show

git push --set-upstream origin develop

git fetch [remote-name]

git pull 

git fetch; git merge

git clone [url]

git clone https://github.com/ИМЯПОЛЬЗОВАТЕЛЯ/РЕПОЗИТОРИЙ.git

git clone git@github.com:ИМЯПОЛЬЗОВАТЕЛЯ/РЕПОЗИТОРИЙ.git

git clone --single-branch [url]

git clone -o ticgit

git remote rm