bitrix-admin-devopslisted
Install: claude install-skill vgtitov/bitrix-ai-toolkit
# Администрирование и DevOps под 1С-Битрикс
## Окружение разработки
- **bitrixdock** (github.com/bitrixdock/bitrixdock, 620★, живой) — народный Docker-стек (nginx/apache + php-fpm + mysql + workspace).
Локалка для разработки. На Apple Silicon — amd64-образы через эмуляцию (медленнее); для чистой разработки кода полный сайт не обязателен.
- **BitrixVM** — штатная виртуалка вендора для стейджа/прода, преднастроена под требования платформы.
- **Официальные PHP-образы для CI:** `quay.io/bitrix24/php:8.3-fpm-alpine`.
## Раскладка проекта (современная)
`/local` версионируется (компоненты, модули, шаблоны, php_interface, PSR-4 классы), ядро `/bitrix` и `upload/` — в `.gitignore`.
composer.json/vendor — вне DOCUMENT_ROOT (иначе ломается выгрузка «1С→Битрикс»). Свои классы — PSR-4 `\Local\`.
## Деплой /local
- **GitLab CI + rsync** — массовый паттерн: `build (composer install + npm build) → test (phpcs/phpstan) → deploy (rsync -a --delete по SSH + sprint.migration)`.
- **Deployer** — атомарные релизы/симлинки (зрелые команды).
- Обязательный шаг после выкладки — `php sprint.php migrate` (применение миграций структуры).
- Быстрый rollback — через артефакты/симлинки релизов.
## Миграции (sprint.migration)
Структуру инфоблоков/HL/свойств/прав менять ТОЛЬКО миграциями: `php migrate.php add <name>` → правка → `php migrate.php up`.
Не руками в БД/админке без версионирования. Живой пакет (207★); НЕ использовать мёртвый arrilot.
## CI/CD (эталон)
Референс: `ilimurzin/bitrix-project-exa