Git remote add origin что делает

2.5 Основы Git — Работа с удалёнными репозиториями

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

Примечание
Удалённый репозиторий может находиться на вашем локальном компьютере.

Вполне возможно, что удалённый репозиторий будет находиться на том же компьютере, на котором работаете вы. Слово «удалённый» не означает, что репозиторий обязательно должен быть где-то в сети или Интернет, а значит только — где-то ещё. Работа с таким удалённым репозиторием подразумевает выполнение стандартных операций отправки и получения, как и с любым другим удалённым репозиторием.

Просмотр удалённых репозиториев

Для того, чтобы просмотреть список настроенных удалённых репозиториев, вы можете запустить команду git remote . Она выведет названия доступных удалённых репозиториев. Если вы клонировали репозиторий, то увидите как минимум origin — имя по умолчанию, которое Git даёт серверу, с которого производилось клонирование:

$ git clone https://github.com/schacon/ticgit Cloning into 'ticgit'. remote: Reusing existing pack: 1857, done. remote: Total 1857 (delta 0), reused 0 (delta 0) Receiving objects: 100% (1857/1857), 374.35 KiB | 268.00 KiB/s, done. Resolving deltas: 100% (772/772), done. Checking connectivity. done. $ cd ticgit $ git remote origin

Вы можете также указать ключ -v , чтобы просмотреть адреса для чтения и записи, привязанные к репозиторию:

$ git remote -v origin https://github.com/schacon/ticgit (fetch) origin https://github.com/schacon/ticgit (push)

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

$ cd grit $ git remote -v bakkdoor https://github.com/bakkdoor/grit (fetch) bakkdoor https://github.com/bakkdoor/grit (push) cho45 https://github.com/cho45/grit (fetch) cho45 https://github.com/cho45/grit (push) defunkt https://github.com/defunkt/grit (fetch) defunkt https://github.com/defunkt/grit (push) koke git://github.com/koke/grit.git (fetch) koke git://github.com/koke/grit.git (push) origin git@github.com:mojombo/grit.git (fetch) origin git@github.com:mojombo/grit.git (push)

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

Обратите внимание на разнообразие протоколов, используемых при указании адреса удалённого репозитория; подробнее мы рассмотрим протоколы в разделе Установка Git на сервер главы 4.

Добавление удалённых репозиториев

В предыдущих разделах мы уже упоминали и приводили примеры добавления удалённых репозиториев, сейчас рассмотрим эту операцию подробнее. Для того, чтобы добавить удалённый репозиторий и присвоить ему имя (shortname), просто выполните команду git remote add :

$ git remote origin $ git remote add pb https://github.com/paulboone/ticgit $ git remote -v origin https://github.com/schacon/ticgit (fetch) origin https://github.com/schacon/ticgit (push) pb https://github.com/paulboone/ticgit (fetch) pb https://github.com/paulboone/ticgit (push)

Теперь вместо указания полного пути вы можете использовать pb . Например, если вы хотите получить изменения, которые есть у Пола, но нету у вас, вы можете выполнить команду git fetch pb :

$ git fetch pb remote: Counting objects: 43, done. remote: Compressing objects: 100% (36/36), done. remote: Total 43 (delta 10), reused 31 (delta 5) Unpacking objects: 100% (43/43), done. From https://github.com/paulboone/ticgit * [new branch] master -> pb/master * [new branch] ticgit -> pb/ticgit

Ветка master из репозитория Пола сейчас доступна вам под именем pb/master . Вы можете слить её с одной из ваших веток или переключить на неё локальную ветку, чтобы просмотреть содержимое ветки Пола. Более подробно работа с ветками рассмотрена в главе Ветвление в Git.

Получение изменений из удалённого репозитория — Fetch и Pull

Как вы только что узнали, для получения данных из удалённых проектов, следует выполнить:

$ git fetch [remote-name]

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

Когда вы клонируете репозиторий, команда clone автоматически добавляет этот удалённый репозиторий под именем «origin». Таким образом, git fetch origin извлекает все наработки, отправленные на этот сервер после того, как вы его клонировали (или получили изменения с помощью fetch). Важно отметить, что команда git fetch забирает данные в ваш локальный репозиторий, но не сливает их с какими-либо вашими наработками и не модифицирует то, над чем вы работаете в данный момент. Вам необходимо вручную слить эти данные с вашими, когда вы будете готовы.

