Различия

Показаны различия между двумя версиями страницы.

--- itechnology:git [2020/02/16 14:37] – [Изменение истории коммитов] jurik_phys
+++ itechnology:git [2025/06/28 17:08] (текущий) – [Работа с подпроектом (ПП)] jurik_phys
@@ Строка 4: / Строка 4: @@
 ==== Клонирование с git-сервера ====
-<code bash>
+  * через настроенный доступ **ssh**:<code bash>
-git clone user_name@serve_name:/opt/git/project
+# GitHub
+git clone git@github.com:Jurik-Phys/bchs.git
+# Any other Git server
+git clone user_name@server_name:/opt/git/project
 </code>
+  * через публичный **https** доступ:<code bash>
+git clone https://github.com/Jurik-Phys/bchs.git
+</code>
+  * через публичный **https** доступ с клонированием подпроектов:<code bash>git clone --recurse-submodules https://github.com/Jurik-Phys/bchs.git</code>
+  * проверка доступа по ssh к git-серверу, на примере GitHub:<code>
+ssh -T git@github.com</code>
+    * успех:<code>Hi Jurik-Phys! You've successfully authenticated, ... </code>
+    * ошибка:<code>git@github.com: Permission denied (publickey).</code>
 ==== Создание удалённого репозитория ====
 **Инициализация git-репозитория**
@@ Строка 119: / Строка 129: @@
 </code>
+==== Восстановить файл из коммита ====
+<code bash># восстановить файл main.cpp из коммита 965ee26
+git checkout 965ee26 -- main.cpp</code>
 ==== Отменить коммит ====
 <code bash>
@@ Строка 152: / Строка 166: @@
 </code>
