git-instructions/README.md

Инструкция по настройке Git для GitHub на Windows

Примечание

Гайд предполагает, что имя пользователя на всех компьютерах - "student", а ваше имя - Иванов Иван.

1. Установка Git

Скачайте установщик с https://git-scm.com/download/win Установите с настройками по умолчанию.

2. Базовая настройка

Откройте Git Bash Через поиск Windows или ПКМ внутри папки. Напишите команды:

git config --global user.name "Иван Иванов"
git config --global user.email "ваша_почта@example.com"

Конфигурация сохраняется в: C:\Users\student\.gitconfig

3. Генерация RSA SSH-ключа

ВАЖНО: Если на компьютере уже есть SSH-ключи, переименуйте новый ключ, чтобы избежать конфликтов.

Выполните команду:

ssh-keygen -t rsa -b 4096 -C "ваша_почта@example.com"

Введите уникальное имя файла, например:

• При запросе: Enter file in which to save the key
• Введите: C:/Users/student/.ssh/id_rsa_ivan_ivanov

Далее:

• При запросе: Enter passphrase - введите пароль
• При запросе: Enter same passphrase again - повторите пароль

ПРИМЕЧАНИЕ: При вводе пароля символы не отображаются. Это нормально.

4. Файл SSH config

Создайте/отредактируйте файл: C:\Users\student\.ssh\config

Добавьте конфигурацию:

Host github.com
    HostName github.com
    User git
    IdentityFile ~/.ssh/id_rsa_ivan_ivanov # не забудьте изменить
    IdentitiesOnly yes

5. Добавление публичного ключа на GitHub

1. Откройте файл: C:\Users\student\.ssh\id_rsa_ivan_ivanov.pub
2. Скопируйте всё содержимое
3. На GitHub: Settings → SSH and GPG keys → New SSH key
4. Вставьте ключ, добавьте название, сохраните

6. Проверка подключения

ssh -T git@github.com

При первом подключении SSH-агент предупредит Вас о соединении с ранее неизвестным хостом. Напишите yes, чтобы доверять хосту. Затем Вас попросят ввести пароль от SSH-ключа. Введите его. Если всё хорошо, то должно получиться похожее сообщение:

Hi ivan! You've successfully authenticated, but GitHub does not provide shell access.

7. Работа с репозиториями

Клонирование:

На Github скопируйте ссылку на существующий репозиторий в формате SSH. Напишите в консоль команду в данном формате:

git clone git@github.com:username/repository.git

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

Создание нового репозитория:

Предварительно создайте репозиторий на своей странице Github. Затем на своем компьютере:

1. Создайте папку и войдите в нее. Добавьте новый файл, например файл описания README.md;
2. откройте Git Bash / Powershell / терминал VSCode для данной папки, именно для неё;
3. выполните команды:

git init
git add .
git commit -m "Initial commit"
git branch -M main
git remote add origin git@github.com:username/repository.git
git push -u origin main

все новые изменения можно отправлять на Github командой git push origin ветка.

8. Проверка существующих ключей

Чтобы проверить, какие SSH-ключи уже есть в системе:

ls -la ~/.ssh/

Файловые пути

• Приватный ключ: C:\Users\student\.ssh\id_rsa_ivan_ivanov
• Публичный ключ: C:\Users\student\.ssh\id_rsa_ivan_ivanov.pub
• Конфиг SSH: C:\Users\student\.ssh\config
• Конфиг Git: C:\Users\student\.gitconfig

Безопасность

1. Используйте уникальные имена для ключей - это предотвратит перезапись существующих;
2. никогда не передавайте приватные ключи третьим лицам;
3. пароль обеспечивает защиту при утечке файла ключа. Обязательно используйте его;
4. для смены пароля используйте команду ssh-keygen -p -f ~/.ssh/id_rsa_ivan_ivanov

Примечания

• Если ключ с таким именем уже существует, создайте новый с другим именем;
• каждый хостинг можно настроить с отдельным ключом;
• проверьте правильность пути в файле config

Советы

• Если Вы защитили ключи паролем, то Вы можете безопасно сохранить их себе в Telegram или в удаленный репозиторий. Ключи можно будет переиспользовать на других компьютерах, что очень удобно в условиях работы на домашнем и аудиторном компьютерах.
• Учитывайте, что если какие-то данные попали в удаленный репозиторий, то их становится довольно сложно оттуда убрать.