Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Release vg v1.60.0 #4374

Open
26 tasks
adamnovak opened this issue Aug 12, 2024 · 0 comments
Open
26 tasks

Release vg v1.60.0 #4374

adamnovak opened this issue Aug 12, 2024 · 0 comments
Milestone

Comments

@adamnovak
Copy link
Member

adamnovak commented Aug 12, 2024

  1. Create a new release on Github
    1. Look up the next scheduled codename in version.cpp. If we have run to the end of the list of codenames, quickly PR some more to master.
    2. Tag it vX.Y.Z
    3. Title it vg X.Y.Z - Codename Here
    4. Mark it as a prerelease
    5. Publish it (which tags the commit and kicks off the Docker build on our Gitlab)
  2. Produce a buildable source tarball, containing code for vg and all submodules, and upload it to the release.
    mkdir source-tarball
    cd source-tarball
    git clone --recursive https://github.com/vgteam/vg.git
    cd vg
    git fetch --tags origin
    LATEST_TAG="$(git describe --tags `git rev-list --tags --max-count=1`)"
    git checkout "${LATEST_TAG}"
    git submodule update --init --recursive
    make version
    rm -Rf .git
    find deps -name ".git" -exec rm -Rf "{}" \;
    cd ..
    mv vg "vg-${LATEST_TAG}"
    tar -czf "vg-${LATEST_TAG}.tar.gz" "vg-${LATEST_TAG}"
    rm -Rf "vg-${LATEST_TAG}"
    
  3. Build and upload a static Linux binary (/bin/vg file) for the release (Mac OS X can't build static binaries.)
    cd vg
    git remote add upstream https://github.com/vgteam/vg.git || true
    git fetch --tags upstream
    LATEST_TAG="$(git describe --tags `git rev-list --tags --max-count=1`)"
    git checkout "${LATEST_TAG}"
    git submodule sync
    git submodule update --init --recursive
    rm -f lib/libsdsl.a
    sed -i s/march=native/march=nehalem/ deps/sdsl-lite/CMakeLists.txt
    CXXFLAGS=" -march=nehalem " make -j8 static
    strip -d bin/vg
    bin/vg test
    
  4. In the new release:
    1. Copy-paste the description of the previous release.
    2. Edit the links and Docker container names in the description to point to the new release
    3. Insert changes from the draft changelog
    4. List any new dependencies
    5. List any updated, moved, new, or removed submodules
      It may help to consult the log of commits since the last release, or to use a command like git diff --stat v1.58.0..v1.59.0 deps.
  5. Clear the draft changelog for the next release
  6. Create a milestone for the next release here, named vX.Y+1.Z, due in 6 weeks.
  7. Create an issue Release vg vX.Y+1.Z for the next release on the Github issues page, using the checklist template under the Release process heading on this wiki page.
    1. Assign it to the milestone.
  8. Update this wiki page with the next release version, date, issue, and milestone.
  9. Gitlab is responsible for building multi-arch (ARM and x86) Docker releases. Make sure that the production-build-job on Gitlab succeeded in the Gitlab CI pipeline for the correct tag of vg. If something went wrong, you can build and push the container manually for your current architecture only:
    VG_VERSION="vX.Y.Z"
    
    git clone --recursive https://github.com/vgteam/vg.git
    cd vg
    git checkout ${VG_VERSION}
    git submodule sync
    git submodule update --init --recursive
    make version
    docker pull mirror.gcr.io/library/ubuntu:20.04
    docker build --target run -t quay.io/vgteam/vg:${VG_VERSION} -f Dockerfile .
    docker build --target test -f Dockerfile .
    
    docker logout quay.io
    docker login quay.io
    docker push quay.io/vgteam/vg:${VG_VERSION}
    docker logout quay.io
    
    See also this issue for building multi-arch Docker images manually.
  10. Once the Docker build is complete, obtain the ARM64 static binary from the container, and upload it to the release.
    VG_VERSION="vX.Y.Z"
    IMAGE_ID="quay.io/vgteam/vg:${VG_VERSION}"
    docker pull --platform linux/arm64 "${IMAGE_ID}"
    CONTAINER_ID="$(docker create --platform linux/arm64 "${IMAGE_ID}")"
    docker cp "${CONTAINER_ID}:vg/bin/vg" "./vg-arm64"
    docker rm "${CONTAINER_ID}"
    docker rmi "${IMAGE_ID}"
    
  11. Edit the release and mark it as no longer a pre-release, to make it the latest stable release.
  12. Contact Rose Miyatsu (or Krizia Chambers while Rose is out) at UCSC by e-mail to promote the release. Send a couple sentences about the milestones reached in the release, a link to the release on Github, and the vg logo or any more relevant image available.
    1. Include these relevant Bluesky handles: @benedictpaten.bsky.social
    2. Include these relevant Twitter handles: @BenedictPaten @erikgarrison @jeizenga @jltsiren @amnovak @JMonlong @glenn_hickey @XianChang6
  13. Close the previous release issue, and the previous release milestone in the milestone list.
@adamnovak adamnovak added this to the v1.60.0 milestone Aug 12, 2024
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

No branches or pull requests

1 participant