部署引导联动首页初始化:bootstrap_deployment 自动调用 seed_homepage/seed_privacy_policy

- bootstrap_deployment 在 setup_rbac_groups 之后依次调用 seed_homepage、
  seed_privacy_policy,容器每次启动(entrypoint.sh: migrate -> collectstatic ->
  bootstrap_deployment)会自动创建首页并绑定 Site.root_page,再创建隐私政策页面,
  无需人工登录后台手动操作。
- 新增测试验证联动创建效果与幂等性(pytest 65 -> 67,全部通过)。
This commit is contained in:
2026-09-10 16:15:27 +08:00
parent ca1e63e973
commit 599483c3f2
2 changed files with 52 additions and 1 deletions
@@ -12,6 +12,10 @@
- 若三个环境变量未完整设置,跳过此步骤并给出提示(适用于已手动创建过超管、
或本地开发环境无需自动建号的场景)。
2. 调用 `setup_rbac_groups` 命令初始化/重置 RBAC 权限组(详见该命令的说明)。
3. 调用 `seed_homepage` 命令:若尚无 home.HomePage 实例,创建首页并将默认 Site
指向它,同时清理 Wagtail 自带的占位欢迎页(已存在则跳过创建,仅确认站点绑定)。
4. 调用 `seed_privacy_policy` 命令:在首页下创建/更新隐私政策页面(依赖第 3 步
已存在的 HomePage)。
安全说明:
- 密码只应通过环境变量/密钥管理服务注入,不会被写入日志。
@@ -25,11 +29,16 @@ from django.core.management.base import BaseCommand
class Command(BaseCommand):
help = "部署引导:按需创建首个超级管理员账号 + 初始化 RBAC 权限组,可重复执行。"
help = (
"部署引导:按需创建首个超级管理员账号 + 初始化 RBAC 权限组 + "
"初始化首页与隐私政策页面,可重复执行。"
)
def handle(self, *args, **options):
self._bootstrap_superuser()
call_command("setup_rbac_groups")
call_command("seed_homepage")
call_command("seed_privacy_policy")
def _bootstrap_superuser(self):
username = os.environ.get("DJANGO_SUPERUSER_USERNAME")
+42
View File
@@ -520,6 +520,48 @@ def test_bootstrap_deployment_does_not_overwrite_existing_superuser_password(mon
assert user.check_password("new-pass") is False
def test_bootstrap_deployment_seeds_homepage_and_privacy_policy(monkeypatch):
"""bootstrap_deployment 应联动创建首页并将默认站点指向它,同时初始化隐私政策页面,
避免每次部署都要人工登录后台手动建首页。"""
from django.core.management import call_command
from wagtail.models import Site
from apps.home.models import HomePage
monkeypatch.delenv("DJANGO_SUPERUSER_USERNAME", raising=False)
monkeypatch.delenv("DJANGO_SUPERUSER_EMAIL", raising=False)
monkeypatch.delenv("DJANGO_SUPERUSER_PASSWORD", raising=False)
call_command("bootstrap_deployment")
home_page = HomePage.objects.first()
assert home_page is not None
assert home_page.slug == "home"
site = Site.objects.get(is_default_site=True)
assert site.root_page_id == home_page.pk
assert SimpleContentPage.objects.child_of(home_page).filter(slug="privacy-policy").exists()
def test_bootstrap_deployment_is_idempotent_for_homepage_seeding(monkeypatch):
"""重复执行 bootstrap_deployment 不应重复创建首页或隐私政策页面。"""
from django.core.management import call_command
from apps.home.models import HomePage
monkeypatch.delenv("DJANGO_SUPERUSER_USERNAME", raising=False)
monkeypatch.delenv("DJANGO_SUPERUSER_EMAIL", raising=False)
monkeypatch.delenv("DJANGO_SUPERUSER_PASSWORD", raising=False)
call_command("bootstrap_deployment")
call_command("bootstrap_deployment")
assert HomePage.objects.count() == 1
home_page = HomePage.objects.first()
assert SimpleContentPage.objects.child_of(home_page).filter(slug="privacy-policy").count() == 1
def test_bootstrap_deployment_also_initializes_rbac_groups(monkeypatch):
from django.contrib.auth.models import Group
from django.core.management import call_command