Skip to content

Latest commit

 

History

History
56 lines (35 loc) · 3.7 KB

troubleshooting.md

File metadata and controls

56 lines (35 loc) · 3.7 KB
Raw

Troubleshooting

ENOTINHISTORY Commit not in history

This error happens when the commit associated with the last release cannot be found in the branch history.

Multiple situation can cause this issue:

  • The package name configured in your package.json already exists and semantic-release obtains the last release of that package, which is unrelated to yours
  • The commit history has been rewritten since the last release (with git rebase and git push -f)

If the package name configured in your package.json already exits, you should change it, and commit the package.json. Then semantic-release will proceed normally and make the initial release.

If you can identify the commit in your branch history that should be associated with the release version mentioned in the error message you can recover by tagging this commit:

$ git tag -f v<version of the last release> <commit sha1 corresponding to last release>
$ git push -f --tags origin <your release branch>

ENOGITHEAD There is no commit associated with last release

This error happens when there is no commit associated with the last release that can be found in the package metadata on the npm registry.

This usually happen when the last release has been made without access to the git repository informations.

You can recover from that issue by identifying the commit in your branch history that should have been associated with the release version mentioned in the error message and tagging this commit:

$ git tag -f v<version of the last release> <commit sha1 corresponding to last release>
$ git push -f --tags origin <your release branch>

You do not have permission to publish 'package-name'

When running semantic-release you may encounter the following error:

An error occurred while running semantic-release: { Error: Command failed: npm publish ./. --registry https://registry.npmjs.org/
npm ERR! publish Failed PUT 403
npm ERR! code E403
npm ERR! You do not have permission to publish "<package-name>". Are you logged in as the correct user? : <package-name>

This message is a little unclear, and might not have anything to with your NPM_TOKEN or authentication method. It might instead be related to the package name itself. If there is already a package with the same name as yours or, there is a very close match, it could trigger this error.

Best way to be sure, is to search npmjs.org) using your package name. If there is a name conflict, rename your package in your package.json

Squashed commits are ignored by semantic-release

semantic-release parses commits according to a commit message convention to figure out how they affect the codebase. Commits that doesn't follow the project's commit message convention are simply ignored.

When squashing commits most Git tools will by default generate a new commit message with a summary of the squashed commits. This commit message will most likely not be compliant with the project's commit message convention and therefore will be ignored by semantic-release.

When squashing commits make sure to rewrite the resulting commit message to be compliant with the project's commit message convention.

Note: if the resulting squashed commit would encompasses multiple changes (for example multiple unrelated features or fixes) then it's probably not a good idea to squash those commits together. A commit should contain exactly one self-contained functional change and a functional change should be contained in exactly one commit. See atomic commits.