Skip to content

doc: use git-secure-tag for release tags - #7603

Closed
indutny wants to merge 3 commits into
nodejs:masterfrom
indutny:fix/gh-7579
Closed

doc: use git-secure-tag for release tags#7603
indutny wants to merge 3 commits into
nodejs:masterfrom
indutny:fix/gh-7579

Conversation

@indutny

@indutnyindutny commented Jul 8, 2016

Copy link
Copy Markdown
Member
Checklist
  • make -j4 test (UNIX), or vcbuild test nosign (Windows) passes
  • tests and/or benchmarks are included
  • documentation is changed or added
  • commit message follows commit guidelines
Affected core subsystem(s)

doc

Description of change

git-secure-tag recursively constructs an SHA-512 digest out of the
git tree, and puts the hash from the tree's root into the tag
annotation. This hash provides better integrity guarantees than the
default SHA-1 merkle tree that git uses.

Fix: #7579

@nodejs-github-botnodejs-github-bot added the doc Issues and PRs related to the documentations. label Jul 8, 2016
@indutny

Copy link
Copy Markdown
MemberAuthor

cc @rvagg@Fishrock123@rmg

@indutnyindutny mentioned this pull request Jul 8, 2016
@MylesBorins

Copy link
Copy Markdown
Contributor

@indutny does this work with subkeys?

@indutny

Copy link
Copy Markdown
MemberAuthor

@thealphanerd It supports -s and -u options, just as git tag.

@indutny

Copy link
Copy Markdown
MemberAuthor

It does not support -d, -F, and -a, though.

@indutny

Copy link
Copy Markdown
MemberAuthor

Updated description, initial version was misleading. Sorry!

@rmg

rmg commented Jul 8, 2016

Copy link
Copy Markdown
Contributor

I liked the idea before seeing the docs. Now that I see it is literally a drop in replacement with just a few extra keystrokes thrown in and still spits out a signed git tag in the end, I think I like it even more :-)

Comment threaddoc/releases.md Outdated

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

does -sm work (doesn't need to change here, just interested if my keystroke memory will still apply)

Copy link
Copy Markdown
MemberAuthor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Yeah, it actually works. I'll change it back.

Copy link
Copy Markdown
MemberAuthor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pushed.

@rvagg

rvagg commented Jul 8, 2016

Copy link
Copy Markdown
Member

need to make sure we don't have any objectors in @nodejs/release

lgtm

@jasnell

Copy link
Copy Markdown
Member

Emphatic LGTM on this.

@Fishrock123

Copy link
Copy Markdown
Contributor

Should we make a test release with it to ensure everything behaves as expected?

Also, does this work properly with the verification in tools/release.sh?

@rvagg

rvagg commented Jul 8, 2016

Copy link
Copy Markdown
Member

Yes, tools/release.sh is just checking that the key is signed by you, not how it was signed or what it contains so it should be fine. Full releases are the only ones that we normally sign and manually promote, the rest just happen automatically. Perhaps this PR can hold off until the next release, whichever branch that is, to see how it goes.

@indutny

Copy link
Copy Markdown
MemberAuthor

@thealphanerd is going to do a v4 RC release. Does anyone have an objection to using git-secure-tag for it?

@MylesBorinsMylesBorins self-assigned this Jul 11, 2016
@rvagg

Copy link
Copy Markdown
Member

iirc we aren't tagging RC releases these days, only proper releases with a manual promotion, I have no objections to using this in the next v4 though as long as it's understood that if something comes up that causes this to hold up the release (whatever that might be!) then it can be dropped

@indutny

Copy link
Copy Markdown
MemberAuthor

Cool, thank you for the heads up!

@indutny

Copy link
Copy Markdown
MemberAuthor

@rvagg should we land this PR?

@MylesBorins

Copy link
Copy Markdown
Contributor

@indutny I think we were waiting to do a release with the tool first.

looks like this PR needs a rebase

@indutny

Copy link
Copy Markdown
MemberAuthor

@thealphanerd we just did a release without a tool, and it is not clear how release team will learn about tool if we won't land this first :)

`git-secure-tag` recursively constructs an SHA-512 digest out of the
git tree, and puts the hash from the tree's root into the tag
annotation. This hash provides better integrity guarantees than the
default SHA-1 merkle tree that git uses.
Fix: nodejs#7579
@MylesBorins

Copy link
Copy Markdown
Contributor

that's fair. I was under the impression we were waiting for the LTS on this. @nodejs/release are we planning a v6 release for next week? Can we do make the tag with this tool?

@indutny

Copy link
Copy Markdown
MemberAuthor

Rebased.

@ChALkeRChALkeR added the security Issues and PRs related to security. label Jul 23, 2016
@jasnell

Copy link
Copy Markdown
Member

where did we land on this? :-)

@indutny

Copy link
Copy Markdown
MemberAuthor

We didn't, but I think we should.

Comment threaddoc/releases.md Outdated

Install `git-secure-tag` npm module:

