| ------ |
| Usage |
| ------ |
| Dennis Lundberg |
| ------ |
| 2007-08-25 |
| ------ |
| |
| ~~ Licensed to the Apache Software Foundation (ASF) under one |
| ~~ or more contributor license agreements. See the NOTICE file |
| ~~ distributed with this work for additional information |
| ~~ regarding copyright ownership. The ASF licenses this file |
| ~~ to you under the Apache License, Version 2.0 (the |
| ~~ "License"); you may not use this file except in compliance |
| ~~ with the License. You may obtain a copy of the License at |
| ~~ |
| ~~ http://www.apache.org/licenses/LICENSE-2.0 |
| ~~ |
| ~~ Unless required by applicable law or agreed to in writing, |
| ~~ software distributed under the License is distributed on an |
| ~~ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY |
| ~~ KIND, either express or implied. See the License for the |
| ~~ specific language governing permissions and limitations |
| ~~ under the License. |
| |
| ~~ NOTE: For help with the syntax of this file, see: |
| ~~ http://maven.apache.org/doxia/references/apt-format.html |
| |
| |
| Usage |
| |
| The plugin is used from the command line. In the following example we will |
| copy artifacts from a staging repository located at |
| <<<http://people.apache.org/~snicoll/maven-stage-repo/>>> |
| that is configured in the user settings file with an <<<apache.staging>>> id |
| to the Apache scp repository located at |
| <<<scp://people.apache.org/www/people.apache.org/repo/m2-ibiblio-rsync-repository>>> |
| that is configured in the user settings file with an <<<apache.releases>>> id. |
| |
| If no special configuration is required for the source or target repositories |
| the <<<sourceRepositoryId>>> or <<<targetRepositoryId>>> parameters |
| respectively can be omitted. |
| |
| ------------------- |
| mvn stage:copy -Dsource="http://people.apache.org/~snicoll/maven-stage-repo/" \ |
| -Dtarget="scp://people.apache.org/www/people.apache.org/repo/m2-ibiblio-rsync-repository" \ |
| -DsourceRepositoryId=apache.staging \ |
| -DtargetRepositoryId=apache.releases \ |
| -Dversion=2.0.3 |
| ------------------- |
| |
| <<Note:>> Although it looks like we are only copying version <<<2.0.3>>>, we |
| are in fact copying <<everything>> from the source URL to the target. This is |
| due to a bug and will change in the future. |
| |
| * What is happening under the hood? |
| |
| The following tasks will be performed by the plugin: |
| |
| * Download the files from the source repository |
| |
| * Download any metadata that is already present in the target repository |
| |
| * Merge source and target metadata |
| |
| * Create a rename script |
| |
| * Create a zip file containing the source files, the merged metadata and the rename script |
| |
| * Upload the zip file to the target repository |
| |
| * Unpack the zip file on the target machine |
| |
| * Delete the zip file from the target repository |
| |
| * Run the rename script on the target machine |
| |
| * Delete the rename script from the target repository |
| |