diff options
author | Jisi Liu <liujisi@google.com> | 2015-04-09 10:36:14 -0700 |
---|---|---|
committer | Jisi Liu <liujisi@google.com> | 2015-04-09 10:36:14 -0700 |
commit | f0b510ac22798cb4cd805acf5b1798fd1aee9824 (patch) | |
tree | 138ef81cf376a77b9bbc2261aab41047f408d142 /protoc-artifacts/README.md | |
parent | 8750f72533a11bec7dd08c582366935978994551 (diff) | |
parent | 1c12612bad4e44beae09c43ea1171183d21aea49 (diff) | |
download | protobuf-f0b510ac22798cb4cd805acf5b1798fd1aee9824.tar.gz protobuf-f0b510ac22798cb4cd805acf5b1798fd1aee9824.tar.bz2 protobuf-f0b510ac22798cb4cd805acf5b1798fd1aee9824.zip |
Merge pull request #271 from zhangkun83/protoc-artifact-maven
Process to deploy artifacts for multiple platforms into a single release.
Diffstat (limited to 'protoc-artifacts/README.md')
-rw-r--r-- | protoc-artifacts/README.md | 62 |
1 files changed, 61 insertions, 1 deletions
diff --git a/protoc-artifacts/README.md b/protoc-artifacts/README.md index 2f3ed218..3a530197 100644 --- a/protoc-artifacts/README.md +++ b/protoc-artifacts/README.md @@ -54,7 +54,67 @@ Before you can upload artifacts to Maven Central repository, make sure you have read [this page](http://central.sonatype.org/pages/apache-maven.html) on how to configure GPG and Sonatype account. -Use the following command to upload artifacts: +You need to perform the deployment for every platform that you want to +suppport. DO NOT close the staging repository until you have done the +deployment for all platforms. Currently the following platforms are supported: +- Linux (x86_32 and x86_64) +- Windows (x86_32 and x86_64) with + - Cygwin with MinGW compilers (both x86_32 and x86_64) + - MSYS with MinGW32 (x86_32 only) +- MacOSX (x86_32 and x86_64) + +Remove any ``SNAPSHOT`` or ``pre`` suffix from the version string before +deploying. + +Use the following command to deploy artifacts for the host platform to a +staging repository. ``` $ mvn clean deploy -P release ``` +It creates a new staging repository. Go to +https://oss.sonatype.org/#stagingRepositories and find the repository, usually +in the name like ``comgoogle-123``. + +You will want to run this command on a different platform. Remember, in +subsequent deployments you will need to provide the repository name that you +have found in the first deployment so that all artifacts go to the same +repository: +``` +$ mvn clean deploy -P release -Dstaging.repository=comgoogle-123 +``` + +A 32-bit artifact can be deployed from a 64-bit host with +``-Dos.detected.arch=x86_32`` + +When you have done deployment for all platforms, go to +https://oss.sonatype.org/#stagingRepositories, verify that the staging +repository has all the binaries, close and release this repository. + +### Tips for deploying on Windows +Under Windows the following error may occur: ``gpg: cannot open tty `no tty': +No such file or directory``. This can be fixed by configuring gpg through an +active profile in ``.m2\settings.xml`` where also the Sonatype password is +stored: +```xml +<settings> + <servers> + <server> + <id>ossrh</id> + <username>[username]</username> + <password>[password]</password> + </server> + </servers> + <profiles> + <profile> + <id>gpg</id> + <properties> + <gpg.executable>gpg</gpg.executable> + <gpg.passphrase>[password]</gpg.passphrase> + </properties> + </profile> + </profiles> + <activeProfiles> + <activeProfile>gpg</activeProfile> + </activeProfiles> +</settings> +``` |