The Publish command pushes artifacts created in the Build stage to an artifact registry primarily for further utilisation by a release pipeline. The user must provide a shell script that handles uploading of artifacts to a package registry of their choice. Typical examples of package registry which supports universal artifacts include Azure Artifacts, JFrog Artifactory.
Rather than lock everyone into a particular registry provider, sfpowerscripts supports artifact registries which support the following
NPM compatible private registry (Almost every artifact registries supports NPM )
A registry which supports universal packages ( Jfrog Aritfactory, Azure Artifacts)
--gittag parameter creates a tag, at the current commit ID, for packages that have been successfully published. In combination with the
--diffcheck parameter in the Build commands, the tags enable significant time-saving by comparing the latest tag with the source code - and only building the package if a change is found.
To publish to a NPM compatible private registry, you need the following
A NPM Compatible private registry, here are some links on different registries and their documentation
Azure Artifacts https://docs.gitlab.com/ee/user/packages/npm_registry/
JFrog Artifactory https://www.jfrog.com/confluence/display/JFROG/npm+Registry
Follow the instructions on your npm registry to generate .npmrc file with the correct URL and access token (which has the permission to publish into your registry.
Utilize the parameters in sfpowercripts:orchestrator:publish and provide the npmrc file along with activating npm
"npm": Upload artifacts to a pre-authenticated private npm registry"scope": (required for NPM) User or Organisation scope of the NPM package"npmtag": Add an optional distribution tag to NPM packages. If not providedthe 'latest' tag is set to the published version"npmrcpath": Path to .npmrc file used for authentication to registry.If left blank, defaults to home directory
You will need to provide a publishing script as a hook to the sfpowerscripts publish command. This will be in turn utilized by sfpowerscripts to publish package to the registry.
We pass through cetrain parameters to your script, which expose the name and version of the package being published, the file path of the artifact and whether the
publishpromoteonlyflag was passed to the command. With the information available through these parameters, push the artifact to the registry using your vendor's API.
Example for Linux / MacOS
# $1 package name# $2 package version# $3 artifact file path# $4 isPublishPromotedOnlymyvendor artifacts push --name $1 --version $2 --path $3
--publishpromotedonlyflag is specified, only packages that have been promoted will be published to the registry.