Skip to content

Latest commit

 

History

History
20 lines (16 loc) · 2.41 KB

RELEASING.md

File metadata and controls

20 lines (16 loc) · 2.41 KB
Raw

Releasing

  1. Create a new release with the next tag version (e.g. v13.3.7), title and release decsription including notable changes mentioning external contributors.
  2. Travis CI will start a CI build for the new tag and publish artifacts to Bintray and will sync them to Maven Central.
  3. Checkout the newly created tag and run sbt -Dakka.genjavadoc.enabled=true "++2.12.0 deployRsync repo.akka.io" to deploy API and reference documentation.

Under the Travis hood

Here is what happens in detail when Travis CI is building a git tagged commit:

  1. According to the .travis.yml file deploy section it first runs a +publish task:
  2. Because of the + a the start of the task, all of these actions are repeated for every scala version defined in crossScalaVersions.
  3. Because of the bintray-sbt plugin, publish builds and uploads artifacts to Bintray.
  4. By default all projects have BintrayPlugin enabled. Projects that have disablePlugins(BintrayPlugin) are not built.
  5. Artifacts are uploaded to https://bintray.com/$bintrayOrganization/$bintrayRepository/$bintrayPackage which in this case is https://bintray.com/akka/maven/akka-http.
  6. Credentials for the publish task are read from the BINTRAY_USER and BINTRAY_PASS environment variables which are stored encrypted on the .travis.yml file. The user under these credentials must be part of the Akka team on Bintray.
  7. Second task in the .travis.yml file deploy section is akka-http/bintraySyncMavenCentral:
  8. This task syncs all of the artifacts under the Akka Http package in Bintray to Maven Central. For the sync to be successful, the package first needs to be added to JCenter repository. This must be done through Bintray Web interface, and only once when the package is created.
  9. This task is only ran for one project, because all Akka Http projects are published to a single package on Bintray.
  10. Credentials for the bintraySyncMavenCentral task are read from the SONATYPE_USER and SONATYPE_PASS environment variables which are stored encrypted on the .travis.yml file. The user under these credentials must have the rights to publish artifacts to the Maven Central under the com.typesafe.akka organization name.