+==== Именование коммитов ====
+Вариант №1 рекомендаций по именованию коммитов ([[https://habr.com/ru/post/673344/ |ссылка]]):
+<code><type> <description></code>
+| **Fix** |коммит, который устраняет баг |
+| **Feat** | коммит, который содержит новый функционал  |
+| **Chore** | коммит, который не устраняет баг и не вносит новый функционал, а модифицирует или обновляет зависимости  |
+| **Refactor** | этот коммит содержит рефакторинг, который включает рефакторинг кода или изменения  |
+| **Docs** | этот коммит изменяет документацию,  readme.md или markdown файлы |
+| **Style** | коммит, который вносит изменения в оформление кода |
+| **Test** | коммит, который изменяет тестовый файл, включая изменения  |
+| **Perf** | коммит, в котором улучшается производительность  |
+| **Ci** | коммит, в котором содержатся изменения в интеграции CI в файлах или скриптах  |
+| **Build** | это файлы, которые включают файлы сборки и зависимости  |
+| **Revert** | коммит, который сигнализирует об откате к предыдущему коммиту  |
+Вариант №2 ([[https://habr.com/ru/articles/416887/|ссылка]])
+  - Отделяйте заголовок от тела пустой строкой.
+  - Ограничивайте заголовок 50 символами.
+  - Пишите заголовок с заглавной буквы.
+  - Не ставьте точку в конце заголовка.
+  - Используйте повелительное наклонение в заголовке
+    * Это не повелительное наклонение, а опущенное подлежащее во множественном числе. <del>This changes</del> fix accidental crush — <del>Эти изменения</del> чинят внезапные падения. \\ <wrap>
+If applied, this commit will **Refactor subsystem X for readability** \\
+If applied, this commit will **Update getting started documentation** \\
+If applied, this commit will **Remove deprecated methods** \\
+If applied, this commit will **Release version 1.0.0**</wrap>
+  - Переходите на следующую строку в теле на 72 символах.
+  - В теле отвечайте на вопросы «что» и «почему», а не «как»
 ===== Ветки =====
 ==== Создание локальной ветки ====
-<code bash>
+  * <code bash>
 git branch new_branch   # создание новой ветки от последнего коммита
 git checkout new_branch  # переключение на новую ветку
 </code>
-==== Объединение веток ====
+==== Слияние веток ====
-<code bash>
+  *<code bash>
 # переход на ветку в которую будут сливаться изменения
-git сheckout master
+git checkout main
 # вливание devel_branch в текущую (master) ветку
 git merge devel_branch
 </code>
-==== Просмотр всех веток, включая удалённые ====
+==== Список всех веток ====
-<code bash>
+  * <code bash>
 git branch -a
 </code>
 ==== Удаление ветки ====
-<code bash>
-# удаление удалённой ветки
+  * Локальный репозиторий:<code bash>git branch -d local_branch</code>
-git push server :remote_branch
+  * Удалённый репозиторий:<code bash>git push server :remote_branch </code>
-# удаление локальной ветки
-git branch -d local_branch
+==== Переименование ветки ====
-</code>
+  * Локальный репозиторий:
+    * Текущая ветка (-m сокращение от --move):<code bash>git branch -m <newname></code>
+    * Произвольная ветка: <code bash>git branch -m <oldname> <newname></code>
+  * Удалённый репозиторий:
+    * Отправка новой ветки на сервер: <code bash>git push origin -u <newname></code>
+    * Удаление старой ветки на сервере:<code bash>git push origin --delete <oldname></code>
 ==== Вытянуть удалённую ветку ====
@@ Строка 196: / Строка 248: @@
 git push remote_server local_branch_name:remote_branch_name
 </code>
+===== Рабочие деревья (Worktree) =====
+  * Добавить рабочую ветку<code bash>git worktree add ../folder name-of-branch</code>
+  * Посмотреть список рабочих деревьев<code bash>git worktree list</code>
+  * Очистить информацию о несуществующих (ранее удалённых) каталогах<code bash>git worktree prune</code>
 ===== Работа с подпроектом (ПП) =====
 ==== Добавление ПП в проект ====
@@ Строка 319: / Строка 376: @@
 ===== Метки =====
 ==== Создание меток ====
-<code bash>
+  * Аннотированные метки (рекомендуется)<code bash>git tag -a vX.Y -m "Project version X.Y"</code>
-git tag tag_name
+  * Легковесные метки<code bash>git tag vX.Y</code>
-</code>
 ==== Просмотр меток ====
-<code bash>
+  * Общий список:<code bash>git tag</code>
-git tag
+  * Подробности по тегу "tag_name":<code bash>git show --no-patch tag_name</code>
-</code>
 ==== Отправка меток на сервер  ====
-<code bash>
+  * По умолчанию, команда git push не отправляет теги на удалённые сервера. После создания теги нужно отправлять явно на удалённый сервер<code bash>git push origin --tags</code>
-git push origin --tags
-</code>
 ===== Разрешение конфликтов =====
 ==== Настройка инструментов ====
-<code bash>
+<WRAP indent><WRAP indent><code bash># установка vimdiff в качестве инструмента разрешения конфликтов
-# установка vimdiff в качестве инструмента разрешения конфликтов
 git config --global merge.tool vimdiff
 # не создавать *.orig файлов
 git config --globasl mergetool.keepBackup false
 </code>
+</WRAP></WRAP>
 ==== Появление конфликта слияния ====
+<WRAP indent><WRAP indent>
 <code bash>
 # установка текущей ветки (master)
@@ Строка 353: / Строка 407: @@
 git config --globasl mergetool.keepBackup false
 </code>
+</WRAP></WRAP>
 ** Можно посмотреть детали конфликта: **
+<WRAP indent><WRAP indent>
 <code bash>
 git status
@@ Строка 366: / Строка 422: @@
 #
 </code>
+</WRAP></WRAP>
 ==== Запуск процесса разрешения конфликтов ====
+<WRAP indent><WRAP indent>
 <code bash>
 git mergetool
 </code>
+</WRAP></WRAP>
 ==== Описание vimdiff ====
@@ Строка 597: / Строка 657: @@
 P.S. также в настройках сайта апача необходимо AllowOverride None заменить на AllowOverride All
 ===== Разное =====
 ==== Настройка git ====
 === Идентификация пользователя ===
@@ Строка 640: / Строка 703: @@
 </code>
-{{tag>git}}
+===== Частые сценарии =====
+<hidden -noprint onHidden="![  ▸ ]! Создание локальной ветки" onVisible="![  ▾ ]! Создание локальной ветки">
+  * Вариант №1
+    * Создание ветки <code bash>git branch BR-NAME</code>
+    * Верификация созданной ветки <code bash>git branch
+...
+BR-NAME
+...</code>
+    * Переключение на созданную ветку «BR-NAME» <code bash>git checkout BR-NAME</code>
+  * Вариант №2
+    * Создание и переключение на ветку «BR-NAME» одной командой <code bash>git checkout -b BR-NAME</code>
+</hidden>
+<hidden -noprint onHidden="![  ▸ ]! Создание удалённой ветки" onVisible="![  ▾ ]! Создание удалённой ветки">
+  * Создание и переключение на ветку «BR-NAME» <code bash>git checkout -b BR-NAME</code>
+  * Внесение изменений в файлы проекта и создание коммита <code bash>git commit -a</code>
+  * Отправка ветки на сервер и установка связи между локальной и удалённой веткой<code bash>git push -u origin BR-NAME</code>
+</hidden>
+<hidden -noprint onHidden="![  ▸ ]! Подключение подпроекта через submodule" onVisible="![  ▾ ]! Подключение подпроекта через submodule">
+  * Добавление MicroTeX как подпроекта в каталог ''lab_os/verify/ext/MicroTeX'' <code bash>git submodule add https://github.com/NanoMichael/MicroTeX.git lab_os/verify/ext/MicroTeX</code>
+  * При клонировании репозитория с подпроектами их необходимо инициализировать<code bash>git submodule update --init --recursive</code>
+  * Переключение на требуемую (openmath) ветку в подпроекте<code bash>cd lab_os/verify/ext/MicroTeX</code><code bash>git checkout openmath</code>
+  * Вернуться в основной репозиторий и зафиксировать изменения<code bash>cd ../../../..</code><code bash>git commit -a</code><code bash>git push</code>
+</hidden>
+<hidden -noprint onHidden="![  ▸ ]! Отключение подпроекта" onVisible="![  ▾ ]! Отключение подпроекта">
+  * Деинициализация submodule<code bash>git submodule deinit lab_os/verify/ext/MicroTeX</code>
+  * Удаление при необходимости файлов подпроекта из индекса Git<code bash>git rm --cached lab_os/verify/ext/MicroTeX</code>
+  * Удаление каталога подпроекта<code bash>rm -r lab_os/verify/ext/MicroTeX</code>
+  * Открыть файл .gitsubmodules и удалить блок с данными подмодуля<code bash>[submodule "lab_os/verify/ext/MicroTeX"]
+    path = lab_os/verify/ext/MicroTeX
+    url = https://github.com/NanoMichael/MicroTeX.git</code>
+</hidden>
+<hidden -noprint onHidden="![  ▸ ]! Переключение текущей ветки" onVisible="![  ▾ ]! Переключение текущей ветки">
+  * Список веток:<code bash>git branch</code>
+  * Переключение текущей ветки:<code bash>git checkout BRANCH_NAME</code>
+</hidden>
+<hidden -noprint onHidden="![  ▸ ]! Влить отдельный коммит в текущую ветку" onVisible="![  ▾ ]! Влить отдельный коммит в текущую ветку">
+  * Может понадобиться, для включения отделённого коммита.<code>git cherry-pick commit_sha~1</code>
+</hidden>
+<hidden -noprint onHidden="![  ▸ ]! Переход к предыдущему коммиту" onVisible="![  ▾ ]! Переход к предыдущему коммиту">
+  * Когда необходимо вернуться к предыдущей версии кода:<code>git checkout commit_sha~1</code>
+  * При необходимости сохранения изменений можно:
+      - Cоздать ветку:<code bash>git branch new_branch</code>
+      - Переключиться на созданную ветку:<code bash>git checkout branch new_branch</code>
+</hidden>
+<hidden -noprint onHidden="![  ▸ ]! Откатить изменения к последнему коммиту" onVisible="![  ▾ ]! Откатить изменения к последнему коммиту">
+  * Когда стало ясно, что сделанные изменения в коде ошибочны<code>git reset --hard HEAD</code>
+</hidden>
+===== Работа с GitHub ======
+==== Первый запуск ====
+=== Генерация ключей SSH ===
+Для работы с сервисом GitHub через терминал по протоколу SSH необходимо один раз сгенерировать ключи шифрования и публичный добавить в аккаунт в раздел "Settings->SSH and GPG keys".
+Процесс генерации ключей описан по [[ https://docs.github.com/en/authentication/connecting-to-github-with-ssh/generating-a-new-ssh-key-and-adding-it-to-the-ssh-agent |ссылке]].
+**Проверка соединения с github через ssh**<code>ssh -T git@github.com</code> В первый раз необходимо одобрить подключение в ответ на запрос вида<code>
+The authenticity of host 'github.com (IP ADDRESS)' can't be established.
+RSA key fingerprint is SHA256:nThbg6kXUpJWGl7E1IGOCspRomTxdCBCLviKw6E5SY8.
+Are you sure you want to continue connecting (yes/no)?</code>
+=== Коммит от имени аккаунта GitHub ===
+GitHub использует email адрес для ассоциации отправленных коммитов с аккаунтом GitHub.
+Чтобы связать коммиты с аккаунтом GitHub:
+  * [[https://github.com/settings/emails|убедитесь]], что какой-нибудь email привязан к аккаунту GitHub, в настройках аккаунта;
+  * установите тот же самый email в настройках Git или репозитория:<code bash>git config --global user.email "ваш-github-email@example.com"</code>
+  * создайте какие-нибудь коммиты (git commit -a) и отправьте их (git push) в GitHub.
+После этого GitHub признает Вас, и все новые коммиты будут подписаны вашим аккаунтом со ссылкой на него, а не просто именем. Подробности по [[https://ru.stackoverflow.com/a/849771|ссылке]].
+==== Типичные задачи ====
+**Создание пустого репозитория:**
+  * создать новый репозиторий на странице <<[[https://github.com/new|Create a new repository]]>>
+  * клонировать созданный репозиторий на локальной машине:<code bash>git clone git@github.com/USERNAME/REPOSITORY.git</code>В текущем каталоге появится подкаталог REPOSITORY - это и есть каталог нового проекта.
+**Создание GitHub репозитория под существующий локальный проект:**
+  * создать новый репозиторий на странице <<[[https://github.com/new|Create a new repository]]>>
+  * войти в каталог с проектом и подключить удалённый репозиторий командой <code bash>git remote add origin git@github.com:USERNAME/REPOSITORY.git</code>
+  * просмотреть список удалённых репозиториев:<code bash>git remote</code>
+  * а) отправить все ветки на удалённый репозиторий:<code bash>git push origin --all</code>
+  * б) отправить только локальную ветку main:<code bash>git push -u origin main</code>
+**Переименовать или удалить репозиторий** можно на странице:
+  * <code>https://github.com/USERNAME/REPOSITORY/settings</code>
+**Добавление уже созданного на github'е репозитория**
+  * <code>git remote add origin git@github.com:USERNAME/REPOSITORY.git</code>
+**Клонирование (стороннего) репозитория**
+  * <code>git clone git@github.com:USERNAME/REPOSITORY.git</code>
 ===== Дополнительные материалы git =====
   - [[http://ru.wikipedia.org/wiki/Git| Статья в википедии]]
@@ Строка 646: / Строка 819: @@
   - [[http://www-cs-students.stanford.edu/~blynn/gitmagic/intl/ru/ch01.html|Волшебство Git]]
+{{tag>git}}

Jurik-Phys.Net

Инструменты пользователя

Инструменты сайта

Различия

Инструменты страницы