Если ветка настроена на отслеживание удалённой ветки (см. следующий раздел и главу Ветвление в Git чтобы получить больше информации), то вы можете использовать команду git pull чтобы автоматически получить изменения из удалённой ветки и слить их со своей текущей. Этот способ может для вас оказаться более простым или более удобным. К тому же, по умолчанию команда git clone автоматически настраивает вашу локальную ветку master на отслеживание удалённой ветки master на сервере, с которого вы клонировали репозиторий. Название веток может быть другим и зависит от ветки по умолчанию на сервере. Выполнение git pull , как правило, извлекает (fetch) данные с сервера, с которого вы изначально клонировали, и автоматически пытается слить (merge) их с кодом, над которым вы в данный момент работаете.

Примечание

Начиная с версии 2.27, команда git pull выдаёт предупреждение, если настройка pull.rebase не установлена. Git будет выводить это предупреждение каждый раз пока настройка не будет установлена.

Если хотите использовать поведение Git по умолчанию (простое смещение вперёд если возможно — иначе создание коммита слияния): git config —global pull.rebase «false»

Если хотите использовать перебазирование при получении изменений: git config —global pull.rebase «true»

Отправка изменений в удалённый репозиторий (Push)

Когда вы хотите поделиться своими наработками, вам необходимо отправить их в удалённый репозиторий. Команда для этого действия простая: git push . Чтобы отправить вашу ветку master на сервер origin (повторимся, что клонирование обычно настраивает оба этих имени автоматически), вы можете выполнить следующую команду для отправки ваших коммитов:

$ git push origin master

Эта команда срабатывает только в случае, если вы клонировали с сервера, на котором у вас есть права на запись, и если никто другой с тех пор не выполнял команду push . Если вы и кто-то ещё одновременно клонируете, затем он выполняет команду push , а после него выполнить команду push попытаетесь вы, то ваш push точно будет отклонён. Вам придётся сначала получить изменения и объединить их с вашими и только после этого вам будет позволено выполнить push . Обратитесь к главе Ветвление в Git для более подробного описания, как отправлять изменения на удалённый сервер.

Просмотр удалённого репозитория

Если хотите получить побольше информации об одном из удалённых репозиториев, вы можете использовать команду git remote show . Выполнив эту команду с некоторым именем, например, origin , вы получите следующий результат:

$ git remote show origin * remote origin Fetch URL: https://github.com/schacon/ticgit Push URL: https://github.com/schacon/ticgit HEAD branch: master Remote branches: master tracked dev-branch tracked Local branch configured for 'git pull': master merges with remote master Local ref configured for 'git push': master pushes to master (up to date)

Она выдаёт URL удалённого репозитория, а также информацию об отслеживаемых ветках. Эта команда любезно сообщает вам, что если вы, находясь на ветке master , выполните git pull , ветка master с удалённого сервера будет автоматически влита в вашу сразу после получения всех необходимых данных. Она также выдаёт список всех полученных ею ссылок.

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

$ git remote show origin * remote origin URL: https://github.com/my-org/complex-project Fetch URL: https://github.com/my-org/complex-project Push URL: https://github.com/my-org/complex-project HEAD branch: master Remote branches: master tracked dev-branch tracked markdown-strip tracked issue-43 new (next fetch will store in remotes/origin) issue-45 new (next fetch will store in remotes/origin) refs/remotes/origin/issue-11 stale (use 'git remote prune' to remove) Local branches configured for 'git pull': dev-branch merges with remote dev-branch master merges with remote master Local refs configured for 'git push': dev-branch pushes to dev-branch (up to date) markdown-strip pushes to markdown-strip (up to date) master pushes to master (up to date)

Данная команда показывает какая именно локальная ветка будет отправлена на удалённый сервер по умолчанию при выполнении git push . Она также показывает, каких веток с удалённого сервера у вас ещё нет, какие ветки всё ещё есть у вас, но уже удалены на сервере, и для нескольких веток показано, какие удалённые ветки будут в них влиты при выполнении git pull .

Удаление и переименование удалённых репозиториев

