mvn:deploy在整合或者发布环境下执行,将最终版本的包拷贝到远程的repository,使得其他的开发者或者工程可以共享。
一 配置settings.xml
因为nexus是需要登陆操作,当然可以通过配置免登陆,这是后话。
在settings.xml的<servers></servers>
<server>
<id>thirdparty</id>
<username>admin</username>
<password>admin123</password>
</server>
当然如果你要上传包去其他仓库,可依照此例,如
<server>
<id>central</id>
<username>admin</username>
<password>admin123</password>
</server>
如果进行deploy时返回Return code is: 401错误,则需要进行用户验证或者你已经验证的信息有误。
二 cmd输入命令
mvn deploy:deploy-file -DgroupId=com.xy.oracle -DartifactId=ojdbc14 -Dversion=10.2.0.4.0 -Dpackaging=jar -Dfile=E:\ojdbc14.jar -Durl=http://localhost:9090/nexus-2.2-01/content/repositories/thirdparty/ -DrepositoryId=thirdparty
DgroupId和DartifactId构成了该jar包在pom.xml的坐标,项目就是依靠这两个属性定位。自己起名字也行。
Dfile表示需要上传的jar包的绝对路径。
Durl 私服上仓库的位置,打开nexus——>repositories菜单,可以看到该路径。
url中也可以指定用户名、密码。格式:http://<username>:<password>@localhost:9200/nexus-2.2-01/content/repositories/thirdparty/
DrepositoryId 对应maven配置文件setting.xml中server标签的id
如果url中没有指定用户名、密码,需要指定repositoryId
Dversion表示版本信息,怎样得到一个jar包准确的版本呢?
解压该包,会发现一个叫MANIFEST.MF的文件,这个文件就有描述该包的版本信息。
比如Manifest-Version: 1.0可以知道该包的版本了。
上传成功后,在nexus界面点击3rd party仓库可以看到这包。
三、mvn deploy命令参数说明
mvn deploy:help -Ddetail=true
[INFO] Scanning for projects...
[INFO]
[INFO] ------------------------------------------------------------------------
[INFO] Building Maven Stub Project (No POM) 1
[INFO] ------------------------------------------------------------------------
[INFO]
[INFO] --- maven-deploy-plugin:2.7:help (default-cli) @ standalone-pom ---
[INFO] org.apache.maven.plugins:maven-deploy-plugin:2.7
Maven Deploy Plugin
Uploads the project artifacts to the internal remote repository.
This plugin has 3 goals:
deploy:deploy
Deploys an artifact to remote repository.
Available parameters:
altDeploymentRepository
Specifies an alternative repository to which the project artifacts should
be deployed ( other than those specified in <distributionManagement> ).
Format: id::layout::url
Expression: ${altDeploymentRepository}
retryFailedDeploymentCount (Default: 1)
Parameter used to control how many times a failed deployment will be
retried before giving up and failing. If a value outside the range 1-10 is
specified it will be pulled to the nearest value within the range 1-10.
Expression: ${retryFailedDeploymentCount}
skip (Default: false)
Set this to 'true' to bypass artifact deploy
Expression: ${maven.deploy.skip}
updateReleaseInfo (Default: false)
Parameter used to update the metadata to make the artifact as release.
Expression: ${updateReleaseInfo}
deploy:deploy-file
Installs the artifact in the remote repository.
Available parameters:
artifactId
ArtifactId of the artifact to be deployed. Retrieved from POM file if
specified.
Expression: ${artifactId}
classifier
Add classifier to the artifact
Expression: ${classifier}
classifiers
A comma separated list of classifiers for each of the extra side artifacts
to deploy. If there is a mis-match in the number of entries in files or
types, then an error will be raised.
Expression: ${classifiers}
description
Description passed to a generated POM file (in case of generatePom=true)
Expression: ${generatePom.description}
file
File to be deployed.
Required: Yes
Expression: ${file}
files
A comma separated list of files for each of the extra side artifacts to
deploy. If there is a mis-match in the number of entries in types or
classifiers, then an error will be raised.
Expression: ${files}
generatePom (Default: true)
Upload a POM for this artifact. Will generate a default POM if none is
supplied with the pomFile argument.
Expression: ${generatePom}
groupId
GroupId of the artifact to be deployed. Retrieved from POM file if
specified.
Expression: ${groupId}
javadoc
The bundled API docs for the artifact.
Expression: ${javadoc}
packaging
Type of the artifact to be deployed. Retrieved from the <packaging>
element of the POM file if a POM file specified. Defaults to the file
extension if it is not specified via command line or POM.
Maven uses two terms to refer to this datum: the <packaging> element for
the entire POM, and the <type> element in a dependency specification.
Expression: ${packaging}
pomFile
Location of an existing POM file to be deployed alongside the main
artifact, given by the ${file} parameter.
Expression: ${pomFile}
repositoryId (Default: remote-repository)
Server Id to map on the <id> under <server> section of settings.xml In
most cases, this parameter will be required for authentication.
Required: Yes
Expression: ${repositoryId}
repositoryLayout (Default: default)
The type of remote repository layout to deploy to. Try legacy for a Maven
1.x-style repository layout.
Expression: ${repositoryLayout}
retryFailedDeploymentCount (Default: 1)
Parameter used to control how many times a failed deployment will be
retried before giving up and failing. If a value outside the range 1-10 is
specified it will be pulled to the nearest value within the range 1-10.
Expression: ${retryFailedDeploymentCount}
sources
The bundled sources for the artifact.
Expression: ${sources}
types
A comma separated list of types for each of the extra side artifacts to
deploy. If there is a mis-match in the number of entries in files or
classifiers, then an error will be raised.
Expression: ${types}
uniqueVersion (Default: true)
Whether to deploy snapshots with a unique version or not.
Expression: ${uniqueVersion}
updateReleaseInfo (Default: false)
Parameter used to update the metadata to make the artifact as release.
Expression: ${updateReleaseInfo}
url
URL where the artifact will be deployed.
ie ( file:///C:/m2-repo or scp://host.com/path/to/repo )
Required: Yes
Expression: ${url}
version
Version of the artifact to be deployed. Retrieved from POM file if
specified.
Expression: ${version}
deploy:help
Display help information on maven-deploy-plugin.
Call
mvn deploy:help -Ddetail=true -Dgoal=<goal-name>
to display parameter details.
Available parameters:
detail (Default: false)
If true, display all settable properties for each goal.
Expression: ${detail}
goal
The name of the goal for which to show help. If unspecified, all goals
will be displayed.
Expression: ${goal}
indentSize (Default: 2)
The number of spaces per indentation level, should be positive.
Expression: ${indentSize}
lineLength (Default: 80)
The maximum length of a display line, should be positive.
Expression: ${lineLength}