Настройка Git на новом сервере (Ubuntu/Debian)¶

Этот документ описывает пошаговый процесс установки и настройки Git на чистом сервере для развертывания проекта Архыз.CLUB.

1. Обновление системы¶

Перед установкой пакетов рекомендуется обновить списки пакетов и саму систему:

sudo apt update
sudo apt upgrade -y

2. Установка Git¶

Установите Git из стандартных репозиториев:

sudo apt install git -y

Проверьте установленную версию:

git --version

3. Настройка пользователя Git¶

Настройте имя пользователя и email, которые будут использоваться в коммитах (если планируется коммитить с сервера) или для идентификации:

git config --global user.name "Arkhyz Server"
git config --global user.email "server@arkhyz.club"

Примечание: Если вы используете сервер только для деплоя (pull), эти настройки менее критичны, но рекомендуются.

4. Генерация SSH-ключа¶

Для доступа к приватному репозиторию GitHub рекомендуется использовать SSH-ключи. Мы будем использовать алгоритм Ed25519.

Сгенерируйте ключ (нажимайте Enter для всех вопросов, если не хотите устанавливать пароль на ключ):
```
ssh-keygen -t ed25519 -C "server@arkhyz.club"
```
Запустите ssh-agent в фоне:
```
eval "$(ssh-agent -s)"
```
Добавьте ваш SSH-ключ в ssh-agent:
```
ssh-add ~/.ssh/id_ed25519
```

5. Добавление ключа в GitHub¶

Выведите публичный ключ в консоль:
```
cat ~/.ssh/id_ed25519.pub
```
Скопируйте вывод команды (строка, начинающаяся с ssh-ed25519).
Перейдите в настройки репозитория или профиля на GitHub:
- Для репозитория (Deploy Keys): Settings -> Deploy keys -> Add deploy key. (Рекомендуется для продакшена).
- Для аккаунта: Settings -> SSH and GPG keys -> New SSH key.
Вставьте скопированный ключ и сохраните.

6. Клонирование репозитория¶

Выберите директорию для проекта. Обычно используется /var/www или домашняя директория пользователя.

# Создаем директорию проекта (опционально)
mkdir -p ~/projects
cd ~/projects

# Клонируем репозиторий через SSH
git clone git@github.com:andis777/arkhyz-admin-main.git

7. Проверка настройки¶

Перейдите в папку проекта и проверьте статус:

cd arkhyz-admin-main
git status

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

8. Полезные команды¶

Получение обновлений:
```
git pull origin main
```
Переключение веток:
```
git checkout <branch_name>
```
Просмотр логов:
```
git log --oneline -n 10
```

9. Следующие шаги¶

После успешного клонирования репозитория вам, вероятно, потребуется:

Создать файл .env на основе примера (обычно .env.example).
Настроить переменные окружения (база данных, API ключи и т.д.).
Запустить проект через Docker Compose:
```
docker-compose up -d --build
```