Для переименования удалённого репозитория можно выполнить git remote rename . Например, если вы хотите переименовать pb в paul , вы можете это сделать при помощи git remote rename :

$ git remote rename pb paul $ git remote origin paul

Стоит упомянуть, что это также изменит имена удалённых веток в вашем репозитории. То, к чему вы обращались как pb/master , теперь стало paul/master .

Если по какой-то причине вы хотите удалить удалённый репозиторий — вы сменили сервер или больше не используете определённое зеркало, или кто-то перестал вносить изменения — вы можете использовать git remote rm :

$ git remote remove paul $ git remote origin

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

�� Как использовать команду git remote add origin для удаленной отправки

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

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

Когда разработчики хотят взять свой локальный репозиторий Git и поделиться им с другим разработчиком или отправить код в облачную распределенную службу контроля версий, такую как GitHub или GitLab, они могут использовать команду git remote add origin.

Три файла и два коммита

Прежде чем следовать этому учебнику по git remote add origin, настройте локальную установку Git, локально инициализированный репозиторий по крайней мере с одним коммитом Git и учетную запись в GitHub или GitLab.

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

Начните с локального репозитория, хранящегося в папке с именем my-local-repo, в которой находятся три файлов:

Сам репозиторий имеет только две коммита, которые вы можете увидеть, выполнив команду git reflog, как показано на рисунке ниже.

Reflog – это сокращение от reference logs.

Создайте удаленный репозиторий на GitHub

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

Создать удаленный репозиторий легко.

Войдите в GitHub и воспользуйтесь мастером «Create a new repository».

В этом примере я назвал репозиторий GitHub my-github-repo, чтобы четко отличить его от репозитория Git, который хранится локально в папке с именем my-local-repo.

Поскольку вы будете передавать информацию в репозиторий GitHub, не инициализируйте ее с помощью README, настройте файл gitignore или добавьте лицензию.

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

Если эти ресурсы существуют в обоих репозиториях до запуска команды git remote add origin, это создаст дополнительные шаги слияния и разрешения конфликтов, которых легко избежать.

Скопируйте и измените URL удаленного добавления GitHub

Когда GitHub создает ваш репозиторий, он представляет ссылку HTTP, которая требуется как часть команды git remote add origin.

При условии, что URL-адрес уникально идентифицирует созданный мной репозиторий GitHub:

http://github.com/cameronmcnz/my-github-repo.git

Скопируйте и вставьте этот URL-адрес в текстовый редактор, а затем добавьте свое имя пользователя и пароль в начало URL-адреса:

http://cameronmcnz:T55tutorial@github.com/cameronmcnz/my-github-repo.git

Эта настройка URL позволяет аутентифицировать файл без использования диспетчера учетных данных или другого инструмента управления паролями.

Запустите команду git remote add origin

С URL-адресом GitHub, сохраненным в буфере обмена в папке, содержащей локальный репозиторий Git, откройте окно терминала и выполните следующую команду git remote add origin:

git remote add origin http://cameronmcnz:T55tutorial@github.com/cameronmcnz/my-github-repo.git

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

Чтобы убедиться, что удаленное хранилище было добавлено в вашу конфигурацию, используйте команду git remote –v.

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

Выполните git push

Наконец, с настроенной службой GitHub отправьте все свои локальные изменения кода, историю изменений на удаленный сервер с помощью команды git push.

Убедитесь, что вы указали опцию –set-upstream, иначе удаленный сервер отклонит операцию.

Также включите название ветки, которую нужно нажать, которая в этом случае является master.

git push --set-upstream origin master

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

Убедитесь, что прошел git push на GitHub

После завершения команд git remote add и push вернитесь к экземпляру GitHub и посмотрите на содержимое недавно созданного репозитория.

Результат локальной команды git remote add и push отражается в удаленном репозитории GitHub.

Удаленный репозиторий GitHub должен содержать все файлы, которые составляют ваш локальный репозиторий, и в то же время хранить копию вашей истории коммитов.

Если вы посмотрите на мой репозиторий GitHub, вы увидите файлы HelloWorld.java, index.html и style.css, а также указание на то, что репозиторий содержит две фиксации.

Эти файлы и коммиты соответствуют выводу команды git reflog с самого начала этого урока.

