Создание репозитория на GitHub для проекта на FastAPI

Начинаем работу с системой контроля версий

---

Зачем нужен GitHub

GitHub — это платформа для хранения и совместной разработки проектов с использованием системы контроля версий Git. В этом цикле статей GitHub нам понадобится для:

• Хранения кода — все файлы проекта будут в безопасности в облаке
• Отслеживания изменений — вы всегда сможете вернуться к любой версии проекта
• Деплоя на Beget — будем забирать код с GitHub на сервер
• Демонстрации кода — читатели смогут посмотреть код в репозитории

---

Шаг 1. Регистрация на GitHub

1. Перейдите на сайт github.com
2. Нажмите кнопку Sign up
3. Введите:
   • Email — ваш действующий email
   • Password — надёжный пароль (не забудьте его!)
   • Username — ваше уникальное имя пользователя
4. Подтвердите email (придёт письмо)

---

Шаг 2. Создание организации (Organization)

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

• Хранить все проекты в одном месте
• Иметь понятное имя в URL: github.com/ваша-организация/репозиторий
• В будущем добавлять других разработчиков в проект

Как создать организацию:

1. Нажмите на свой аватар в правом верхнем углу
2. Выберите Your organizations
3. Нажмите New organization
4. Выберите бесплатный тариф Free
5. Введите:
   • Organization name — уникальное имя (например, my-fastapi-projects)
   • Contact email — ваш email
6. Нажмите Create organization

---

Шаг 3. Создание репозитория

Теперь создадим сам репозиторий pytexpert.ru:

1. На странице организации нажмите New repository
2. Введите:
   • Repository name — pytexpert.ru
   • Description — «Проект лендинга на FastAPI для цикла статей» (опционально)
3. Выберите:
   • Public — если хотите, чтобы код видели все (рекомендуем для учебного проекта)
   • Private — если хотите скрыть код
4. Не добавляйте README, .gitignore и лицензию — мы создадим их позже сами
5. Нажмите Create repository

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

---

Шаг 4. Настройка SSH-ключа

SSH-ключ позволяет подключаться к GitHub без ввода логина и пароля при каждом push. Это удобно и безопасно.

Для Windows:

1. Откройте командную строку (Win+R → cmd)
2. Выполните команду:

   ssh-keygen -t ed25519 -C "ваш-email@example.com"

3. На все вопросы просто нажимайте Enter (сохраняем в стандартную папку)
4. Ключи созданы в папке C:\Users\ваше_имя\.ssh\
5. Выполните команду для копирования публичного ключа:

   type C:\Users\ваше_имя\.ssh\id_ed25519.pub

6. Скопируйте вывод в буфер обмена

Для Linux / Mac:

1. Откройте терминал
2. Выполните команду:

   ssh-keygen -t ed25519 -C "ваш-email@example.com"

3. На все вопросы нажимайте Enter
4. Выполните команду для копирования публичного ключа:

   cat ~/.ssh/id_ed25519.pub

5. Скопируйте вывод в буфер обмена

Добавление SSH-ключа в GitHub:

1. Нажмите на свой аватар → Settings
2. В левом меню выберите SSH and GPG keys
3. Нажмите New SSH key
4. В поле Title введите, например: Мой компьютер Windows
5. В поле Key вставьте скопированный публичный ключ
6. Нажмите Add SSH key

---

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

Проверьте, что SSH работает правильно:

ssh -T git@github.com

Должно появиться приветствие:

Hi ваше-имя! You've successfully authenticated, but GitHub does not provide shell access.

Если появилась эта надпись — всё работает.

---

Итог

Сегодня мы сделали:

• ✅ Зарегистрировались на GitHub
• ✅ Создали организацию с уникальным именем
• ✅ Создали репозиторий pytexpert.ru
• ✅ Настроили SSH-ключ для безопасного подключения
• ✅ Проверили, что всё работает

Теперь у нас есть место для хранения кода. В следующей статье мы создадим структуру проекта и наполним его кодом.