guidesStorage/Git/first_usage_remote_repo.md

Специально для linuxoid@mastodon.ml
Ну смотри, как я делаю обычно, правда возможно это не правильно, но ладно. Опуская подробности регистрации аккаунта и прочее не особо важное.

Создание и обмен публичными ключами для авторизации

1. Создаем ключ ssh, он нам будет нужен для git push (вкидывать изменения)

$ ssh-keygen
Generating public/private rsa key pair.
Enter file in which to save the key (/home/user/.ssh/id_rsa): 

Для большей приватности можешь генерировать на каждый Gitea разный ключ, как минимум указав путь ~/.ssh/example_gitea , но, если не париться, то можно просто нажать enter на этом этапе. Далее попросит создать пароль для ключа, это рекомендовано, но не является обязательным.

2. Указываем какой ключ юзать при подключении к выбранному хосту. (Опционально, требуется при раздельных ключах)

$ nano ~/.ssh/config

Заполнить его подобным содержимым:

Host gitea.phreedom.club # Здесь указываете хост, на котором Gitea
	IdentityFile ~/.ssh/example_gitea # Путь до ключ-файла

*nano указан как пример, можно любым редактором

3. Отправляем свой публичный ключ в Gitea

• Зайдите на аккаунт
• Иконка профиля > Настройки > SSH / GPG ключи > Управление SSH ключами > Добавить ключ
• Публичный ключ лежит рядом с приватным, он имеет расширение .pub, открыть его редактором и скопировать содержимое
• Внести содержимое скопированное из предыдущего пункта. Имя опционально может быть любым.

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

Создание пустого репозитория и выгрузка в remote

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

$ mkdir myfirstrepo
$ cd myfirstrepo
$ git init

2. Теперь в веб интерфейсе Gitea нужно проделать следующее:

• Нажмите на кнопку "+" > Новый репозиторий > Дайте название репозиторию > Выберете видимость > Заполнить описание если нужно > Создать репозиторий
• Далее нажмите кнопку SSH, у вас будет инструкция как создать новый репозиторий из командной строки. Делать git init не обязательно, если репозиторий уже был инициализирован. Обычно инструкция выглядит так:

touch README.md
git init
git add README.md
git commit -m "first commit"
git remote add origin git@gitea.phreedom.club:your_remote_nick/example_repo_name.git
git push -u origin master

Но, она не учитывает, что нужно представиться git. Сделать это можно несколькими способами.

3. Представляемся git
   Глобально (будет использоваться во всех репозиториях):

git config --global user.email user_mail@example.org
git config --global user.name your_remote_nick

Локально (работает только на репозитории в котором вы находитесь). Тоже самое, но убрать опцию --global Так же можно вручную поправить конфигурационный файл находящийся по пути .git/config вашего репозитория, добавить туда секцию [user]:

[user]
	name = your_remote_nick
	email = user_mail@example.org

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

$ git add . # Добавит все измененные файлы внутри репозитория в индекс
$ git commit -m 'updated files' # Сделает коммит с сообщением после опции -m
$ git push # Выгружает изменения в удаленный репозиторий

На заметку: можно посмотреть что изменилось перед добавлением в индекс командой git add -p

5. Получение изменений от удалённого репозитория
   На тот случай, если к удаленному репозиторию имеют доступ несколько коммитеров или вы меняли через веб интерфейс, просто выполните команду git pull, чтобы обновить свой локальный репозиторий. (P.S. Так же можно использовать для клонированных репозиториев)