Подробный гайд: Перенос проекта с Linux Mint на Astra Linux

Пошаговая инструкция по переносу проектов с Linux Mint на Astra Linux. Разбор зависимостей, настроек безопасности, systemd-юнитов и типичных ошибок миграции.

Подробный гайд: Перенос проекта с Linux Mint на Astra Linux

Введение: Что важно знать заранее

Обе системы основаны на Debian, поэтому базовые утилиты (apt, dpkg, systemd, bash) работают схоже.

Однако Astra Linux имеет ряд архитектурных отличий:

Аспект	Linux Mint	Astra Linux
Репозитории	Ubuntu + PPA	Официальные репозитории без PPA
Пакетные форматы	`.deb`, `snap`, `flatpak`	Только `.deb`, `AppImage` (ограниченно), `snap`/`flatpak` не поддерживаются
Безопасность	Стандартный Linux DAC	В версии SE: мандатный контроль (Parsec/SMACK), контроль целостности, аудит
Ядро	Ubuntu HWE	Кастомное ядро с патчами безопасности, иногда старее, но стабильнее
Лицензирование	Свободное	Требует регистрации, для госсектора – сертификация ФСТЭК

Шаг 1: Аудит и подготовка проекта

Перед миграцией зафиксируйте текущее состояние:

# Системные пакеты
dpkg -l > mint_system_packages.txt

# Python/Node/Java зависимости
pip freeze > requirements.txt
npm list --depth=0 > package.json.lock
mvn dependency:tree > java_deps.txt

# Сервисы и таймеры
systemctl list-units --type=service --state=running > running_services.txt
crontab -l > cron_jobs.txt

Составьте таблицу зависимостей: название пакета → версия → назначение → альтернатива в Astra.

Шаг 2: Резервное копирование

# Код
git clone --mirror /path/to/project project_backup.git

# Базы данных
pg_dump -U user dbname > db_backup.sql
mysqldump -u user -p dbname > db_backup.sql

# Конфиги и данные
tar czvf project_config_data.tar.gz /etc/yourapp /var/lib/yourapp /opt/yourapp

Храните бэкапы на внешнем носителе или в изолированном хранилище.

Шаг 3: Подготовка целевой системы (Astra Linux)

3.1. Подключение репозиториев

Официальные репозитории требуют регистрации.

После получения ключей:

sudo apt update
sudo apt install astra-repo
sudo astra-repo add main
sudo apt update && sudo apt upgrade -y

3.2. Базовый набор инструментов

sudo apt install -y build-essential git curl wget unzip \
  software-properties-common apt-transport-https ca-certificates \
  lsb-release gnupg

3.3. Локаль и системные параметры

sudo dpkg-reconfigure locales  # Выберите ru_RU.UTF-8
sudo timedatectl set-timezone Europe/Moscow
sudo systemctl enable --now chrony  # или ntp

Шаг 4: Перенос зависимостей

4.1. Системные пакеты

Ищите аналоги в репозиториях Astra:

apt-cache search <package_name>
apt show <package_name>

Если пакета нет:

1. Попробуйте собрать из исходников:

   ./configure --prefix=/usr/local
   make -j$(nproc)
   sudo checkinstall --pkgname=custom-pkg --pkgversion=1.0 make install

Либо используйте dpkg-deb -b для упаковки в .deb.

4.2. Языковые среды

Среда	Рекомендация для Astra
Python	`apt install python3 python3-venv python3-pip` + `venv`
Node.js	`apt install nodejs npm` или `nvm` (в home-директории)
Java	`apt install openjdk-11-jdk` или `sdkman`
Go/Rust	Официальные бинарники из `golang.org` / `rustup.rs`

Не используйте snap/flatpak – они не интегрированы с политиками безопасности Astra.

4.3. Базы данных

Устанавливайте из репозиториев Astra или собирайте официально поддерживаемые версии:

sudo apt install postgresql postgresql-contrib
sudo systemctl enable --now postgresql

Миграция данных:

