目录配置
目录配置可以满足您统一管理虚拟机部署组件启动用户、运行目录和日志目录的需求。您可以查看系统默认的目录规则,也可以根据实际业务需要自定义系统目录规则。
默认系统目录是组件部署目录、日志目录使用系统提供的默认路径,组件启动用户以及可以访问组件部署目录、日志目录的用户默认为www用户,用户属组默认为www。请参考查看默认系统目录。
如果默认系统目录不能满足您的业务需要,您可以自定义系统目录,请参考自定义系统目录。
查看默认系统目录
- 登录ServiceStage控制台。
- 选择“目录配置”页面。 ,进入
- 选择“默认系统目录”页签,查看默认系统目录配置,请参见表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用户。
- “路径”:组件部署路径父目录,默认为“/opt/application”,则组件的绝对部署路径为“/opt/application/${组件实例名称中不包含系统生成的5位随机字符串部分}/${组件版本号}/${组件实例ID}”。
自定义系统目录
- 登录ServiceStage控制台。
- 选择“目录配置”页面。 ,进入
- 选择“自定义系统目录”页签,参考表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方式进行精细化权限管理,以确保安全性和灵活性。
- 设置目录权限。将/home/appuser目录添加其他用户的可执行权限,允许其他用户访问。
- 若自定义目录不存在,需要保证运行用户有权限创建自定义目录。
表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。
用于定义文件所有者、文件所属组和其他用户对文件的访问权限。