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
Update documentation and version matrix
- Pick a release name from here, here, here, here, here, or other interesting sources*
- Update the list of release names below
- If the release includes a Beam version bump, update the version matrix
Automatic (CI)
Checkout and update the main
branch.
git checkout main
git pull
Create and push a new version tag
git tag -a vX.Y.Z -m "vX.Y.Z"
git push origin vX.Y.Z
Manual
- 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”
- When the tag build completes, update release notes with name and change log
- Run
./scripts/make-site.sh
to update documentation
After successfully published artifacts
- Run scripts/bump_scio.sh to update homebrew formula and
scioVersion
in downstream repos including scio.g8, featran, etc. - Send external announcement to scio-users@googlegroups.com and user@beam.apache.org
- Announce on 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; Harry Potter spells starting with 0.8.0
; Latin names of cities in ascending alphabetical order starting 0.10.0
; Latin names of countries in ascending alphabetical order starting 0.11.0
.
Past release names
0.12.x
0.11.x
- v0.11.13 - “Galatia”
- v0.11.12 - “Formosa”
- v0.11.11 - “Finnia”
- v0.11.10 - “Dania”
- v0.11.9 - “Dacia”
- v0.11.8 - “Cyrenaica”
- v0.11.7 - “Creta”
- v0.11.6 - “Colchis”
- v0.11.5 - “Cambria”
- v0.11.4 - “Britannia”
- v0.11.3 - “Bithynia”
- v0.11.2 - “Batavia”
- v0.11.1 - “Armorica”
- v0.11.0 - “Ariana”
0.10.x
- v0.10.4 - “Edessa”
- v0.10.3 - “Dallasium”
- v0.10.2 - “Cantabrigia”
- v0.10.1 - “Belli Horizontis”
- v0.10.0 - “Aquae Sextiae”
0.9.x
- v0.9.6 - “Specialis Revelio”
- 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
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”
0.12.3+0-0b1102d7+20230130-1503*