Управление удаленными репозиториями

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

Platform navigation

Adding a remote repository

To add a new remote, use the git remote add command on the terminal, in the directory your repository is stored at.

The git remote add command takes two arguments:

• A remote name, for example, origin
• A remote URL, for example, https://github.com/OWNER/REPOSITORY.git

$ git remote add origin https://github.com/OWNER/REPOSITORY.git # Set a new remote $ git remote -v # Verify new remote > origin https://github.com/OWNER/REPOSITORY.git (fetch) > origin https://github.com/OWNER/REPOSITORY.git (push) 

For more information on which URL to use, see «About remote repositories.»

Troubleshooting: Remote origin already exists

This error means you’ve tried to add a remote with a name that already exists in your local repository.

$ git remote add origin https://github.com/octocat/Spoon-Knife.git > fatal: remote origin already exists. 

To fix this, you can:

• Use a different name for the new remote.
• Rename the existing remote repository before you add the new remote. For more information, see «Renaming a remote repository» below.
• Delete the existing remote repository before you add the new remote. For more information, see «Removing a remote repository» below.

Changing a remote repository’s URL

The git remote set-url command changes an existing remote repository URL.

Tip: For information on the difference between HTTPS and SSH URLs, see «About remote repositories.»

The git remote set-url command takes two arguments:

