2.8 KiB
Making a Release
-
Make a PR that bumps the version number in the
VERSION
file and adds a new header and label for the new version indocs/source/support/release-notes.rst
(see previous releases as examples). It is important that the PR only changesVERSION
andrelease-notes.rst
. -
"Squash and merge" the PR.
-
Once CI has passed for the corresponding master build, the release should be available on bintray and GitHub, as well as properly tagged.
-
Activate the new version with
da use VERSION
. Note that it will not be picked up byda upgrade
at this point. -
Run through the manual test plan described in https://docs.google.com/document/d/16amcy7bQodXSHjEmKhAUiaPf6O92gUbch1OyixDEvSM/edit?ts=5ca5be00.
The test plan currently still targets the old
da
assistant. We will migrate the test plan fully to the new assistant soon but for now, there is a shorter test plan for the new assistant that you should run on Windows:- Download the installer from https://github.com/digital-asset/daml/releases
- Close any running SDK instance in PowerShell (Navigator or Sandbox)
- Remove any existing installation:
rm -r -Force $env:AppData\daml
- Run the installer.
- Open a new Powershell.
- Remove any existing quickstart directory :
rm -r quickstart
- Run
daml new quickstart
to create a new project. - Switch to the new project:
cd quickstart
- Run
daml start
. - Open your browser at
http://localhost:7500
, verify that you can login as Alice and there is one template and one contract. - Kill
daml start
with Ctrl-C - Run
daml studio
and opendaml/Main.daml
. - Verify that the scenario result appears within 30 seconds.
- Add
+
at the end of line 26 after"Alice"
and verify that you get a red squiggly line.
-
If it passes, the release should be made public. This currently consists of three steps:
-
Tag the release as
visible-external
on Bintray. This step can only be done by someone with permissions to set tags on Bintray. After this step the release will be picked up byda upgrade
. Note that this step requires special privileges on Bintray. If you cannot change it yourself, ask in #team-daml. -
Trigger the CircleCI jobs to create the Docker images. To do so, go to https://circleci.com/gh/DACH-NY/workflows/damlc-docker/tree/master and click "rerun" on "master / Main Variant" and on "master / CircleCI Variant". Once the jobs have passed, you should see two new images on https://hub.docker.com/r/digitalasset/daml-sdk/tags.
-
Publish the draft release on GitHub by going to the releases page and clicking the Edit button for the relevant release.
-