创建新站点

用法

bench new-site [OPTIONS] SITE

说明

创建一个新的 Frappe 站点。此操作会在 ./sites 下创建一个新文件夹,其中将包含该站点的所有站点信息,同时还会在你的数据库管理系统中创建一个新数据库,并安装 Frappe 的所有模块和 DocType。

站点配置位于 ./sites/{site}/site_config.json 下,用于维护站点的状态信息。如需了解更多相关信息,请查看本指南。

如果站点创建因任何原因失败,系统会提示你是否要回滚所做的更改,包括创建的站点目录,以及创建的数据库和数据库用户。

选项

  • --db-name 设置新站点的数据库名称——如果未单独指定,也会用作数据库用户名
  • --db-user 从 v16 起,选择数据库用户名,或指定一个已有的用户名+密码组合
  • --db-password 设置新站点的数据库密码,或指定已有数据库用户的密码。
  • --db-type 选择新站点的数据库类型,可选值为 “postgres” 或 “mariadb”。默认为 “mariadb”
  • --db-host 设置新站点的数据库主机
  • --db-port 设置新站点的数据库端口
  • --db-root-username 指定 MariaDB 或 Postgres 的 Root 用户名
  • --db-root-password 指定 MariaDB 或 Postgres 的 Root 密码
  • --admin-password 指定新站点的管理员密码
  • --source_sql 使用 SQL 文件初始化数据库
  • --install-app 安装后安装应用

标志

  • --no-mariadb-socket 将 MariaDB 主机设置为 %,并使用 TCP/IP Socket 代替 UNIX Socket
  • --verbose 增加详细输出
  • --force 如果站点或同名数据库已存在,则强制恢复

示例

  1. 创建一个新站点。
bench new-site {site}
  1. 创建一个新的 PostgreSQL 站点。
bench new-site {site} --db-type postgres
  1. 创建一个新站点,同时跳过以下交互式提示:

    • 提交站点的 管理员 密码
    • 提交 MariaDB Root 密码
    bench new-site {site}
       --admin-password {admin-password}
       --db-root-password {mariadb-password}
    
  2. 使用非默认值和自动生成的值创建一个新站点。

bench new-site {site} --db-type {type}
   --db-name {name}
   --db-user {user}
   --db-password {pass}
   --db-host {host}
   --db-port {port}
  1. 使用具有数据库创建权限的 MariaDB 非 root 用户创建一个新站点。
bench new-site {site}
   --db-root-username {user}
   --db-root-password {pass}
  1. 创建一个新站点,并安装一个应用 (在当前 bench 中可用)。
bench new-site {site} --install-app {app}