Перейти к содержимому

Как зайти в репозиторий git

  • автор:

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

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

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

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

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

Обзор

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

Screenshot showing the GitHub workflow for information flowing between the upstream, origin, and local clone.

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

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

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

  1. Если вы не уверены, в каком репозитории находится статья, посетите статью с помощью веб-браузера. Щелкните ссылку «Изменить » (значок карандаша) в правом верхнем углу статьи. Screenshot of the pencil edit icon on a Microsoft documentation article.
  2. Это действие принимает вас в исходный файл на GitHub. Имя репозитория отображается в левом верхнем углу страницы. Screenshot of where the repo name is found in a GitHub repo.Ниже приведены некоторые популярные репозитории, доступные для публичный вклад:
    • Документация по 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 основного репозитория нажмите кнопку «Вилку » в правом верхнем углу. Screenshot of the fork icon in the GitHub user interface.
  2. На экране «Создание нового вилки» убедитесь, что для владельца задано имя пользователя, и копировать только основную ветвь проверка. При необходимости измените имя репозитория и поля описания . Screenshot of the Create a new fork screen.

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

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

  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 ). Кроме того, вы увидите свое имя в левом верхнем углу, и вы увидите заметку, которая отображается вилкой, за которой следует имя основного репозитория. Screenshot showing a forked repo in GitHub.
  5. Выберите вкладку «Код» <> в левом верхнем углу страницы.
  6. В раскрывающемся списке «Код» в раскрывающемся списке «Код» скопируйте URL-адрес в параметре HTTPS. Screenshot showing how to copy the clone HTTPS URL in GitHub.

Вы скопировали 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 

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

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

