Repository: activemq-artemis Updated Branches: refs/heads/master fec654648 -> 3593dd54c
chapter about staging maven and validating releases Project: http://git-wip-us.apache.org/repos/asf/activemq-artemis/repo Commit: http://git-wip-us.apache.org/repos/asf/activemq-artemis/commit/3593dd54 Tree: http://git-wip-us.apache.org/repos/asf/activemq-artemis/tree/3593dd54 Diff: http://git-wip-us.apache.org/repos/asf/activemq-artemis/diff/3593dd54 Branch: refs/heads/master Commit: 3593dd54c948e97f9c853daeb98e674f1e113ebf Parents: fec6546 Author: Clebert Suconic <clebertsuco...@apache.org> Authored: Tue Sep 8 15:45:32 2015 -0400 Committer: Clebert Suconic <clebertsuco...@apache.org> Committed: Wed Sep 9 10:18:43 2015 -0400 ---------------------------------------------------------------------- docs/hacking-guide/en/SUMMARY.md | 1 + docs/hacking-guide/en/validating-releases.md | 69 +++++++++++++++++++++++ 2 files changed, 70 insertions(+) ---------------------------------------------------------------------- http://git-wip-us.apache.org/repos/asf/activemq-artemis/blob/3593dd54/docs/hacking-guide/en/SUMMARY.md ---------------------------------------------------------------------- diff --git a/docs/hacking-guide/en/SUMMARY.md b/docs/hacking-guide/en/SUMMARY.md index d9c7a05..2c8038f 100644 --- a/docs/hacking-guide/en/SUMMARY.md +++ b/docs/hacking-guide/en/SUMMARY.md @@ -6,5 +6,6 @@ * [Building](building.md) * [Tests](tests.md) * [Code Formatting](formatting.md) +* [Validating releases](validating-releases.md) * [Notes for Maintainers](maintainers.md) http://git-wip-us.apache.org/repos/asf/activemq-artemis/blob/3593dd54/docs/hacking-guide/en/validating-releases.md ---------------------------------------------------------------------- diff --git a/docs/hacking-guide/en/validating-releases.md b/docs/hacking-guide/en/validating-releases.md new file mode 100644 index 0000000..bb5b665 --- /dev/null +++ b/docs/hacking-guide/en/validating-releases.md @@ -0,0 +1,69 @@ +# Validating releases + +## Setting up the maven repository + +When a release is proposed a maven repository is staged. + +This information here was extracted from [Guide to Testing Staged Releases](https://maven.apache.org/guides/development/guide-testing-releases.html) + +For examples, the 1.1.0 release had the Maven Repository statged as [https://repository.apache.org/content/repositories/orgapacheactivemq-1066](https://repository.apache.org/content/repositories/orgapacheactivemq-1066). + +The first thing you need to do is to be able to use this release. The easiest way we have found is to change your maven settings at ``~/.m2/settings.xml``, setting up the staged repo. + + +*file ~/.m2/settings.xml:* + +```xml +<?xml version="1.0" encoding="UTF-8" standalone="no"?> +<settings> + <profiles> + <profile> + <id>apache-artemis-test</id> + <repositories> + + <repository> + <id>artemis-test</id> + <name>Apache Artemis Test</name> + <url>https://repository.apache.org/content/repositories/orgapacheactivemq-1066</url> + <layout>default</layout> + <releases> + <enabled>true</enabled> + </releases> + <snapshots> + <enabled>true</enabled> + </snapshots> + </repository> + </repositories> + + <pluginRepositories> + + <pluginRepository> + <id>artemis-test2</id> + <name>Apache Artemis Test</name> + <url>https://repository.apache.org/content/repositories/orgapacheactivemq-1066</url> + <releases> + <enabled>true</enabled> + </releases> + <snapshots> + <enabled>true</enabled> + </snapshots> + </pluginRepository> + </pluginRepositories> + </profile> + </profiles> + + <activeProfiles> + <activeProfile>apache-artemis-test</activeProfile> + </activeProfiles> +</settings> +``` + +After you configure this, all the maven objects will be available to your builds. + + +## Using the examples + +The Apache ActiveMQ Artemis examples will create servers and use most of the maven components as real application were supposed to do. +You can do this by running these examples after the .m2 profile installations for the staged repository. + +Of course you can use your own applications after you have staged the maven repository.