• An existing remote name. For example, origin or upstream are two common choices.
• A new URL for the remote. For example:
  • If you’re updating to use HTTPS, your URL might look like:

  https://github.com/OWNER/REPOSITORY.git 

  • If you’re updating to use SSH, your URL might look like:

  git@github.com:OWNER/REPOSITORY.git 

  Switching remote URLs from SSH to HTTPS

  1. Open Terminal Terminal Git Bash .
  2. Change the current working directory to your local project.
  3. List your existing remotes in order to get the name of the remote you want to change.

  $ git remote -v > origin git@github.com:OWNER/REPOSITORY.git (fetch) > origin git@github.com:OWNER/REPOSITORY.git (push) 

  git remote set-url origin https://github.com/OWNER/REPOSITORY.git 

  $ git remote -v # Verify new remote URL > origin https://github.com/OWNER/REPOSITORY.git (fetch) > origin https://github.com/OWNER/REPOSITORY.git (push) 

  The next time you git fetch , git pull , or git push to the remote repository, you’ll be asked for your GitHub username and password. When Git prompts you for your password, enter your personal access token. Alternatively, you can use a credential helper like Git Credential Manager. Password-based authentication for Git has been removed in favor of more secure authentication methods. For more information, see «Managing your personal access tokens.»

  You can use a credential helper so Git will remember your GitHub username and personal access token every time it talks to GitHub.

  Switching remote URLs from HTTPS to SSH

  1. Open Terminal Terminal Git Bash .
  2. Change the current working directory to your local project.
  3. List your existing remotes in order to get the name of the remote you want to change.

  $ git remote -v > origin https://github.com/OWNER/REPOSITORY.git (fetch) > origin https://github.com/OWNER/REPOSITORY.git (push) 

  git remote set-url origin git@github.com:OWNER/REPOSITORY.git 

  $ git remote -v # Verify new remote URL > origin git@github.com:OWNER/REPOSITORY.git (fetch) > origin git@github.com:OWNER/REPOSITORY.git (push) 

  Troubleshooting: No such remote ‘[name]’

  This error means that the remote you tried to change doesn’t exist:

  $ git remote set-url sofake https://github.com/octocat/Spoon-Knife > fatal: No such remote 'sofake' 

  Check that you’ve correctly typed the remote name.

  Renaming a remote repository

  Use the git remote rename command to rename an existing remote.

  The git remote rename command takes two arguments:

  • An existing remote name, for example, origin
  • A new name for the remote, for example, destination

  Example of renaming a remote repository

  These examples assume you’re cloning using HTTPS, which is recommended.

  $ git remote -v # View existing remotes > origin https://github.com/OWNER/REPOSITORY.git (fetch) > origin https://github.com/OWNER/REPOSITORY.git (push) $ git remote rename origin destination # Change remote name from 'origin' to 'destination' $ git remote -v # Verify remote's new name > destination https://github.com/OWNER/REPOSITORY.git (fetch) > destination https://github.com/OWNER/REPOSITORY.git (push) 

  Troubleshooting: Could not rename config section ‘remote.[old name]’ to ‘remote.[new name]’

  This error means that the old remote name you typed doesn’t exist.

  You can check which remotes currently exist with the git remote -v command:

  $ git remote -v # View existing remotes > origin https://github.com/OWNER/REPOSITORY.git (fetch) > origin https://github.com/OWNER/REPOSITORY.git (push) 

  Troubleshooting: Remote [new name] already exists

  This error means that the remote name you want to use already exists. To solve this, either use a different remote name, or rename the original remote.

  Removing a remote repository

  Use the git remote rm command to remove a remote URL from your repository.

  The git remote rm command takes one argument:

  • A remote name, for example, destination

  Removing the remote URL from your repository only unlinks the local and remote repositories. It does not delete the remote repository.

  Example of removing a remote repository

  These examples assume you’re cloning using HTTPS, which is recommended.

  $ git remote -v # View current remotes > origin https://github.com/OWNER/REPOSITORY.git (fetch) > origin https://github.com/OWNER/REPOSITORY.git (push) > destination https://github.com/FORKER/REPOSITORY.git (fetch) > destination https://github.com/FORKER/REPOSITORY.git (push) $ git remote rm destination # Remove remote $ git remote -v # Verify it's gone > origin https://github.com/OWNER/REPOSITORY.git (fetch) > origin https://github.com/OWNER/REPOSITORY.git (push) 

  Note: git remote rm does not delete the remote repository from the server. It simply removes the remote and its references from your local repository.

  Troubleshooting: Could not remove config section ‘remote.[name]’

  This error means that the remote you tried to delete doesn’t exist:

  $ git remote rm sofake > error: Could not remove config section 'remote.sofake' 

  Check that you’ve correctly typed the remote name.

  Further reading

  git remote add

  git remote add — команда, которой устанавливается подключение к удаленному серверу и git репозиторию на нем.

  Репозиторий подключается для того чтобы стала возможна передача в него данных проекта.

  git remote add и подключение нового репозитория

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

  Сначала инициализируем локальный репозиторий выполняя в каталоге проекта git init.

  Затем устанавливаем подключение к удаленному репозиторию

  NAME — имя для удаленного репозитория может быть любым. Часто используют origin

  Адресом передаваемым git remote add после указания имени может быть:

  • имя пользователя + ip адрес + путь до репозитория
  • имя пользователя + hostname + путь до репозитория

  Например, [email protected]:/repo.git

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

  

  Через git remote -v можно посмотреть какие удаленные репозитории добавлены.

  Добавляемый репозиторий может быть публичный репозиторий на github или приватный репозиторий.

  Чтобы передача данные была возможна репозиторий должен существовать (также создается за счет git init) в момент выполнения git push

  Имя подключённого репозитория можно при желании поменять, обычно используется origin, но можно задать другое имя. Имя указывается при выполнении git push

  

  Когда подготовлена структура проекта и созданы скрипты — содержимое добавляем для коммита.

  Затем делаем коммит сопровождая его комментарием. Комментарий передаётся ключом -m

  Изменения отправляем на удаленный сервер.

  * Если имя изменено также как в примере выше, то команда будет выглядеть как git push production master

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

  git push upstream

  При частых push-ах удобно пользоваться опцией -u (upstream). С неё можно не указывать ветку, что экономит время при частых push-ах

  upstream после добавления удаленного репозитория можно создать такой командой

  git push —set-upstream production master.

  Если не указать upstream и выполнять git push REPO, а не git push REPO master , то будет ошибка:

  

  После добавления upstream можно отправлять изменения в репозиторий:

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

  Если имена веток одинаковы и коммиты всегда идут только в одноименные ветки — можно установить deafult upstream.

  git config push.default current

  Однако это затруднит отслеживание изменений.

  Для того чтобы контролировать изменения (в т.ч. локальные-удаленные) используется git diff.

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

  Похожие публикации:

  1. Browser в автозагрузке что это
  2. Как настроить маршрутизацию между двумя сетями linux
  3. Как остановить время во всем мире
  4. Как прервать работу посудомоечной машины bosch