Как начать работать с GitHub

  1. Создаем на сайте GitHub репозиторий. В нашем случае git@github.com:obemgcabazn/*имя репозитория*.git
  2. Открываем в папке проекта командную строку и выполняем команду git init . Она создаст папку .git
  3. git remote add origin https://github.com/obemgcabazn/*имя репозитория*.git Привязываем папку к нашему репозиторию на GitHub (origin — это синоним «удаленного репозитория»).
  4. git add . — эта команда добавит в индекс все файлы из папки
  5. git add -u — (u — updated) добавить в stage файлы измененные с последнего коммита файлы
  6. git status покажет, что на данный момент находится в индексе
  7. git rm -r —cached /frontend/psd/. — Если нам не нужно передавать какие-то файлы в коммит, то можем удалить их из индекса командой rm . Здесь нужно быть внимательным, так как без флагов эта команда удалит и файлы с жесткого диска.
    • Чтобы оставить файлы на диске и удалить их из индекса, есть флаг —cached
    • Если нужно удалить все файлы из индекса, лежащие в какой-то определенной папке, то нужно поставить флаг -r . Чтобы пройти рекурсивно по всем файлам.

Добавить SSH ключи

Если не работает по причине нехватки прав, то, возможно проблема с SSH ключами. Нужно запустить Gti Bash и набрать следующую команду: ssh-keygen -t rsa -C «myemail@mail.ru» . Конечно, указать свой почтовый ящик. На все вопросы нажимаем Enter. После выполнения, в каталоге C:\Documents and Settings\username\.ssh появятся файлы id_rsa и id_rsa.pub.

Далее на GitHub.com заходим в аккаунт в Settings -> SSH and GPG keys -> «New SSH key». В Заголовок вставляем что угодно, что поможет потом понять на какой компьютер установлен ключ (например, имя или место компьютера), а в поле key вставляем содержимое id_rsa.pub .

После этого гитхаб должен перестать ругаться на отсутствие прав доступа.

Часто используемые команды

  • git add файлы — добавляет файлы в индекс
  • git commit — отправляет из индекса в хранилище для дальнейшей отправки (git push) в удаленный репозиторий
  • git reset — файлы заменяет файлы в индексе файлами из последнего коммита
  • git checkout файлы — заменяет файлы проекта ни диске файлами из индекса
  • git push origin master — отправляет файл на сервер, чтобы не вводить каждый раз логин/пароль, воспользуйтесь флагом ‘-u’

Чтобы создать новую ветку, нужно использовать команду git branch [Название_ветки] . Если написать просто git branch — покажет список существующих веток.

git checkout [Название ветки] — выбор ветки

Чтобы создать ветку и сразу ее выбрать git checkout -b [Новая ветка]

Переход к локальному репозиторию [закрыт]

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

Хотите улучшить этот вопрос? Добавьте больше подробностей и уточните проблему, отредактировав это сообщение.

Закрыт 8 лет назад .

Я всегда пользовался интерфейсом гит. Возникла необходимость ввести команду через консоль. Дело в том, что при вводе команды git remote -v показывается не та папка, что мне нужна. Как я могу переключиться на другой локальный репозиторий?

Отслеживать
34k 25 25 золотых знаков 130 130 серебряных знаков 222 222 бронзовых знака
задан 7 окт 2014 в 8:21
9 1 1 серебряный знак 2 2 бронзовых знака

на другой локальный репозиторий? просто перейдите в другой каталог. Или все таки удаленный репозиторий? В общем случае все просто git remote set-url origin git://new.url.here

7 окт 2014 в 8:32

После ввода этой команды, пытаюсь перейти на уже созданную в репозитории ветку git checkout [имя ветки]. Пишет что не может такую найти. Для перехода к локальному репозиторию выполнил следующую команду git remote set-url origin git: C:\DEV\main

7 окт 2014 в 9:03
@KrEnot, что конкретно вам надо осуществить и что не так в текущем выводе remote -v ?
7 окт 2014 в 9:17

Есть 2 локальных репозитория. На данный момент консоль обращается к одному из них. Мне необходимо перейти на второй и работать с ним. Для перехода на нужный мне репозиторий выполнил команду, предложенную выше. После вывода remote -v возвращается следующее: origin git: (fetch) origin git: (push) До попытки перехода на нужный мне репозиторий в каждой строке печатался еще и адрес репозитория. Предположив, что я в нужном репозитории, пытаюсь перейти в уже созданную ветку. Но получаю ответ, что не может найти вводимую мной ветку. Что-то делаю неправильно, но не пойму что.

7 окт 2014 в 9:48

поставлю вопрос по другому — а зачем нужно перейти другой репозиторий? Он совершенно другой, чем Ваш текущий? или «очень похожий».

Шпаргалка по основам Git/GitHub

Если Вы всё еще не знакомы с системой контроля версий и её использование не входит в Ваш рабочий процесс, то сейчас — самое время начать! Это основополагающее руководство поможет Вам начать работу с Git и даст Вам прочный фундамент для дальнейшего развития. Git почти наверняка используется на любом серьёзном проекте и чем раньше Вы научитесь им пользоваться, тем более ценным сотрудником Вы станете для работодателей. Так же, это улучшит Ваш личный опыт, так как Вы без проблем сможете переключаться между несколькими компьютерами, не волнуясь при этом о переносе проекта через флэш накопители… Работа в команде станет гораздо легче. Бывали ли у Вас случаи, когда код становился настолько запутанным, что казалось, будто было бы легче начать проект с нуля? С системой контроля версий Вы сможете просто вернуться к стабильной версии, без всего того что Вы успели воплотить в 4 часа утра.

Git и GitHub

Git — это одна из систем контроля версий. По существу это значит, что она хранит всю историю изменений проекта. История Вашего проекта и история изменений этого же проекта у Ваших коллег — у всего будет копия. Это полная противоположность SVN, где вся история изменений храниться в одном месте.

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

Введение

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

Первым делом мы загрузим Git. Для пользователей Windows я советую установить и Git Bash, который доступен после установки Git. Для пользователей Mac, использование Terminal будет достаточным. После завершения установки приступайте к регистрации аккаунта GitHub. Итак, у Вас есть Git, инструмент командной строки, и GitHub аккаунт, куда Вы будете загружать свои репозитории.

Шпаргалка

Используя Git Bash или Terminal перейдите в корневую директорию проекта. Если Вы используете Git Bash, то с помощью правого клика можно выбрать “Git Bash Here” и он запустится в рабочей директории.

git init
Эта команда создаст .git репозиторий в Вашем проекте. Репозиторий или “repo” это коллекция всех изменений, которые были совершены на протяжении всего времени после инициализации репозитория. Это первое что нужно сделать для нового проекта.

git config —global user.name «Ваше Имя»
git config —global user.email «ВашаПочта@mail.com»
Эти команды определят информацию, которая будет использоваться при каждом commit(фиксирование изменений). Их стоит выполнить всего один раз при первичной установке Git.

git add имяФайла.расширение
Замените “ имяФайла.расширение” на любой файл, изменения которого Вы пытаетесь зафиксировать, например “index.html”. Эта команда добавит файл в “staging area”(участок подготовки). Воспринимайте staging area, как секцию в которой файлы проходят подготовку к перемещению в Ваш репозиторий.

git add .
Если Вы хотите добавить всё из директории проекта в staging area, то эта команда сделает всё сама.

git add *.html
Если Вы хотите добавить все файлы с расширением .html в staging area то эта команда отлично подойдет. Расширение можно менять в зависимости от предпочтений.

git status
Покажет что уже было добавлено в staging area и какие файлы были изменены и ждут перемещения в staging area.

git reset имяФайла.расширение
Убирает выбранный файл из staging area.

git rm —cached имяФайла.расширение
Убирает файл из staging area и определяет его как игнорируемый.

git commit -m «Описание коммита»
Берёт файлы из staging area и “фиксирует” их в Ваш локальный репозиторий. В кавычки следует вставить краткое описание изменений для конкретного коммита. Постарайтесь описать коммит краткими деталями, например: “устранил проблему при изменении имени пользователя” вместо подобных сообщений “какие-то изменения”

touch .gitignore
Эта команда создаст файл с названием .gitignore. Вы можете открыть этот файл в текстовом редакторе и прописать названия файлов или директорий, изменения в которых Вы не хотели бы отслеживать (они будут игнорироваться Git). Изменения в игнорируемых файлах не будут отображаться при выполнении git status .

git branch названиеВетки
Создает сущность, называемую branch(ветвь). Ветвь — это точная копия Ваших файлов.

git checkout “названиеВетки”
Позволит Вам переключить контроль над созданной Вами веткой и работать в её пределах. Здесь Вы можете совершать любые изменения кода. Когда Вы будете готовы можно совершить commit изменений и отправить изменения в GitHub (об этом ниже) или же можно удалить ветвь, если что-то пошло не так или Вам больше не нужны изменения сделанные в этой ветке.

git merge названиеВетки
Находясь в Master(главной) ветви, Вы можете использовать эту команду, чтобы взять коммиты из любой из ветвей и соединить их вместе.

git remote add origin https://github.com/имяПользователя/проект.git
Эта команда определит “местоположение” Вашего удалённого репозитория. Всё что было до этого происходило исключительно в локальном репозитории на Вашем компьютере. Вам нужно будет перейти в GitHub аккаунт и создать новый удалённый репозиторий, куда Вы сможете отправлять изменения из локального репозитория. After you created your remote repository you will be provided with a link and that link is the location you will want to use in the above command.

git remote
Выведет список из всех удалённых репозиториев, которые были добавлены к Вашему проекту.

git push -u origin master
Эта команда отправит локальные изменения в удалённый репозиторий. Таким образом эту команду стоит прописывать только первый раз.

git push
This is what you will use to push your code to GitHub after your initial push.

git clone https://github.com/имяПользователя/проект.git
Если у Вас отсутствует проект на личном или рабочем компьютере, то эта команда поможет клонировать/загрузить весь проект в текущую директорию.

git pull
Если Вы работаете над одним и тем же проектом с несколькими людьми, то эта команда позволит загрузить последнюю версию из удалённого репозитория и обновить вашу локальную версию.

Вывод

Надеюсь это руководство поможет Вам начать и понимать что вообще происходит. Буду рад помочь с уточнениями и ответами на вопросы в комментариях.

Добавить комментарий

Ваш адрес email не будет опубликован. Обязательные поля помечены *