Гайд: Git в Astra Linux: полное руководство по установке, настройке и безопасной работе

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

Astra Linux использует пакетный менеджер apt. Git доступен в официальных репозиториях дистрибутива.

# Обновление кэша пакетов
sudo apt update

# Установка ядра Git
sudo apt install git

# Опциональные инструменты (рекомендуется)
sudo apt install git-doc git-gui gitk meld

Проверка:

git --version
# Пример вывода: git version 2.43.0

Примечание по репозиториям:

В Astra Linux Special Edition могут использоваться только сертифицированные/одобренные репозитории.

Если git отсутствует в кэше, проверьте статус подключения репозиториев:

apt-cache policy git

При необходимости подключите разрешённый внешний репозиторий или используйте локальный mirror в соответствии с регламентом вашей организации.

---

2. Первичная настройка

# Глобальная идентификация
git config --global user.name "Денис Сергеевич"
git config --global user.email "your@email.ru"

# Имя основной ветки по умолчанию
git config --global init.defaultBranch main

# Редактор для коммитов (nano, vim, или любой GUI)
git config --global core.editor nano

# Проверка конфигурации
git config --list --global

Безопасность в Astra Linux SE:

Если в системе активирован мандатный контроль доступа (Parsec), запись в ~/.gitconfig может блокироваться при неправильных метках конфиденциальности/целостности.

В этом случае:

• Используйте --local вместо --global (настройки хранятся в .git/config конкретного репозитория).
• Либо согласуйте с администратором ИБ создание файла в разрешённой категории целостности.

---

3. Базовый рабочий процесс

Действие	Команда
Создать репозиторий	mkdir project && cd project && git init
Клонировать	git clone <url>
Статус изменений	git status
Добавить файлы в индекс	git add <файл> или git add .
Зафиксировать	git commit -m "Описание изменений"
Просмотр истории	git log --oneline --graph --decorate --all
Отменить изменения в файле	git restore <файл>
Убрать из индекса	git restore --staged <файл>

Подсказка:

git switch и git restore (с Git 2.23) заменили неоднозначные варианты git checkout. Используйте их для большей безопасности.

---

4. Ветвление и слияние

# Создать ветку
git branch feature-login

# Переключиться
git switch feature-login

# Создать и сразу переключиться
git switch -c feature-login

# Слияние в main
git switch main
git merge feature-login

# Разрешение конфликтов
# 1. Открыть конфликтные файлы, найти маркеры <<<< >>>> ====
# 2. Исправить код
# 3. git add <файлы>
# 4. git commit

# Удалить ветку после слияния
git branch -d feature-login

---

5. Удалённые репозитории и сетевые особенности

# Привязка к удалённому серверу
git remote add origin <url>

# Отправка ветки
git push -u origin main

# Получение обновлений
git pull  # = fetch + merge
git fetch && git switch main && git merge origin/main  # безопасный вариант

Настройка SSH-доступа:

ssh-keygen -t ed25519 -C "your@email.ru"
cat ~/.ssh/id_ed25519.pub  # скопировать в GitHub/GitLab/корпоративный сервер
chmod 600 ~/.ssh/id_ed25519
ssh-add ~/.ssh/id_ed25519

Особенности изолированных контуров Astra Linux:

• В закрытых сетях часто используются корпоративные GitLab, Gitea или Forgejo.
• Проверка сертификатов: git config --global http.sslVerify true. При использовании внутренних CA добавьте корневой сертификат в систему (/usr/local/share/ca-certificates/ + update-ca-certificates).

---

6. Продвинутые команды

Задача	Команда
Временно отложить изменения	git stash / git stash pop
Интерактивное редактирование истории	git rebase -i HEAD~3
Взять отдельный коммит из другой ветки	git cherry-pick <hash>
Теги релизов	git tag -a v1.0 -m "Релиз" && git push --tags
Поиск коммита, введшего баг	git bisect start → good/bad
Восстановление удалённых коммитов	git reflog → git reset --hard <hash>
Работа с большими файлами	sudo apt install git-lfs && git lfs install

---

7. Специфика Astra Linux (безопасность и эксплуатация)

1. Parsec (MAC): Не блокирует Git по умолчанию, но может ограничивать чтение/запись в директориях с определёнными метками целостности. Создавайте репозитории в пользовательских или разрешённых каталогах (~/projects, /opt/dev).

2. Аудит: Все вызовы git можно логировать через auditd:

   auditctl -w /usr/bin/git -p x -k git_usage

3. Сертификация: Git не является СКЗИ, но разрешён для контроля версий исходного кода в контурах до уровня «Особой важности» при соблюдении организационных мер.
4. Документация: Официальные материалы по разработке в Astra Linux доступны на wiki.astralinux.ru и в пакете astra-doc. Раздел «Инструменты разработки» содержит примеры настройки Git в изолированных средах.

---

8. Типовые ошибки и решения

Ошибка	Причина	Решение
fatal: not a git repository	Забыли git init или не в той директории	cd /правильный/путь && git init
Permission denied (publickey)	Ключ не добавлен или права неверны	chmod 600 ~/.ssh/id_*, ssh-add, проверить доступ на сервере
error: failed to push some refs	Локальная ветка отстала от удалённой	git pull --rebase, затем git push
Блокировка записи в .gitconfig	Parsec / политики ИБ	Использовать --local или обратиться к администратору ИБ
Медленный clone в закрытой сети	Большой MTU или прокси	git clone --depth 1 <url>, проверить ping -M do -s 1472 <host>

---

9. Рекомендуемый workflow

Для командной разработки в Astra Linux обычно выбирают:

• GitLab Flow или Trunk-Based Development (оптимально для CI/CD в контуре)
• Conventional Commits (feat:, fix:, chore:, docs:)
• Pre-commit хуки: git config core.hooksPath .githooks
• Интеграция с корпоративным CI/CD (GitLab CI, Jenkins, или внутренние сборочные системы Astra)

Пример .gitconfig для стандартизации:

[core]
    editor = nano
    autocrlf = input
[commit]
    template = ~/.gitmessage.txt
[alias]
    lg = log --oneline --graph --decorate --all
    st = status -sb
    co = checkout
    br = branch
    unstage = reset HEAD --