站点:阶段部署

全名

org.apache.maven.plugins:maven-site-plugin:3.11.0:stage-deploy

说明

使用wagon 支持的协议将生成的站点部署到 POM 的<distributionManagement> 部分中指定的站点 URL 的暂存或模拟 URL

属性

  • 需要执行一个 Maven 项目。
  • 需要对范围内的工件进行依赖解析:test
  • 自版本:2.0

必需参数

姓名 类型 自从 描述
<输入目录> 文件 2.3 包含生成的项目站点和报告分发的目录。
默认值为${project.reporting.outputDirectory}
别名是outputDirectory

可选参数

姓名 类型 自从 描述
<chmod> 布尔值 2.1 部署后是否在远程站点上运行“chmod”命令。默认为“真”。
默认值为true
用户属性是maven.site.chmod
<chmod模式> 细绳 2.1 “chmod”命令使用的模式。仅在 chmod = true 时使用。默认为“g+w,a+rX”。
默认值为g+w,a+rX
用户属性是maven.site.chmod.mode
<chmod选项> 细绳 2.1 “chmod”命令使用的选项。仅在 chmod = true 时使用。默认为“-Rf”。
默认值为-Rf
用户属性是maven.site.chmod.options
<语言环境> 细绳 2.3 要呈现的以逗号分隔的语言环境列表。第一个有效令牌将是该站点的默认语言环境。
默认值为en
用户属性是locales
<跳过> 布尔值 3.0 将此设置为“true”以跳过站点生成和登台。
默认值为false
用户属性是maven.site.skip
<跳过部署> 布尔值 3.0 将此设置为“true”以跳过站点部署。
默认值为false
用户属性是maven.site.deploy.skip
<stagingRepositoryId> 细绳 2.0.1 将部署暂存站点的存储库的标识符。此 id 将用于 从settings.xml中查找相应的<server>条目 。如果找到匹配的 <server>条目,则其配置的凭据将用于身份验证。如果未指定,则将 distributionManagement.site.id的相应值作为默认值,除非也未定义,否则使用字符串 “stagingSite”。(注意:在 v. 2.3 和 3.0-beta-3之前,始终使用字符串“stagingSite” 。)用户属性为stagingRepositoryId

<stagingSiteURL> 细绳 2.3 暂存站点将部署到此 URL。如果不指定,默认值将是“${project.distributionManagement.site.url}/staging”,其中“project”是当前项目,或者在 reactor 构建中是顶层项目反应堆。

请注意,即使您指定了此插件参数,您仍然需要至少在顶级项目中指明 ${project.distributionManagement.site.url} 以便正确解析模块之间的相对链接。


用户属性是stagingSiteURL
<topSiteURL> 细绳 3.3 顶级分发管理站点 url,用于在自动计算的值不符合预期时进行手动配置。相对模块目录将从这个 url 计算。
用户属性是topSiteURL

参数详情

<chmod>

部署后是否在远程站点上运行“chmod”命令。默认为“真”。
  • 类型布尔值
  • : 2.1
  • 要求
  • 用户属性maven.site.chmod
  • 默认值

<chmod模式>

“chmod”命令使用的模式。仅在 chmod = true 时使用。默认为“g+w,a+rX”。
  • 类型java.lang.String
  • : 2.1
  • 要求
  • 用户属性maven.site.chmod.mode
  • 默认值g+w,a+rX

<chmod选项>

“chmod”命令使用的选项。仅在 chmod = true 时使用。默认为“-Rf”。
  • 类型java.lang.String
  • : 2.1
  • 要求
  • 用户属性maven.site.chmod.options
  • 默认值-Rf

<输入目录>

包含生成的项目站点和报告分发的目录。
  • 类型java.io.File
  • : 2.3
  • 要求
  • 默认值${project.reporting.outputDirectory}
  • 别名输出目录

<语言环境>

要呈现的以逗号分隔的语言环境列表。第一个有效令牌将是该站点的默认语言环境。
  • 类型java.lang.String
  • : 2.3
  • 要求
  • 用户属性语言环境
  • 默认值en

<跳过>

将此设置为“true”以跳过站点生成和登台。
  • 类型布尔值
  • : 3.0
  • 要求
  • 用户属性maven.site.skip
  • 默认值

<跳过部署>

将此设置为“true”以跳过站点部署。
  • 类型布尔值
  • : 3.0
  • 要求
  • 用户属性maven.site.deploy.skip
  • 默认值

<stagingRepositoryId>

将部署暂存站点的存储库的标识符。此 id 将用于 从settings.xml中查找相应的<server>条目 。如果找到匹配的 <server>条目,则其配置的凭据将用于身份验证。如果未指定,则将 distributionManagement.site.id的相应值作为默认值,除非也未定义,否则使用字符串 “stagingSite”。(注意:在 v. 2.3 和 3.0-beta-3之前,始终使用字符串“stagingSite” 。)
  • 类型java.lang.String
  • 2.0.1
  • 要求
  • 用户属性stagingRepositoryId

<stagingSiteURL>

暂存站点将部署到此 URL。如果不指定,默认值将是“${project.distributionManagement.site.url}/staging”,其中“project”是当前项目,或者在 reactor 构建中是顶层项目反应堆。

请注意,即使您指定了此插件参数,您仍然需要至少在顶级项目中指明 ${project.distributionManagement.site.url} 以便正确解析模块之间的相对链接。

  • 类型java.lang.String
  • : 2.3
  • 要求
  • 用户属性stagingSiteURL

<topSiteURL>

顶级分发管理站点 url,用于在自动计算的值不符合预期时进行手动配置。相对模块目录将从这个 url 计算。
  • 类型java.lang.String
  • : 3.3
  • 要求
  • 用户属性topSiteURL