SuperAPI AI 工具集

typo3-site-conformance

部署与运维

查看项目

更新于 10-16 01:35

技能介绍

用途:针对可部署的 TYPO3 站点发行版(composer.json 中 type 为 project,且根目录有 Compose 文件)进行合规评分与加固,是面向站点/项目的版本,扩展仓库应改用 typo3-conformance。

主要能力:内置规则目录与可执行检查器,无需外部检出即可运行。规则见 checker/rules.json(机器可读,由 checker/gen_rules.py 生成);检查器为 checker/check.py,用法:python3 checker/check.py <repo-path>,仅依赖 pyyaml,会按规则输出 PASS/FAIL。

七类规则:STRUCT 要求 TYPO3 原生布局(config/ 位于 composer 项目根、无 build/config、config/sites/*/config.yaml、提交 composer.lock、.gitignore 排除 vendor/var/public 及 live-env 文件);CONTAINER 要求 compose.yaml(非 docker-compose.yml)、镜像固定(第三方用 @sha256 摘要或非浮动标签,禁止 :latest/:edge,registry.netresearch.de 一方镜像可浮动)、持久服务需 healthchecks、deploy.resources.limits 与 restart,禁止直接挂载 docker.sock;CI 要求 composer audit → Trivy 门禁 → SBOM → cosign、CI 任务镜像固定、fly 下载校验和、密钥检测、测试门禁、通过 MR 更新;DEPLOY 要求 Valkey(认证、驱逐、不持久化)、ofelia 经 socket-proxy 调度、每周恢复验证、日志输出到 stdout/stderr;DEP 要求声明 PHP 平台约束、无 dev 分支约束、minimum-stability: stable、提交 lock;SEC 要求不提交密钥(settings.php/additional.php 无密钥、由环境驱动)、不提交 live-env 文件、无调试/主机通配符;DOC 要求 AGENTS.md 加 CLAUDE.md 符号链接、README 记录 setup/env/make。

使用方式:先确认 type: project 与根 Compose,否则不适用;运行检查器或按上述规则族评估,ERROR 阻断、WARN 应修复、INFO 为建议;架构/资产/运行时规则(三仓库拆分、uptime、php-fpm status、ci-colocation)为咨询性,只报告不阻断;修复后重新评分,仓库范围规则应保持 100%。

typo3-14-gold 是可得 100% 的可运行参考实现,typo3-project-standard 为可读配套,二者均为 Netresearch 内部且可选。迁移旧 support/typo3-NN/app 仓库见 references/migration-from-reference.md,只读 settings.php 见 references/sealed-settings-php.md,data/*.sql 种子见 references/database-seeds.md。规则变更建议在 gen_rules.py 中提出。