psql -U postgres -f db_backup.sql

Шаг 5: Адаптация кода и конфигураций

5.1. Пути и права

Проверьте жёстко заданные пути (/usr/lib, /etc/ssl, /var/log).

- В Astra SE каталоги могут иметь метки безопасности. Проверьте:

  ls -lZ /path/to/dir  # для SMACK/Parsec

5.2. Systemd-юниты

Пример корректировки `/etc/systemd/system/yourapp.service`:

[Unit]
Description=Your Application
After=network.target postgresql.service

[Service]
Type=simple
User=yourapp
Group=yourapp
ExecStart=/opt/yourapp/bin/start.sh
Restart=on-failure
EnvironmentFile=/etc/yourapp/env

[Install]
WantedBy=multi-user.target

Примените:

sudo systemctl daemon-reload && sudo systemctl enable --now yourapp

5.3. Специфика Astra SE (если применяется)

Назначьте метки безопасности: chsmack -a "app_label" /opt/yourapp/*
Проверьте политики: pdpl -l или parseclabel
Отключите noexec/nodev только если это критично для сборки, но верните для production.

Шаг 6: Сборка и тестирование

Соберите проект в чистой среде Astra.
Запустите тесты: pytest, npm test, mvn test и т.д.

3. Проверьте зависимости бинарников:

   ldd /opt/yourapp/bin/executable
   objdump -T /opt/yourapp/lib/libcustom.so | grep GLIBC

4. Логи ошибок:

journalctl -u yourapp -f, dmesg -T, strace -f ./yourapp

Шаг 7: Развёртывание и безопасность

7.1. Пользователи и группы

sudo groupadd -r yourapp
sudo useradd -r -g yourapp -d /opt/yourapp -s /usr/sbin/nologin yourapp
sudo chown -R yourapp:yourapp /opt/yourapp /var/log/yourapp

7.2. Фаервол и аудит

sudo apt install ufw
sudo ufw allow 80,443/tcp
sudo ufw enable
sudo apt install auditd
sudo systemctl enable --now auditd

7.3. Резервное копирование и мониторинг

Настройте cron или systemd.timer для бэкапов.
Подключите prometheus-node-exporter или zabbix-agent при необходимости.

Шаг 8: Пост-миграция

[ ] Задокументировать все изменения зависимостей и конфигов.
[ ] Обновить CI/CD: указать Astra в runner'ах, заменить apt источники.
[ ] Настроить автоматическое обновление безопасности: unattended-upgrades.
[ ] Провести нагрузочные тесты и проверить отказоустойчивость.
[ ] Если проект для госсектора – пройти процедуру сертификации (ФСТЭК).

Типичные проблемы и решения

Симптом	Причина	Решение
`E: Package 'xyz' has no installation candidate`	Пакет отсутствует в репозиториях Astra	Собрать из исходников или найти аналог
`error while loading shared libraries: libfoo.so.1`	Отсутствует зависимость или версия не совпадает	`ldd`, `apt-file search libfoo.so.1`, установка `libfoo-dev`
`Permission denied` при запуске сервиса	Права или метки безопасности	Проверить `ls -lZ`, `chown`, `chsmack`, политики `pdpl`
`snap/flatpak` не устанавливаются	Не поддерживаются в Astra	Перейти на `.deb` или AppImage с ручным монтированием `FUSE`
Различия в `glibc`/`openssl`	Версия в Astra стабильнее, но старше	Собрать зависимые библиотеки статически или в `venv`/`container`

Чек-лист миграции

[ ] Аудит зависимостей и сервисов
[ ] Полный бэкап кода, БД, конфигов
[ ] Установка Astra Linux + репозитории
[ ] Замена отсутствующих пакетов
[ ] Адаптация systemd/конфигов
[ ] Настройка пользователей и прав
[ ] Сборка и прогон тестов
[ ] Проверка логов и производительности
[ ] Настройка фаервола, аудита, бэкапов
[ ] Документирование и передача в эксплуатацию