更新时间:2025-08-27 GMT+08:00
分享

目录配置

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

默认系统目录是组件部署目录、日志目录使用系统提供的默认路径,组件启动用户以及可以访问组件部署目录、日志目录的用户默认为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。

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

相关文档