How to Release

Prerequisites

• Sign up for a Sonatype account here
• Ask for permissions to push to com.spotify domain like in this ticket

• Add Sonatype credentials to ~/.sbt/1.0/credentials.sbt

  credentials ++= Seq(
    Credentials(
  "Sonatype Nexus Repository Manager",
  "oss.sonatype.org",
  "$USERNAME",
  "$PASSWORD"))
  

• Create a PGP key, for example on keybase.io, and distribute it to a public keyserver

Release procedure

• Run the slow integration tests with SLOW=true sbt it:test
• Run release skip-tests in sbt console and follow the instructions
• Go to oss.sonatype.org, find the staging repository, “close” and “release”
• Run ./scripts/make-site.sh to update documentation
• Pick a release name from here, here, here or other interesting sources^*
• Update the list of release names below
• When the tag build completes, update release notes with name and change log
• If the release includes a Beam version bump, update the version matrix
• Run scripts/bump_scio.sh to update homebrew formula and scioVersion in downstream repos including scio.g8, featran, etc.
• Bump version in the internal scio-cookie and monorepo
• Send internal announcement to scio-users@spotify.com and flatmap-announce@spotify.com
• Send external announcement to scio-users@googlegroups.com and user@beam.apache.org
• Announce on internal and public Slack
• Announce on Twitter

^*Starting with 0.4.0 all release names are scientific names of animals with genus and species starting with the same letter, in ascending alphabetical order. Starting with 0.8.0 all release names are Harry Potter spells.

Past release names

0.9.x

• v0.9.5 - “Colovaria”
• v0.9.4 - “Deletrius”
• v0.9.3 - “Petrificus Totalus”
• v0.9.2 - “Alohomora”
• v0.9.1 - “Aberto”
• v0.9.0 - “Furnunculus”

0.8.x

• v0.8.4 - “Expecto Patronum”
• v0.8.3 - “Draconifors”
• v0.8.2 - “Capacious Extremis”
• v0.8.1 - “Bombarda Maxima”
• v0.8.0 - “Amato Animo Animato Animagus”

0.7.x

• v0.7.4 - “Watsonula wautieri”
• v0.7.3 - “Vulpes Vulpes”
• v0.7.2 - “Ursus t. Ussuricus”
• v0.7.1 - “Taxidea Taxus”
• v0.7.0 - “Suricata suricatta”

0.6.x

• v0.6.1 - “Rhyncholestes raphanurus”
• v0.6.0 - “Quelea Quelea”

0.5.x

• v0.5.7 - “Panthera pardus”
• v0.5.6 - “Orcinus orca”
• v0.5.5 - “Nesolagus netscheri”
• v0.5.4 - “Marmota monax”
• v0.5.3 - “Lasiorhinus latifrons”
• v0.5.2 - “Kobus kob”
• v0.5.1 - “Jaculus jerboa”
• v0.5.0 - “Ia io”

0.4.x

• v0.4.7 - “Hydrochoerus hydrochaeris”
• v0.4.6 - “Galago gallarum”
• v0.4.5 - “Felis ferus”
• v0.4.4 - “Erinaceus europaeus”
• v0.4.3 - “Dendrohyrax dorsalis”
• v0.4.2 - “Castor canadensis”
• v0.4.1 - “Blarina brevicauda”
• v0.4.0 - “Atelerix albiventris”

0.3.x

• v0.3.6 - “Veritas odit moras”
• v0.3.5 - “Unitas, veritas, carnitas”
• v0.3.4 - “Sectumsempra”
• v0.3.3 - “Petrificus totalus”
• v0.3.2 - “Ut tensio sic vis”
• v0.3.1 - “Expecto patronum”
• v0.3.0 - “Lux et veritas”

0.2.x

• v0.2.13 - “Ex luna scientia”
• v0.2.12 - “In extremo”
• v0.2.11 - “Saltatio mortis”
• v0.2.10 - “De Mysteriis Dom Sathanas”
• v0.2.9 - “Hoc tempore atque nunc et semper”
• v0.2.8 - “Consummatum est”
• v0.2.7 - “Crescat scientia vita excolatur”
• v0.2.6 - “Sensu lato”
• v0.2.5 - “Imperium in imperio”
• v0.2.4 - “Ab imo pectore”
• v0.2.3 - “Aurea mediocritas”
• v0.2.2 - “Intelligenti pauca”
• v0.2.1 - “Sedes incertae”
• v0.2.0 - “Nulli secundus”

0.1.x

• v0.1.11 - “In silico”
• v0.1.10 - “Memento vivere”
• v0.1.9 - “Lucem sequimur”
• v0.1.8 - “Nemo saltat sobrius”
• v0.1.7 - “Spem gregis”
• v0.1.6 - “Sic infit”
• v0.1.5 - “Ad astra”
• v0.1.4 - “Ad arbitrium”
• v0.1.3 - “Ut cognoscant te”
• v0.1.2 - “Sapere aude”
• v0.1.1 - “Festina lente”
• v0.1.0 - “Scio me nihil scire”