|
|
(6 intermediate revisions by the same user not shown) |
Line 1: |
Line 1: |
| + | == Release Engineers == |
| + | |
| + | [[Martin_Nowak]] |
| + | |
| == Requirements == | | == Requirements == |
| | | |
Line 18: |
Line 22: |
| == Build steps == | | == Build steps == |
| | | |
− | * Make sure dmd/VERSION contains the to be build version
| + | * Use the [https://gist.github.com/MartinNowak/a471fe7ddbfeef205cdf04c93a94c6d0 release.sh] script |
− | <code>
| |
− | cd dmd
| |
− | git checkout stable
| |
− | echo 2.072.1 > VERSION
| |
− | git add VERSION
| |
− | git commit -m 'update VERSION file'
| |
− | git push upstream stable
| |
− | </code>
| |
− | | |
− | * Combining the changelog
| |
− | ** copy the changelog.dd parts from the dmd/druntime/phobos stable repos to a new dlang.org/changelog/2.068.1.dd
| |
− | ** use tools/changed to get the bugzilla changelog list
| |
− | ** Use dlang.org/changelog/update_nav.sh to update prev/next navigation in changelogs
| |
− | ** Update dlang.org/win32.mak
| |
− | | |
− | * Test building the stable branch
| |
− | ** cd installer/create_dmd_release
| |
− | ** rdmd build_all v2.070.2 stable
| |
− | ** possibly fix build script, repos, or update patches
| |
− | | |
− | * Tag a new version
| |
− | | |
− | Push the tags to your private forks (origin) first to test whether the release builds cleanly. Tags on upstream '''must''' not be changed ever. To build from your private forks you need to change the base url in [https://github.com/D-Programming-Language/installer/blob/e5c8c60295e5d83c086d98f08978273059dec24d/create_dmd_release/build_all.d#L336 cloneSources].
| |
− | | |
− | <code>
| |
− | for proj in dmd druntime phobos tools dlang.org installer; do
| |
− | pushd $proj
| |
− | git fetch upstream
| |
− | git tag -sm 'v2.071.2-b4' v2.071.2-b4 upstream/stable
| |
− | git push origin v2.071.2-b4
| |
− | popd
| |
− | done
| |
− | </code>
| |
− | | |
− | * Build binaries
| |
− | ** cd installer/create_dmd_release
| |
− | ** rm -rf build
| |
− | ** rdmd build_all v2.070.2 v2.071.2-b4
| |
− | | |
− | * Sign binaries
| |
− | | |
− | <code>
| |
− | for file in build/*; do
| |
− | gpg2 -b $file
| |
− | done
| |
− | </code>
| |
− | | |
− | * Perform additional tests
| |
− | * Upload binaries
| |
− | ** <code>rsync --progress -av --chmod=ug=rw build/ martin@digitalmars.com:/var/pub/digitalmars.com/</code>
| |
− | ** Upload to releases or pre-releases
| |
− | *** <code>aws --profile ddo s3 sync build/ s3://downloads.dlang.org/pre-releases/$(date '+%Y')/ --acl public-read --cache-control max-age=604800</code>
| |
− | *** <code>aws --profile ddo s3 sync build/ s3://downloads.dlang.org/releases/$(date '+%Y')/ --acl public-read --cache-control max-age=604800</code>
| |
− | *** Make sure to check for errors during upload and probably repeat
| |
− | | |
− | * If everything went right until here, push the tags to upstream
| |
− | | |
− | <code>
| |
− | for proj in dmd druntime phobos tools dlang.org installer; do
| |
− | git -C $proj push upstream v2.068.1-b1
| |
− | done
| |
− | </code>
| |
− | | |
− | * Update LATEST_BETA or LATEST
| |
− | ** aws --profile ddo s3 cp LATEST_BETA s3://downloads.dlang.org/pre-releases/LATEST --acl public-read
| |
− | ** aws --profile ddo s3 cp LATEST s3://downloads.dlang.org/releases/LATEST --acl public-read
| |
− | | |
− | * Update downloads.dlang.org
| |
− | ** cd downloads.dlang.org (https://github.com/braddr/downloads.dlang.org)
| |
− | ** ls create_dmd_release/build >> make-links
| |
− | ** edit 'make-links' and add symlinks for all the new files
| |
− | ** run <code>./make-links</code>
| |
− | ** build <code>make -C src</code>
| |
− | ** and run <code>./src/build-gen-index s3_index generate</code> to regenerate the download pages to ./ddo
| |
− | ** <code>aws --profile ddo s3 sync ./ddo/ s3://downloads.dlang.org/ --acl public-read --cache-control max-age=604800</code>
| |
− | ** commit and push changes to downloads.dlang.org
| |
− | | |
− | * Update LATEST_BETA or LATEST on ftp server (for compatibility with older scripts)
| |
− | ** ssh martin@digitalmars.com 'echo -n 2.071.2-b4 > /var/pub/digitalmars.com/LATEST_BETA'
| |
− | ** ssh martin@digitalmars.com 'echo -n 2.071.2 > /var/pub/digitalmars.com/LATEST'
| |
− | | |
− | * Merge stable branches into master
| |
− | | |
− | <code>
| |
− | cd dmd # repeat for every repo
| |
− | git fetch upstream
| |
− | git checkout -b merge_stable upstream/master
| |
− | git merge upstream/stable
| |
− | # fix any conflicts
| |
− | git hub pull new -b master
| |
− | </code>
| |
− | * Rebuild and sync dlang.org
| |
− | * Use a tool like [https://github.com/ocodia/Check-My-Links/ Check-My-Links] to check the download pages
| |
− | * Write an announcement to digitalmars.D.announce and/or dmd-beta.
| |
− | * Update the version in D's [https://en.wikipedia.org/wiki/D_(programming_language) Wikipedia article]
| |
− | * Publish announcements to Twitter, Reddit, HackerNews, Slashdot (make noise!)
| |
− | * Update DMD version in this [[Template:Latest_DMD_Version_Raw|D wiki]]
| |
− | | |
− | | |
− | == Draft for DUB release building ==
| |
− | | |
− | <code>
| |
− | DUB_VERSION=v1.1.1
| |
− | cd dub
| |
− | git checkout stable
| |
− |
| |
− | # (... edit change log with the final release date ...)
| |
− |
| |
− | echo "module dub.version_;" > source/dub/version_.d
| |
− | echo "enum dubVersion = \"$DUB_VERSION\";" >> source/dub/version_.d
| |
− | git add CHANGELOG.md source/dub/version_.d
| |
− | git commit -m "Update change log and version file."
| |
− | # should be a proper tag with message, possibly signed
| |
− | git tag $DUB_VERSION --sign --message="$DUB_VERSION"
| |
− |
| |
− | ./build.sh
| |
− |
| |
− | # if everything went right:
| |
− | git push upstream $DUB_VERSION
| |
− |
| |
− | # (... copy binary to release archive ...)
| |
− | </code>
| |
− | | |
− | Note: downloads on code.dlang.org are automatically built once the new version tag gets pushed.
| |