@salesforce/plugin-devops-center 2.0.0 → 2.1.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +170 -44
- package/lib/commands/devops/pipeline/create.d.ts +1 -1
- package/lib/commands/devops/pipeline/create.js +5 -4
- package/lib/commands/devops/pipeline/create.js.map +1 -1
- package/lib/commands/devops/pipeline/stage/update.d.ts +19 -0
- package/lib/commands/devops/pipeline/stage/update.js +66 -0
- package/lib/commands/devops/pipeline/stage/update.js.map +1 -0
- package/lib/commands/devops/pipeline/update.d.ts +2 -1
- package/lib/commands/devops/pipeline/update.js +10 -4
- package/lib/commands/devops/pipeline/update.js.map +1 -1
- package/lib/commands/devops/promote.d.ts +5 -0
- package/lib/commands/devops/promote.js +49 -3
- package/lib/commands/devops/promote.js.map +1 -1
- package/lib/commands/devops/promotion/complete.d.ts +1 -1
- package/lib/commands/devops/promotion/complete.js +1 -1
- package/lib/commands/devops/promotion/complete.js.map +1 -1
- package/lib/commands/devops/promotion/validate.d.ts +21 -0
- package/lib/commands/devops/promotion/validate.js +137 -0
- package/lib/commands/devops/promotion/validate.js.map +1 -0
- package/lib/commands/devops/stage/branch/delete.d.ts +15 -0
- package/lib/commands/devops/stage/branch/delete.js +107 -0
- package/lib/commands/devops/stage/branch/delete.js.map +1 -0
- package/lib/commands/devops/work-item/prepare.js +0 -3
- package/lib/commands/devops/work-item/prepare.js.map +1 -1
- package/lib/utils/addPipelineStage.js +1 -0
- package/lib/utils/addPipelineStage.js.map +1 -1
- package/lib/utils/createPipeline.d.ts +1 -2
- package/lib/utils/createPipeline.js +28 -19
- package/lib/utils/createPipeline.js.map +1 -1
- package/lib/utils/deleteStageBranch.d.ts +22 -0
- package/lib/utils/deleteStageBranch.js +44 -0
- package/lib/utils/deleteStageBranch.js.map +1 -0
- package/lib/utils/pipelineUtils.d.ts +9 -0
- package/lib/utils/pipelineUtils.js +32 -0
- package/lib/utils/pipelineUtils.js.map +1 -1
- package/lib/utils/prepareWorkItem.d.ts +1 -1
- package/lib/utils/prepareWorkItem.js +4 -5
- package/lib/utils/prepareWorkItem.js.map +1 -1
- package/lib/utils/{deployStage.d.ts → promotionUtils.d.ts} +24 -0
- package/lib/utils/{deployStage.js → promotionUtils.js} +65 -1
- package/lib/utils/promotionUtils.js.map +1 -0
- package/lib/utils/soqlUtils.d.ts +5 -0
- package/lib/utils/soqlUtils.js +7 -0
- package/lib/utils/soqlUtils.js.map +1 -1
- package/messages/devops.pipeline.create.md +11 -7
- package/messages/devops.pipeline.stage.update.md +25 -0
- package/messages/devops.pipeline.update.md +10 -6
- package/messages/devops.promote.md +16 -0
- package/messages/devops.promotion.complete.md +3 -3
- package/messages/devops.promotion.validate.md +64 -0
- package/messages/devops.stage.branch.delete.md +37 -0
- package/npm-shrinkwrap.json +2 -2
- package/oclif.manifest.json +324 -72
- package/package.json +3 -3
- package/schemas/devops-pipeline-create.json +0 -3
- package/schemas/devops-pipeline-stage-update.json +22 -0
- package/schemas/devops-promote.json +38 -0
- package/schemas/devops-promotion-validate.json +66 -0
- package/schemas/devops-stage-branch-delete.json +47 -0
- package/lib/utils/deployStage.js.map +0 -1
package/oclif.manifest.json
CHANGED
|
@@ -107,6 +107,12 @@
|
|
|
107
107
|
"hasDynamicHelp": false,
|
|
108
108
|
"multiple": true,
|
|
109
109
|
"type": "option"
|
|
110
|
+
},
|
|
111
|
+
"skip-validation": {
|
|
112
|
+
"name": "skip-validation",
|
|
113
|
+
"summary": "Skip pre-promote validation. By default, promotion is validated before proceeding to prevent promoting work items without an associated PR. Use this flag to bypass validation.",
|
|
114
|
+
"allowNo": false,
|
|
115
|
+
"type": "boolean"
|
|
110
116
|
}
|
|
111
117
|
},
|
|
112
118
|
"hasDynamicHelp": true,
|
|
@@ -131,10 +137,11 @@
|
|
|
131
137
|
"args": {},
|
|
132
138
|
"description": "Provide the URL of an existing repository, or use `--create-repo` with a repository name to create one. After you create the pipeline, add stages, and activate the pipeline.",
|
|
133
139
|
"examples": [
|
|
134
|
-
"Create a pipeline and associate it with an existing GitHub repository
|
|
135
|
-
"Create a pipeline and associate it with a new GitHub repository
|
|
136
|
-
"Create a pipeline and create a new Bitbucket repository
|
|
137
|
-
"Create a pipeline
|
|
140
|
+
"Create a pipeline and associate it with an existing GitHub repository:\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --name \"Release Pipeline\" --repo https://github.com/myorg/myrepo",
|
|
141
|
+
"Create a pipeline and associate it with a new GitHub repository:\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --name \"Release Pipeline\" --repo my-new-repo --repo-type github --repo-owner myorg --create-repo",
|
|
142
|
+
"Create a pipeline and create a new Bitbucket repository:\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --name \"Release Pipeline\" --repo my-new-repo --repo-type bitbucket --bitbucket-workspace myworkspace --bitbucket-project-key PROJ --create-repo",
|
|
143
|
+
"Create a pipeline and associate it with an existing Bitbucket repository:\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --name \"Release Pipeline\" --repo https://bitbucket.org/myworkspace/myrepo",
|
|
144
|
+
"Create a pipeline with custom stage names instead of the default stages:\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --name \"Release Pipeline\" --repo https://github.com/myorg/myrepo --stage Dev --stage QA --stage Prod"
|
|
138
145
|
],
|
|
139
146
|
"flags": {
|
|
140
147
|
"json": {
|
|
@@ -225,12 +232,12 @@
|
|
|
225
232
|
"multiple": false,
|
|
226
233
|
"type": "option"
|
|
227
234
|
},
|
|
228
|
-
"
|
|
229
|
-
"char": "
|
|
230
|
-
"name": "
|
|
231
|
-
"summary": "
|
|
235
|
+
"stage": {
|
|
236
|
+
"char": "s",
|
|
237
|
+
"name": "stage",
|
|
238
|
+
"summary": "Name of a pipeline stage, in promotion order. Repeat the flag for each stage. Defaults to Integration, UAT, Staging, and Production.",
|
|
232
239
|
"hasDynamicHelp": false,
|
|
233
|
-
"multiple":
|
|
240
|
+
"multiple": true,
|
|
234
241
|
"type": "option"
|
|
235
242
|
}
|
|
236
243
|
},
|
|
@@ -382,10 +389,10 @@
|
|
|
382
389
|
"devops:pipeline:update": {
|
|
383
390
|
"aliases": [],
|
|
384
391
|
"args": {},
|
|
385
|
-
"description": "Activate, deactivate, or rename a DevOps Center pipeline. Use --
|
|
392
|
+
"description": "Activate, deactivate, or rename a DevOps Center pipeline. Use --activate to activate, --deactivate to deactivate, and --name to rename. You can combine --deactivate and --name in one command.\n\nA pipeline must have at least one stage before you can activate it. You can't modify the pipeline stages after you activate and promote changes through it.",
|
|
386
393
|
"examples": [
|
|
387
|
-
"Activate a pipeline:\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --pipeline-id 0XB000000000001 --
|
|
388
|
-
"Deactivate and rename in one step.\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --pipeline-id 0XB000000000001 --
|
|
394
|
+
"Activate a pipeline:\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --pipeline-id 0XB000000000001 --activate",
|
|
395
|
+
"Deactivate and rename in one step.\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --pipeline-id 0XB000000000001 --deactivate --name \"My Pipeline\""
|
|
389
396
|
],
|
|
390
397
|
"flags": {
|
|
391
398
|
"json": {
|
|
@@ -428,11 +435,24 @@
|
|
|
428
435
|
"multiple": false,
|
|
429
436
|
"type": "option"
|
|
430
437
|
},
|
|
431
|
-
"
|
|
432
|
-
"
|
|
438
|
+
"activate": {
|
|
439
|
+
"exclusive": [
|
|
440
|
+
"deactivate"
|
|
441
|
+
],
|
|
442
|
+
"name": "activate",
|
|
433
443
|
"required": false,
|
|
434
|
-
"summary": "Activate the pipeline.
|
|
435
|
-
"allowNo":
|
|
444
|
+
"summary": "Activate the pipeline. Can't be used with --deactivate.",
|
|
445
|
+
"allowNo": false,
|
|
446
|
+
"type": "boolean"
|
|
447
|
+
},
|
|
448
|
+
"deactivate": {
|
|
449
|
+
"exclusive": [
|
|
450
|
+
"activate"
|
|
451
|
+
],
|
|
452
|
+
"name": "deactivate",
|
|
453
|
+
"required": false,
|
|
454
|
+
"summary": "Deactivate the pipeline. Can't be used with --activate.",
|
|
455
|
+
"allowNo": false,
|
|
436
456
|
"type": "boolean"
|
|
437
457
|
},
|
|
438
458
|
"name": {
|
|
@@ -698,9 +718,9 @@
|
|
|
698
718
|
"args": {},
|
|
699
719
|
"description": "Deploys work items that were merged into the pipeline branch outside of DevOps Center (externally merged) into the target stage org and updates DevOps Center records. Equivalent to the \"Complete Promotion\" action in the DevOps Center UI when a stage is out of sync.\n\nIf no undeployed work items are found for the stage, the command exits successfully with no action taken.",
|
|
700
720
|
"examples": [
|
|
701
|
-
"Complete a promotion for an out-of-sync pipeline stage
|
|
702
|
-
"Complete a promotion for a specific work item (e.g. first stage of a pipeline)
|
|
703
|
-
"Complete a promotion with full deploy and a specific test level
|
|
721
|
+
"Complete a promotion for an out-of-sync pipeline stage:\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --target-stage-id 1QV000000000001",
|
|
722
|
+
"Complete a promotion for a specific work item (e.g. first stage of a pipeline):\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --target-stage-id 1QV000000000001 --work-item-id 1fk000000000001",
|
|
723
|
+
"Complete a promotion with full deploy and a specific test level:\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --target-stage-id 1QV000000000001 --deploy-all --test-level RunLocalTests"
|
|
704
724
|
],
|
|
705
725
|
"flags": {
|
|
706
726
|
"json": {
|
|
@@ -803,6 +823,84 @@
|
|
|
803
823
|
"complete.js"
|
|
804
824
|
]
|
|
805
825
|
},
|
|
826
|
+
"devops:promotion:validate": {
|
|
827
|
+
"aliases": [],
|
|
828
|
+
"args": {},
|
|
829
|
+
"description": "Validates whether the specified work items can be promoted to the target pipeline stage. Checks for VCS and object permission errors before a promotion is attempted.",
|
|
830
|
+
"examples": [
|
|
831
|
+
"Validate promotion of a work item to a target stage:\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --target-stage-id 1QV000000000001 --work-item-id 1fk000000000001",
|
|
832
|
+
"Validate promotion of multiple work items:\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --target-stage-id 1QV000000000001 --work-item-id 1fk000000000001 --work-item-id 1fk000000000002"
|
|
833
|
+
],
|
|
834
|
+
"flags": {
|
|
835
|
+
"json": {
|
|
836
|
+
"description": "Format output as json.",
|
|
837
|
+
"helpGroup": "GLOBAL",
|
|
838
|
+
"name": "json",
|
|
839
|
+
"allowNo": false,
|
|
840
|
+
"type": "boolean"
|
|
841
|
+
},
|
|
842
|
+
"flags-dir": {
|
|
843
|
+
"helpGroup": "GLOBAL",
|
|
844
|
+
"name": "flags-dir",
|
|
845
|
+
"summary": "Import flag values from a directory.",
|
|
846
|
+
"hasDynamicHelp": false,
|
|
847
|
+
"multiple": false,
|
|
848
|
+
"type": "option"
|
|
849
|
+
},
|
|
850
|
+
"target-org": {
|
|
851
|
+
"char": "o",
|
|
852
|
+
"name": "target-org",
|
|
853
|
+
"noCacheDefault": true,
|
|
854
|
+
"required": true,
|
|
855
|
+
"summary": "Username or alias of the target org. Not required if the `target-org` configuration variable is already set.",
|
|
856
|
+
"hasDynamicHelp": true,
|
|
857
|
+
"multiple": false,
|
|
858
|
+
"type": "option"
|
|
859
|
+
},
|
|
860
|
+
"api-version": {
|
|
861
|
+
"description": "Override the api version used for api requests made by this command",
|
|
862
|
+
"name": "api-version",
|
|
863
|
+
"hasDynamicHelp": false,
|
|
864
|
+
"multiple": false,
|
|
865
|
+
"type": "option"
|
|
866
|
+
},
|
|
867
|
+
"target-stage-id": {
|
|
868
|
+
"char": "t",
|
|
869
|
+
"name": "target-stage-id",
|
|
870
|
+
"required": true,
|
|
871
|
+
"summary": "ID of the target pipeline stage to validate promotion to.",
|
|
872
|
+
"hasDynamicHelp": false,
|
|
873
|
+
"multiple": false,
|
|
874
|
+
"type": "option"
|
|
875
|
+
},
|
|
876
|
+
"work-item-id": {
|
|
877
|
+
"char": "i",
|
|
878
|
+
"name": "work-item-id",
|
|
879
|
+
"required": true,
|
|
880
|
+
"summary": "ID of a work item to validate for promotion. Specify multiple times for multiple work items.",
|
|
881
|
+
"hasDynamicHelp": false,
|
|
882
|
+
"multiple": true,
|
|
883
|
+
"type": "option"
|
|
884
|
+
}
|
|
885
|
+
},
|
|
886
|
+
"hasDynamicHelp": true,
|
|
887
|
+
"hiddenAliases": [],
|
|
888
|
+
"id": "devops:promotion:validate",
|
|
889
|
+
"pluginAlias": "@salesforce/plugin-devops-center",
|
|
890
|
+
"pluginName": "@salesforce/plugin-devops-center",
|
|
891
|
+
"pluginType": "core",
|
|
892
|
+
"strict": true,
|
|
893
|
+
"summary": "Validate work item promotion for a pipeline stage.",
|
|
894
|
+
"enableJsonFlag": true,
|
|
895
|
+
"isESM": true,
|
|
896
|
+
"relativePath": [
|
|
897
|
+
"lib",
|
|
898
|
+
"commands",
|
|
899
|
+
"devops",
|
|
900
|
+
"promotion",
|
|
901
|
+
"validate.js"
|
|
902
|
+
]
|
|
903
|
+
},
|
|
806
904
|
"devops:request:status": {
|
|
807
905
|
"aliases": [],
|
|
808
906
|
"args": {},
|
|
@@ -1682,12 +1780,12 @@
|
|
|
1682
1780
|
"delete.js"
|
|
1683
1781
|
]
|
|
1684
1782
|
},
|
|
1685
|
-
"devops:stage:
|
|
1783
|
+
"devops:pipeline:stage:update": {
|
|
1686
1784
|
"aliases": [],
|
|
1687
1785
|
"args": {},
|
|
1688
|
-
"description": "
|
|
1786
|
+
"description": "Updates the name of a pipeline stage.",
|
|
1689
1787
|
"examples": [
|
|
1690
|
-
"
|
|
1788
|
+
"Rename a pipeline stage.\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --stage-id 1QV000000000001 --name \"Integration\""
|
|
1691
1789
|
],
|
|
1692
1790
|
"flags": {
|
|
1693
1791
|
"json": {
|
|
@@ -1722,58 +1820,125 @@
|
|
|
1722
1820
|
"multiple": false,
|
|
1723
1821
|
"type": "option"
|
|
1724
1822
|
},
|
|
1725
|
-
"
|
|
1726
|
-
"
|
|
1823
|
+
"stage-id": {
|
|
1824
|
+
"char": "s",
|
|
1825
|
+
"name": "stage-id",
|
|
1727
1826
|
"required": true,
|
|
1728
|
-
"summary": "ID of the pipeline
|
|
1827
|
+
"summary": "ID of the pipeline stage to update.",
|
|
1729
1828
|
"hasDynamicHelp": false,
|
|
1730
1829
|
"multiple": false,
|
|
1731
1830
|
"type": "option"
|
|
1732
1831
|
},
|
|
1733
|
-
"
|
|
1734
|
-
"
|
|
1832
|
+
"name": {
|
|
1833
|
+
"char": "n",
|
|
1834
|
+
"name": "name",
|
|
1735
1835
|
"required": true,
|
|
1736
|
-
"summary": "
|
|
1836
|
+
"summary": "New name for the pipeline stage.",
|
|
1737
1837
|
"hasDynamicHelp": false,
|
|
1738
1838
|
"multiple": false,
|
|
1739
1839
|
"type": "option"
|
|
1840
|
+
}
|
|
1841
|
+
},
|
|
1842
|
+
"hasDynamicHelp": true,
|
|
1843
|
+
"hiddenAliases": [],
|
|
1844
|
+
"id": "devops:pipeline:stage:update",
|
|
1845
|
+
"pluginAlias": "@salesforce/plugin-devops-center",
|
|
1846
|
+
"pluginName": "@salesforce/plugin-devops-center",
|
|
1847
|
+
"pluginType": "core",
|
|
1848
|
+
"strict": true,
|
|
1849
|
+
"summary": "Update a DevOps Center pipeline stage.",
|
|
1850
|
+
"enableJsonFlag": true,
|
|
1851
|
+
"isESM": true,
|
|
1852
|
+
"relativePath": [
|
|
1853
|
+
"lib",
|
|
1854
|
+
"commands",
|
|
1855
|
+
"devops",
|
|
1856
|
+
"pipeline",
|
|
1857
|
+
"stage",
|
|
1858
|
+
"update.js"
|
|
1859
|
+
]
|
|
1860
|
+
},
|
|
1861
|
+
"devops:stage:branch:add": {
|
|
1862
|
+
"aliases": [],
|
|
1863
|
+
"args": {},
|
|
1864
|
+
"description": "By default, the branch must exist in the repository. Use --create-vcs-branch to create a branch if it doesn't exist.\nEach pipeline stage supports only one branch. Adding a branch replaces any existing branch linked to the pipeline stage.",
|
|
1865
|
+
"examples": [
|
|
1866
|
+
"Add an existing branch to a stage:\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --pipeline-id 0Xo000000000001 --stage-id 0Xp000000000001 --branch-name main",
|
|
1867
|
+
"Create and add a branch to a pipeline stage:\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --pipeline-id 0Xo000000000001 --stage-id 0Xp000000000002 --branch-name integration --create-vcs-branch"
|
|
1868
|
+
],
|
|
1869
|
+
"flags": {
|
|
1870
|
+
"json": {
|
|
1871
|
+
"description": "Format output as json.",
|
|
1872
|
+
"helpGroup": "GLOBAL",
|
|
1873
|
+
"name": "json",
|
|
1874
|
+
"allowNo": false,
|
|
1875
|
+
"type": "boolean"
|
|
1740
1876
|
},
|
|
1741
|
-
"
|
|
1742
|
-
"
|
|
1743
|
-
"name": "
|
|
1877
|
+
"flags-dir": {
|
|
1878
|
+
"helpGroup": "GLOBAL",
|
|
1879
|
+
"name": "flags-dir",
|
|
1880
|
+
"summary": "Import flag values from a directory.",
|
|
1881
|
+
"hasDynamicHelp": false,
|
|
1882
|
+
"multiple": false,
|
|
1883
|
+
"type": "option"
|
|
1884
|
+
},
|
|
1885
|
+
"target-org": {
|
|
1886
|
+
"char": "o",
|
|
1887
|
+
"name": "target-org",
|
|
1888
|
+
"noCacheDefault": true,
|
|
1744
1889
|
"required": true,
|
|
1745
|
-
"summary": "
|
|
1890
|
+
"summary": "Username or alias of the target org. Not required if the `target-org` configuration variable is already set.",
|
|
1891
|
+
"hasDynamicHelp": true,
|
|
1892
|
+
"multiple": false,
|
|
1893
|
+
"type": "option"
|
|
1894
|
+
},
|
|
1895
|
+
"api-version": {
|
|
1896
|
+
"description": "Override the api version used for api requests made by this command",
|
|
1897
|
+
"name": "api-version",
|
|
1746
1898
|
"hasDynamicHelp": false,
|
|
1747
1899
|
"multiple": false,
|
|
1748
1900
|
"type": "option"
|
|
1749
1901
|
},
|
|
1750
|
-
"
|
|
1751
|
-
"name": "
|
|
1902
|
+
"pipeline-id": {
|
|
1903
|
+
"name": "pipeline-id",
|
|
1752
1904
|
"required": true,
|
|
1753
|
-
"summary": "
|
|
1905
|
+
"summary": "ID of the pipeline that contains the stage.",
|
|
1754
1906
|
"hasDynamicHelp": false,
|
|
1755
1907
|
"multiple": false,
|
|
1756
|
-
"options": [
|
|
1757
|
-
"Production",
|
|
1758
|
-
"Sandbox"
|
|
1759
|
-
],
|
|
1760
1908
|
"type": "option"
|
|
1761
1909
|
},
|
|
1762
|
-
"
|
|
1763
|
-
"name": "
|
|
1764
|
-
"
|
|
1910
|
+
"stage-id": {
|
|
1911
|
+
"name": "stage-id",
|
|
1912
|
+
"required": true,
|
|
1913
|
+
"summary": "ID of the pipeline stage to associate the branch with.",
|
|
1914
|
+
"hasDynamicHelp": false,
|
|
1915
|
+
"multiple": false,
|
|
1916
|
+
"type": "option"
|
|
1917
|
+
},
|
|
1918
|
+
"branch-name": {
|
|
1919
|
+
"char": "b",
|
|
1920
|
+
"name": "branch-name",
|
|
1921
|
+
"required": true,
|
|
1922
|
+
"summary": "Name of the repository branch to assign to the stage.",
|
|
1923
|
+
"hasDynamicHelp": false,
|
|
1924
|
+
"multiple": false,
|
|
1925
|
+
"type": "option"
|
|
1926
|
+
},
|
|
1927
|
+
"create-vcs-branch": {
|
|
1928
|
+
"name": "create-vcs-branch",
|
|
1929
|
+
"summary": "Create the branch in the remote repository if it doesn't already exist.",
|
|
1765
1930
|
"allowNo": false,
|
|
1766
1931
|
"type": "boolean"
|
|
1767
1932
|
}
|
|
1768
1933
|
},
|
|
1769
1934
|
"hasDynamicHelp": true,
|
|
1770
1935
|
"hiddenAliases": [],
|
|
1771
|
-
"id": "devops:stage:
|
|
1936
|
+
"id": "devops:stage:branch:add",
|
|
1772
1937
|
"pluginAlias": "@salesforce/plugin-devops-center",
|
|
1773
1938
|
"pluginName": "@salesforce/plugin-devops-center",
|
|
1774
1939
|
"pluginType": "core",
|
|
1775
1940
|
"strict": true,
|
|
1776
|
-
"summary": "Add a
|
|
1941
|
+
"summary": "Add a source code repository branch to a pipeline stage.",
|
|
1777
1942
|
"enableJsonFlag": true,
|
|
1778
1943
|
"isESM": true,
|
|
1779
1944
|
"relativePath": [
|
|
@@ -1781,16 +1946,16 @@
|
|
|
1781
1946
|
"commands",
|
|
1782
1947
|
"devops",
|
|
1783
1948
|
"stage",
|
|
1784
|
-
"
|
|
1949
|
+
"branch",
|
|
1785
1950
|
"add.js"
|
|
1786
1951
|
]
|
|
1787
1952
|
},
|
|
1788
|
-
"devops:stage:
|
|
1953
|
+
"devops:stage:branch:delete": {
|
|
1789
1954
|
"aliases": [],
|
|
1790
1955
|
"args": {},
|
|
1791
|
-
"description": "Removes the specified
|
|
1956
|
+
"description": "Removes the branch linked to the specified pipeline stage. Because branches are configured from right to left (a stage can have a branch only after the stage to its right does), removing a branch also removes the branches from all upstream stages (to the left) in the pipeline, keeping it in a valid state. The branch records in the repository are not deleted; only their association with the stages is removed. The stage must belong to an inactive pipeline.",
|
|
1792
1957
|
"examples": [
|
|
1793
|
-
"Delete
|
|
1958
|
+
"Delete the branch associated with a pipeline stage:\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --pipeline-id 0Xo000000000001 --stage-id 0Xp000000000001"
|
|
1794
1959
|
],
|
|
1795
1960
|
"flags": {
|
|
1796
1961
|
"json": {
|
|
@@ -1828,16 +1993,15 @@
|
|
|
1828
1993
|
"pipeline-id": {
|
|
1829
1994
|
"name": "pipeline-id",
|
|
1830
1995
|
"required": true,
|
|
1831
|
-
"summary": "ID of the pipeline. Used to verify the pipeline is inactive before deleting.",
|
|
1996
|
+
"summary": "ID of the pipeline that contains the stage. Used to verify the pipeline is inactive before deleting.",
|
|
1832
1997
|
"hasDynamicHelp": false,
|
|
1833
1998
|
"multiple": false,
|
|
1834
1999
|
"type": "option"
|
|
1835
2000
|
},
|
|
1836
|
-
"
|
|
1837
|
-
"
|
|
1838
|
-
"name": "environment-id",
|
|
2001
|
+
"stage-id": {
|
|
2002
|
+
"name": "stage-id",
|
|
1839
2003
|
"required": true,
|
|
1840
|
-
"summary": "ID of the
|
|
2004
|
+
"summary": "ID of the pipeline stage whose branch you want to delete.",
|
|
1841
2005
|
"hasDynamicHelp": false,
|
|
1842
2006
|
"multiple": false,
|
|
1843
2007
|
"type": "option"
|
|
@@ -1845,12 +2009,12 @@
|
|
|
1845
2009
|
},
|
|
1846
2010
|
"hasDynamicHelp": true,
|
|
1847
2011
|
"hiddenAliases": [],
|
|
1848
|
-
"id": "devops:stage:
|
|
2012
|
+
"id": "devops:stage:branch:delete",
|
|
1849
2013
|
"pluginAlias": "@salesforce/plugin-devops-center",
|
|
1850
2014
|
"pluginName": "@salesforce/plugin-devops-center",
|
|
1851
2015
|
"pluginType": "core",
|
|
1852
2016
|
"strict": true,
|
|
1853
|
-
"summary": "Delete
|
|
2017
|
+
"summary": "Delete the source code repository branch associated with a pipeline stage.",
|
|
1854
2018
|
"enableJsonFlag": true,
|
|
1855
2019
|
"isESM": true,
|
|
1856
2020
|
"relativePath": [
|
|
@@ -1858,17 +2022,16 @@
|
|
|
1858
2022
|
"commands",
|
|
1859
2023
|
"devops",
|
|
1860
2024
|
"stage",
|
|
1861
|
-
"
|
|
2025
|
+
"branch",
|
|
1862
2026
|
"delete.js"
|
|
1863
2027
|
]
|
|
1864
2028
|
},
|
|
1865
|
-
"devops:stage:
|
|
2029
|
+
"devops:stage:environment:add": {
|
|
1866
2030
|
"aliases": [],
|
|
1867
2031
|
"args": {},
|
|
1868
|
-
"description": "
|
|
2032
|
+
"description": "This command triggers an OAuth flow to authenticate the environment. A browser window opens automatically for you to log in.",
|
|
1869
2033
|
"examples": [
|
|
1870
|
-
"Add
|
|
1871
|
-
"Create and add a branch to a pipeline stage:\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --pipeline-id 0Xo000000000001 --stage-id 0Xp000000000002 --branch-name integration --create-vcs-branch"
|
|
2034
|
+
"Add a production environment to a stage using its ID:\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --stage-id 0Xp000000000001 --environment-name Production_Org --org-type Production"
|
|
1872
2035
|
],
|
|
1873
2036
|
"flags": {
|
|
1874
2037
|
"json": {
|
|
@@ -1914,35 +2077,47 @@
|
|
|
1914
2077
|
"stage-id": {
|
|
1915
2078
|
"name": "stage-id",
|
|
1916
2079
|
"required": true,
|
|
1917
|
-
"summary": "ID of the pipeline stage
|
|
2080
|
+
"summary": "ID of the pipeline stage.",
|
|
1918
2081
|
"hasDynamicHelp": false,
|
|
1919
2082
|
"multiple": false,
|
|
1920
2083
|
"type": "option"
|
|
1921
2084
|
},
|
|
1922
|
-
"
|
|
1923
|
-
"char": "
|
|
1924
|
-
"name": "
|
|
2085
|
+
"environment-name": {
|
|
2086
|
+
"char": "e",
|
|
2087
|
+
"name": "environment-name",
|
|
1925
2088
|
"required": true,
|
|
1926
|
-
"summary": "Name of the
|
|
2089
|
+
"summary": "Name of the environment.",
|
|
1927
2090
|
"hasDynamicHelp": false,
|
|
1928
2091
|
"multiple": false,
|
|
1929
2092
|
"type": "option"
|
|
1930
2093
|
},
|
|
1931
|
-
"
|
|
1932
|
-
"name": "
|
|
1933
|
-
"
|
|
2094
|
+
"org-type": {
|
|
2095
|
+
"name": "org-type",
|
|
2096
|
+
"required": true,
|
|
2097
|
+
"summary": "Type of the Salesforce org. Valid values: Production, Sandbox.",
|
|
2098
|
+
"hasDynamicHelp": false,
|
|
2099
|
+
"multiple": false,
|
|
2100
|
+
"options": [
|
|
2101
|
+
"Production",
|
|
2102
|
+
"Sandbox"
|
|
2103
|
+
],
|
|
2104
|
+
"type": "option"
|
|
2105
|
+
},
|
|
2106
|
+
"no-browser": {
|
|
2107
|
+
"name": "no-browser",
|
|
2108
|
+
"summary": "Don't auto-open the browser for OAuth authentication. The redirect URL is printed for manual use.",
|
|
1934
2109
|
"allowNo": false,
|
|
1935
2110
|
"type": "boolean"
|
|
1936
2111
|
}
|
|
1937
2112
|
},
|
|
1938
2113
|
"hasDynamicHelp": true,
|
|
1939
2114
|
"hiddenAliases": [],
|
|
1940
|
-
"id": "devops:stage:
|
|
2115
|
+
"id": "devops:stage:environment:add",
|
|
1941
2116
|
"pluginAlias": "@salesforce/plugin-devops-center",
|
|
1942
2117
|
"pluginName": "@salesforce/plugin-devops-center",
|
|
1943
2118
|
"pluginType": "core",
|
|
1944
2119
|
"strict": true,
|
|
1945
|
-
"summary": "Add a
|
|
2120
|
+
"summary": "Add a Salesforce environment to a pipeline stage.",
|
|
1946
2121
|
"enableJsonFlag": true,
|
|
1947
2122
|
"isESM": true,
|
|
1948
2123
|
"relativePath": [
|
|
@@ -1950,10 +2125,87 @@
|
|
|
1950
2125
|
"commands",
|
|
1951
2126
|
"devops",
|
|
1952
2127
|
"stage",
|
|
1953
|
-
"
|
|
2128
|
+
"environment",
|
|
1954
2129
|
"add.js"
|
|
1955
2130
|
]
|
|
1956
2131
|
},
|
|
2132
|
+
"devops:stage:environment:delete": {
|
|
2133
|
+
"aliases": [],
|
|
2134
|
+
"args": {},
|
|
2135
|
+
"description": "Removes the specified environment from the pipeline stage. The environment must belong to an inactive pipeline.",
|
|
2136
|
+
"examples": [
|
|
2137
|
+
"Delete an environment:\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --pipeline-id 0XB000000000001 --environment-id 0Xe000000000001"
|
|
2138
|
+
],
|
|
2139
|
+
"flags": {
|
|
2140
|
+
"json": {
|
|
2141
|
+
"description": "Format output as json.",
|
|
2142
|
+
"helpGroup": "GLOBAL",
|
|
2143
|
+
"name": "json",
|
|
2144
|
+
"allowNo": false,
|
|
2145
|
+
"type": "boolean"
|
|
2146
|
+
},
|
|
2147
|
+
"flags-dir": {
|
|
2148
|
+
"helpGroup": "GLOBAL",
|
|
2149
|
+
"name": "flags-dir",
|
|
2150
|
+
"summary": "Import flag values from a directory.",
|
|
2151
|
+
"hasDynamicHelp": false,
|
|
2152
|
+
"multiple": false,
|
|
2153
|
+
"type": "option"
|
|
2154
|
+
},
|
|
2155
|
+
"target-org": {
|
|
2156
|
+
"char": "o",
|
|
2157
|
+
"name": "target-org",
|
|
2158
|
+
"noCacheDefault": true,
|
|
2159
|
+
"required": true,
|
|
2160
|
+
"summary": "Username or alias of the target org. Not required if the `target-org` configuration variable is already set.",
|
|
2161
|
+
"hasDynamicHelp": true,
|
|
2162
|
+
"multiple": false,
|
|
2163
|
+
"type": "option"
|
|
2164
|
+
},
|
|
2165
|
+
"api-version": {
|
|
2166
|
+
"description": "Override the api version used for api requests made by this command",
|
|
2167
|
+
"name": "api-version",
|
|
2168
|
+
"hasDynamicHelp": false,
|
|
2169
|
+
"multiple": false,
|
|
2170
|
+
"type": "option"
|
|
2171
|
+
},
|
|
2172
|
+
"pipeline-id": {
|
|
2173
|
+
"name": "pipeline-id",
|
|
2174
|
+
"required": true,
|
|
2175
|
+
"summary": "ID of the pipeline. Used to verify the pipeline is inactive before deleting.",
|
|
2176
|
+
"hasDynamicHelp": false,
|
|
2177
|
+
"multiple": false,
|
|
2178
|
+
"type": "option"
|
|
2179
|
+
},
|
|
2180
|
+
"environment-id": {
|
|
2181
|
+
"char": "e",
|
|
2182
|
+
"name": "environment-id",
|
|
2183
|
+
"required": true,
|
|
2184
|
+
"summary": "ID of the environment to delete.",
|
|
2185
|
+
"hasDynamicHelp": false,
|
|
2186
|
+
"multiple": false,
|
|
2187
|
+
"type": "option"
|
|
2188
|
+
}
|
|
2189
|
+
},
|
|
2190
|
+
"hasDynamicHelp": true,
|
|
2191
|
+
"hiddenAliases": [],
|
|
2192
|
+
"id": "devops:stage:environment:delete",
|
|
2193
|
+
"pluginAlias": "@salesforce/plugin-devops-center",
|
|
2194
|
+
"pluginName": "@salesforce/plugin-devops-center",
|
|
2195
|
+
"pluginType": "core",
|
|
2196
|
+
"strict": true,
|
|
2197
|
+
"summary": "Delete an environment from a DevOps Center pipeline stage.",
|
|
2198
|
+
"enableJsonFlag": true,
|
|
2199
|
+
"isESM": true,
|
|
2200
|
+
"relativePath": [
|
|
2201
|
+
"lib",
|
|
2202
|
+
"commands",
|
|
2203
|
+
"devops",
|
|
2204
|
+
"stage",
|
|
2205
|
+
"environment",
|
|
2206
|
+
"delete.js"
|
|
2207
|
+
]
|
|
2208
|
+
},
|
|
1957
2209
|
"project:deploy:pipeline:quick": {
|
|
1958
2210
|
"aliases": [],
|
|
1959
2211
|
"args": {},
|
|
@@ -2531,5 +2783,5 @@
|
|
|
2531
2783
|
]
|
|
2532
2784
|
}
|
|
2533
2785
|
},
|
|
2534
|
-
"version": "2.
|
|
2786
|
+
"version": "2.1.0"
|
|
2535
2787
|
}
|
package/package.json
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@salesforce/plugin-devops-center",
|
|
3
3
|
"description": "The DevOps Center CLI plugin provides a command-line alternative to performing equivalent actions in the DevOps Center graphical UI",
|
|
4
|
-
"version": "2.
|
|
4
|
+
"version": "2.1.0",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"author": "Salesforce",
|
|
7
7
|
"bugs": "https://github.com/forcedotcom/cli/issues",
|
|
@@ -256,7 +256,7 @@
|
|
|
256
256
|
}
|
|
257
257
|
},
|
|
258
258
|
"sfdx": {
|
|
259
|
-
"publicKeyUrl": "https://developer.salesforce.com/media/salesforce-cli/security/@salesforce/plugin-devops-center/2.
|
|
260
|
-
"signatureUrl": "https://developer.salesforce.com/media/salesforce-cli/security/@salesforce/plugin-devops-center/2.
|
|
259
|
+
"publicKeyUrl": "https://developer.salesforce.com/media/salesforce-cli/security/@salesforce/plugin-devops-center/2.1.0.crt",
|
|
260
|
+
"signatureUrl": "https://developer.salesforce.com/media/salesforce-cli/security/@salesforce/plugin-devops-center/2.1.0.sig"
|
|
261
261
|
}
|
|
262
262
|
}
|
|
@@ -0,0 +1,22 @@
|
|
|
1
|
+
{
|
|
2
|
+
"$schema": "http://json-schema.org/draft-07/schema#",
|
|
3
|
+
"$ref": "#/definitions/PipelineStageUpdateResult",
|
|
4
|
+
"definitions": {
|
|
5
|
+
"PipelineStageUpdateResult": {
|
|
6
|
+
"type": "object",
|
|
7
|
+
"properties": {
|
|
8
|
+
"success": {
|
|
9
|
+
"type": "boolean"
|
|
10
|
+
},
|
|
11
|
+
"stageId": {
|
|
12
|
+
"type": "string"
|
|
13
|
+
},
|
|
14
|
+
"name": {
|
|
15
|
+
"type": "string"
|
|
16
|
+
}
|
|
17
|
+
},
|
|
18
|
+
"required": ["success", "stageId", "name"],
|
|
19
|
+
"additionalProperties": false
|
|
20
|
+
}
|
|
21
|
+
}
|
|
22
|
+
}
|