Skip to content
This repository has been archived by the owner on Apr 22, 2024. It is now read-only.

forcedotcom/npm-release-management-orb

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Deprecated, unmaintained, use at your own discretion.

npm-release-management-orb

CircleCI Build Status Orb Version Badge GitHub license

Usage

Example use-cases are provided on the orb registry page. Source for these examples can be found within the src/examples directory.

This orb is designed to make releasing npm packages straightforward and with as little configuration as possible. To get started you will need to:

  1. Add the orb to your config.yml

    orbs:
      release-management: salesforce/[email protected]

    NOTE: We recommend pinning the major version (e.g. salesforce/npm-release-management@4) so that you automatically receive all minor and patch updates.

  2. Setup the required environment variables.

    Please see the Environment Variable Reference for the required environment variables.

  3. Add a user key to your SSH Keys in CircleCi

    As part of the release job we create a new git tag based on the version in the package.json. This requires that you add a user key that has the permissions to push to github. To do this, simply go to the SSH Keys tab in the project settings and follow the directions for adding user keys. See Using the SF-CLI-BOT for builds section on how to use our github bot for this.

  4. Follow the examples for how to setup your config.yml

Note on Version Bumps and Changelogs

Version bumps and changelogs are generated based on conventional commit messages (We use the standard-version library to do this).

Your plugin will enforce this style of commit messages if you created your plugin using the plugin-template. If you did not using plugin-template, you will need to add the following to your package.json

"devDependencies": {
 "@salesforce/dev-scripts": "^2",
}

And add these .husky files to your project: https://github.com/salesforcecli/plugin-template-sf/tree/main/.husky

And add a commitlint.config.js with the following:

module.exports = { extends: ["@commitlint/config-conventional"] };

Overriding Version Bump

The default behavior of the orb is to use standard-version to determine the next version number. However, you can specify the version you want published by updating the version field in the package.json yourself. If that version does not exist, the orb will publish it. Otherwise, it will fall back to using standard-version

Using the SF-CLI-BOT for builds

We've created the SF-CLI-BOT bot user in github to do any github related tasks in the build (creating releases, pushing tags, merges changes back to a specific branch, etc...). Having this bot ensure that the required tokens and keys do not belong to any one person.

If you would like to use this bot for your builds, contact the CLI team and we will add the ssh keys and github token to your CircleCI pipeline.

Environment Variable Reference

Variable Description Required
AWS_ACCESS_KEY_ID access key id for aws s3 Yes (only if signing packages)
AWS_SECRET_ACCESS_KEY secret access key for aws s3 Yes (only if signing packages)
GH_USERNAME github username that will be used for creating new tags No
GH_EMAIL github email that will be used for creating new tags No
GH_TOKEN github personal access token that will be used for release Yes (only if creating github releases)
NPM_TOKEN auth token for publishing to npm Yes
SALESFORCE_KEY base64 encoded cert for plugin signing Yes (only if signing packages)
SFDX_DEVELOPER_TRUSTED_FINGERPRINT fingerprint from developer.salesforce.com. Used for plugin signing No
NPM_REGISTRY url to npm registry. Used for install and publish. No

Variables for Change Case Management

Please see the docs for the CLI commands here. The orb derives the --location flag from Circle's built-in environment variables, but you must supply the other environment variables (either via a context or project-level settings).

How To Contribute

We welcome issues to and pull requests against this repository!

To publish a new production version:

  • Create a PR to the main branch with your changes.
  • When ready, squash and merge the PR into main. The merge commit should include [semver:major|minor|patch|release|skip] to indicate the type of release. If this is not included, then a new version will not be released.
  • On merge, the release will be published to the orb registry automatically.

For further questions/comments about this or other orbs, visit the Orb Category of CircleCI Discuss.

About

No description, website, or topics provided.

Resources

License

Code of conduct

Security policy

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published