```sh

@ChALkeRChALkeRAug 5, 2016

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

console, ref: #7971, #7727.

Copy link
Copy Markdown
MemberAuthor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Ack, thank you!

@indutny

Copy link
Copy Markdown
MemberAuthor

We have two LGTMs here, and general consensus. Going to land it in a bit if no objections will be mentioned.

@jasnell

Copy link
Copy Markdown
Member

SGTM!

@evanlucas

Copy link
Copy Markdown
Contributor

LGTM

@indutny

Copy link
Copy Markdown
MemberAuthor

Landed in 0f3f76c, thank you everyone! cc @nodejs/release

indutny added a commit that referenced this pull request Aug 5, 2016
`git-secure-tag` recursively constructs an SHA-512 digest out of the
git tree, and puts the hash from the tree's root into the tag
annotation. This hash provides better integrity guarantees than the
default SHA-1 merkle tree that git uses.
Fix: #7579
PR-URL: #7603
Reviewed-By: Rod Vagg <rod@vagg.org>
Reviewed-By: James M Snell <jasnell@gmail.com>
Reviewed-By: Evan Lucas <evanlucas@me.com>
@jbergstroem

Copy link
Copy Markdown
Member

Post-land-LGTM -- I think this is a great addition.

Comment threaddoc/releases.md

Install `git-secure-tag` npm module:

```console

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

use sh to keep consistent with others?

Copy link
Copy Markdown
MemberAuthor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This is made in anticipation of other PR that will change the rest to console.

@jasnell

Copy link
Copy Markdown
Member

Whoops, looks like we forgot to close this when it landed.

@jasnelljasnell closed this Aug 8, 2016
@cjihrigcjihrig mentioned this pull request Aug 8, 2016
cjihrig pushed a commit that referenced this pull request Aug 10, 2016
`git-secure-tag` recursively constructs an SHA-512 digest out of the
git tree, and puts the hash from the tree's root into the tag
annotation. This hash provides better integrity guarantees than the
default SHA-1 merkle tree that git uses.
Fix: #7579
PR-URL: #7603
Reviewed-By: Rod Vagg <rod@vagg.org>
Reviewed-By: James M Snell <jasnell@gmail.com>
Reviewed-By: Evan Lucas <evanlucas@me.com>
@cjihrigcjihrig mentioned this pull request Aug 11, 2016
MylesBorins pushed a commit that referenced this pull request Sep 9, 2016
`git-secure-tag` recursively constructs an SHA-512 digest out of the
git tree, and puts the hash from the tree's root into the tag
annotation. This hash provides better integrity guarantees than the
default SHA-1 merkle tree that git uses.
Fix: #7579
PR-URL: #7603
Reviewed-By: Rod Vagg <rod@vagg.org>
Reviewed-By: James M Snell <jasnell@gmail.com>
Reviewed-By: Evan Lucas <evanlucas@me.com>
MylesBorins pushed a commit that referenced this pull request Sep 28, 2016
`git-secure-tag` recursively constructs an SHA-512 digest out of the
git tree, and puts the hash from the tree's root into the tag
annotation. This hash provides better integrity guarantees than the
default SHA-1 merkle tree that git uses.
Fix: #7579
PR-URL: #7603
Reviewed-By: Rod Vagg <rod@vagg.org>
Reviewed-By: James M Snell <jasnell@gmail.com>
Reviewed-By: Evan Lucas <evanlucas@me.com>
rvagg pushed a commit that referenced this pull request Oct 18, 2016
`git-secure-tag` recursively constructs an SHA-512 digest out of the
git tree, and puts the hash from the tree's root into the tag
annotation. This hash provides better integrity guarantees than the
default SHA-1 merkle tree that git uses.
Fix: #7579
PR-URL: #7603
Reviewed-By: Rod Vagg <rod@vagg.org>
Reviewed-By: James M Snell <jasnell@gmail.com>
Reviewed-By: Evan Lucas <evanlucas@me.com>
MylesBorins pushed a commit that referenced this pull request Oct 26, 2016
`git-secure-tag` recursively constructs an SHA-512 digest out of the
git tree, and puts the hash from the tree's root into the tag
annotation. This hash provides better integrity guarantees than the
default SHA-1 merkle tree that git uses.
Fix: #7579
PR-URL: #7603
Reviewed-By: Rod Vagg <rod@vagg.org>
Reviewed-By: James M Snell <jasnell@gmail.com>
Reviewed-By: Evan Lucas <evanlucas@me.com>
@MylesBorinsMylesBorins mentioned this pull request Oct 26, 2016
@MylesBorinsMylesBorins removed their assignment Dec 27, 2016
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Labels

docIssues and PRs related to the documentations.securityIssues and PRs related to security.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Use EVTag for release tags

11 participants

@indutny@MylesBorins@rmg@rvagg@jasnell@Fishrock123@evanlucas@jbergstroem@ChALkeR@yorkie@nodejs-github-bot