This task is used to promote an unlocked package to ‘released’ state before deploying it into a production org. You can read more about promoting a package to released status here. It is recommended to utilize this taks in the ‘Prod’ stage in a release pipeline in most normal scenarios, where a tested package in the lower environment is ready to be deployed to production and the version number has to be frozen.
Install SFDX with Sfpowerkit task must be added to the pipeline before utilizing this task.
Name of the package to be promoted / package
The name of the package that is to be promoted to the released state. This name does not have any significant value addition other than being just displayed in the task execution.
Path to the directory where artifacts are downloaded / artifactDir
Path to the artifact directory where the artifacts are downloaded, If not provided, the default values will be automatically used
Project directory / project_directory
The directory containing the
Alias/username of the DevHub / devhub_alias
Provide the alias of the Dev Hub previously authenticated, default value is
HubOrg if using the Authenticate Org task.
Skip if no artifact is found / skip_on_missing_artifact
Enable this option to remove attached artifacts for a specific release, without having to remove the corresponding task from the release pipeline.
steps:- task: [email protected]displayName: 'Promote version of package <mypackage> 'inputs:package: <mypackage>artifact: '_mypackage'project_directory: '$(sfpowerscripts_checked_out_path)'skip_on_missing_artifact: false
8.0.5 Remove "packagepromotedfrom" input parameter #151
7.0.4 Update Core dependency
Removed Telemetry Collection
Add support for Azure Artifacts
4.0.1 Fix for #18 Promote task failing to promote unlocked package
3.0.9 Refactored to use revamped folder structure
2.0.1 Updated with Telemetry
1.6.0 Initial Version