coreos/zincati

Release 0.0.16

Closed this issue · 3 comments

lucab commented

Release process

This project uses cargo-release in order to prepare new releases, tag and sign the relevant git commit, and publish the resulting artifacts to crates.io.
The release process follows the usual PR-and-review flow, allowing an external reviewer to have a final check before publishing.

In order to ease downstream packaging of Rust binaries, an archive of vendored dependencies is also provided (only relevant for offline builds).

Requirements

This guide requires:

  • a web browser (and network connectivity)
  • git
  • GPG setup and personal key for signing
  • cargo (suggested: latest stable toolchain from rustup)
  • cargo-release (suggested: cargo install -f cargo-release)
  • A verified account on crates.io
  • Write access to this GitHub project

Release checklist

These steps show how to release version x.y.z on the origin remote (this can be checked via git remote -av).
Push access to the upstream repository is required in order to publish the new tag and the PR branch.

  • make sure the project is clean and prepare the environment:
    • cargo test
    • cargo clean
    • git clean -fd
    • RELEASE_VER=x.y.z
    • UPSTREAM_REMOTE=origin

⚠️: UPSTREAM_REMOTE should reference the locally configured remote that points to the upstream git repository i.e. git@github.com:coreos/zincati.git.

  • create release commits on a dedicated branch and tag it:

    • git checkout -b release-${RELEASE_VER}
    • cargo release (and confirm the version when prompted)

  • open a PR for this release:

    • git push ${UPSTREAM_REMOTE} release-${RELEASE_VER}
    • open a web browser and create a PR for the branch above
    • make sure the resulting PR contains exactly two commits
    • in the PR body, write a short changelog with relevant changes since last release

  • get the PR reviewed, approved and merged

  • publish the artifacts (tag and crate):

    • git checkout v${RELEASE_VER}
    • verify that grep "^version = \"${RELEASE_VER}\"$" Cargo.toml produces output
    • git push ${UPSTREAM_REMOTE} v${RELEASE_VER}
    • cargo publish

  • assemble vendor archive:

    • cargo vendor
    • tar -czf target/zincati-${RELEASE_VER}-vendor.tar.gz vendor

  • publish the release:

    • find the new tag in the GitHub tag list and click the triple dots menu, and create a release for it
    • write a short changelog (i.e. re-use the PR content) and publish the release
    • upload target/zincati-${RELEASE_VER}-vendor.tar.gz
    • record digests of local artifacts:
      • sha256sum target/package/zincati-${RELEASE_VER}.crate
      • sha256sum target/zincati-${RELEASE_VER}-vendor.tar.gz
    • publish release

  • clean up the local environment (optional, but recommended):

    • cargo clean
    • rm -rf vendor
    • git checkout master
    • git pull ${UPSTREAM_REMOTE} master
    • git push ${UPSTREAM_REMOTE} :release-${RELEASE_VER}
    • git branch -d release-${RELEASE_VER}
lucab commented

PR at #460

lucab commented

This unfortunately fails to publish because:

    Updating crates.io index
   Packaging zincati v0.0.16 (/[...]/coreos/zincati)
error: failed to prepare local package for uploading

Caused by:
  failed to open for archiving: `/[...]/coreos/zincati/tests/kola/misc/data/misc/data/misc/data/misc/data/misc/data/misc/data/misc/data/misc/data/misc/data/misc/data/misc/data/misc/data/misc/data/misc/data/misc/data/misc/data/misc/data/misc/data/misc/data/misc/data/misc/data/misc/data/misc/data/misc/data/misc/data/misc/data/misc/data/misc/data/misc/data/misc/data/misc/data/misc/data/misc/data/misc/data/misc/data/misc/data/misc/data/misc/data/misc/data/misc/data/misc/data`

Caused by:
  Too many levels of symbolic links (os error 40)
lucab commented

I have to abort this release because of #462.
I'll re-spin a new one once publishing is fixed.