文档首页/ 应用管理与运维平台 ServiceStage/ 用户指南/ 系统配置/ 目录配置
更新时间：2025-09-26 GMT+08:00
查看PDF
分享

目录配置

目录配置可以满足您统一管理虚拟机部署组件启动用户、运行目录和日志目录的需求。您可以查看系统默认的目录规则，也可以根据实际业务需要自定义系统目录规则。

默认系统目录是组件部署目录、日志目录使用系统提供的默认路径，组件启动用户以及可以访问组件部署目录、日志目录的用户默认为www用户，用户属组默认为www。请参考查看默认系统目录。

如果默认系统目录不能满足您的业务需要，您可以自定义系统目录，请参考自定义系统目录。

查看默认系统目录

  1. 登录ServiceStage控制台。
  2. 选择“系统配置 > 目录配置”，进入“目录配置”页面。
  3. 选择“默认系统目录”页签，查看默认系统目录配置，请参见表1。

    表1 默认系统目录配置

    参数名称

    参数说明

    部署目录
    • “路径”：组件部署路径父目录，默认为“/opt/application”，则组件的绝对部署路径为“/opt/application/${组件实例名称中不包含系统生成的5位随机字符串部分}/${组件版本号}/${组件实例ID}”。

      例如组件实例名称为comp-ecs-env-cce_8DGO1，组件版本号为2025.0520.19070，组件实例ID为41a71313-46a4-411e-9eb5-388b16c9de3a。组件的绝对部署路径则为“/opt/application/comp-ecs-env-cce/2025.0520.19070/41a71313-46a4-411e-9eb5-388b16c9de3a”。组件实例名称说明，请参考背景信息。

    • “用户：用户组”：组件部署目录下文件的所有者和所属组，默认为www、www。表示文件所有者为www用户，文件所属组为www属组。
    • “权限”：组件部署目录下文件的访问权限，默认为751。表示文件所有者（www）拥有读、写、执行权限（rwx），文件所属组（www）拥有读、执行权限（rx），其他用户拥有执行权限（x）。

    日志目录
    • “路径”：组件运行日志存储路径父目录，默认为“/var/log/application”。则组件日志绝对存储路径为“/var/log/application/${组件实例名称中不包含系统生成的5位随机字符串部分}/${组件实例ID}”。

      例如组件实例名称为comp-ecs-env-cce_8DGO1，组件实例ID为41a71313-46a4-411e-9eb5-388b16c9de3a。组件日志绝对存储路径则为“/opt/application/comp-ecs-env-cce/41a71313-46a4-411e-9eb5-388b16c9de3a”。组件实例名称说明，请参考背景信息。

    • “用户：用户组”：组件日志目录下文件的所有者和所属组，默认为www:www。表示文件所有者为www用户，文件所属组为www属组。
    • “权限”：组件日志目录下文件的访问权限，默认为751。表示文件所有者（www）拥有读、写、执行权限（rwx），文件所属组（www）拥有读、执行权限（rx），其他用户拥有执行权限（x）。

    运行用户

    组件启动用户，默认为www用户。

自定义系统目录

  1. 登录ServiceStage控制台。
  2. 选择“系统配置 > 目录配置”，进入“目录配置”页面。
  3. 选择“自定义系统目录”页签，参考表2配置自定义系统目录。

    • 不同的组件应该设置不同的部署目录。
    • 自定义系统目录的服务器，要求安装的虚拟机Agent版本在1.3.121及以上。
    • 自定义目录及其父目录需要保证agent用户有访问权限。
      若使用自定义用户（例如：appuser）在部署目录（例如：/home/appuser）下创建和升级组件时，则必须保证agent用户能够访问该目录。可通过以下两种方式实现权限配置。
      • 设置目录权限。将/home/appuser目录添加其他用户的可执行权限，允许其他用户访问。 
        sudo chmod o+x /home/appuser
      • 使用ACL授予权限。执行以下命令，为agent用户分配访问权限。 
        sudo setfacl -m d:u:agent:rwx /home/appuser
sudo setfacl -R -m u:agent:rwx /home/appuser

      推荐使用ACL方式进行精细化权限管理，以确保安全性和灵活性。

    • 若自定义目录不存在，需要保证运行用户有权限创建自定义目录。
      如使用自定义用户（例如：appuser）在部署目录（例如：/opt/test）下创建和升级组件时，需要保证appuser用户有权限在/opt下面创建目录，可以通过如下命令授予权限： 
      sudo setfacl -m u:appuser:rwx /opt  
sudo setfacl -R -m u:appuser:rwx /opt
    表2 自定义系统目录配置

    参数名称

    参数说明

    运行用户

    组件启动用户。

    如果是自定义用户，需要已经在组件运行的服务器上完成创建。

    部署目录
    • “路径”：组件的部署路径。

      例如修改为“/opt/app”。则设置目录配置时，“目录配置方式”选择“使用自定义系统目录”，组件的绝对部署路径为/opt/app/${组件实例名称中不包含系统生成的5位随机字符串部分}/${组件版本号}/${组件实例ID}/。

      例如组件实例名称为comp-ecs-env-cce_8DGO1，组件版本号为2025.0520.19070，组件实例ID为41a71313-46a4-411e-9eb5-388b16c9de3a。组件的绝对部署路径则为/opt/app/comp-ecs-env-cce/2025.0520.19070/41a71313-46a4-411e-9eb5-388b16c9de3a/。组件实例名称说明，请参考背景信息。

    • “用户：用户组”：组件部署目录下文件的所有者和所属组。

      “用户”固定为您输入的“运行用户”。

      “用户组”如果是您自定义的，需要已经在组件运行的服务器上完成创建。

    • “权限”：组件部署目录下文件的访问权限。由三位数字组成，取值范围为001~777。

      用于定义文件所有者、文件所属组和其他用户对文件的访问权限。

    日志目录
    • “路径”：组件的运行日志存储路径。

      例如修改为“/var/log/app”。则设置目录配置时，“目录配置方式”选择“使用自定义系统目录”，组件日志绝对存储路径为/var/log/app/${组件实例名称中不包含系统生成的5位随机字符串部分}/${组件实例ID}。

      例如组件实例名称为comp-ecs-env-cce_8DGO1，组件实例ID为41a71313-46a4-411e-9eb5-388b16c9de3a。组件日志绝对存储路径则为/opt/app/comp-ecs-env-cce/41a71313-46a4-411e-9eb5-388b16c9de3a/。组件实例名称说明，请参考背景信息。

    • “用户：用户组”：组件日志目录下文件的所有者和所属组。

      “用户”固定为您输入的“运行用户”。

      “用户组”如果是您自定义的，需要已经在组件运行的服务器上完成创建。

    • “权限”：组件日志目录下文件的访问权限。由三位数字组成，取值范围为001~777。

      用于定义文件所有者、文件所属组和其他用户对文件的访问权限。

父主题： 系统配置

相关文档