Movatterモバイル変換


[0]ホーム

URL:


Skip to content

Navigation Menu

Sign in
Appearance settings

Search code, repositories, users, issues, pull requests...

Provide feedback

We read every piece of feedback, and take your input very seriously.

Saved searches

Use saved searches to filter your results more quickly

Sign up
Appearance settings

Commite671f8c

Browse files
committed
updated some fields to the pipeline spec
1 parentb4f502a commite671f8c

File tree

1 file changed

+19
-37
lines changed

1 file changed

+19
-37
lines changed

‎_docs/pipelines/specifications.md‎

Lines changed: 19 additions & 37 deletions
Original file line numberDiff line numberDiff line change
@@ -10,65 +10,61 @@ toc: true
1010
##.version
1111

1212
{: .table .table-bordered .table-hover}
13+
1314
| Field| Description| Type| Required/Optional|
1415
| --------------| ----------------------------|-----------| -------------------------|
15-
|`.version`| The version of the pipeline schema and is always set to`1.0`.| string|??|
16+
|`.version`| The version of the pipeline schema and is always set to`'1.0'`.| string|Required|
1617

1718
##.kind
19+
1820
{: .table .table-bordered .table-hover}
21+
1922
| Field| Description| Type| Required/Optional|
2023
| --------------| ----------------------------|-----------| -------------------------|
21-
|`.kind`| The kind object type for the schema and is always set to`pipeline`.| string|??|
24+
|`.kind`| The kind object type for the schema and is always set to`pipeline`.| string|Required|
2225

2326
##.metadata
2427

2528
{: .table .table-bordered .table-hover}
29+
2630
| Field| Description| Type| Required/Optional|
2731
| --------------| ----------------------------|-----------| -------------------------|
28-
|`metadata.id`| The ID of the pipeline.| string|`????'`|
32+
|`metadata.id`| The ID of the pipeline.| string|Optional|
2933
|`metadata.name`| The full path to the pipeline, including the name of the project to which the pipeline belongs, in the format`project_name/pipeline_name`.| string| Required|
3034
|`metadata.shortName`| The name of the pipeline ???.| string| Optional|
3135
|`metadata.revision`| The ???.| integer| Optional|
32-
|`metadata.isPublic`| Determines if public logs are enabled or disabled for the pipeline. By default, public logs are disabled.<br>When set to`true`, clicking the build badge allows all users with access to the pipeline to also view the build logs, even if they are not logged into Codefresh. See[Public build logs]({{site.baseurl}}//docs/pipelines/configuration/build-status/#public-build-logs).| boolean| Optional|
36+
|`metadata.isPublic`| Determines if public logs are enabled or disabled for the pipeline. By default, public logs are disabled.<br>When set to`true`, clicking the build badge allows all users with access to the pipeline to also view the build logs, even if they are not logged into Codefresh. See[Public build logs]({{site.baseurl}}//docs/pipelines/configuration/build-status/#public-build-logs).| boolean| Optional|
3337
|`metadata.description`| A meaningful description of the pipeline. (NIMA: is there a a max limit)| string| Optional|
3438
|`metadata.labels`| The parent object for`metadata.labelKeys` defining the`tags` assigned to the pipeline. ????| object| Optional|
35-
|`metadata.labelKeys`| The tags ????/ is this the same as`tags`? A list of[access control tags]({{site.baseurl}}/docs/administration/account-user-management/access-control/#marking-pipelines-with-policy-attributes) for this pipeline||string| Optional|
39+
|`metadata.labelKeys`| The tags ????/ is this the same as`tags`? A list of[access control tags]({{site.baseurl}}/docs/administration/account-user-management/access-control/#marking-pipelines-with-policy-attributes) for this pipeline| string| Optional|
3640
|`metadata.created_at`| The date and time at which the pipeline was created in the format ????/| date| Optional|
3741
|`metadata.updated_at`| The date and time at which the pipeline YAML was updated, in the format ????/| date| Optional|
3842
|`metadata.accountId`| The ID of the account to which the pipeline belongs. ????/| obejctId| Optional|
3943
|`metadata.originalYamlString`| ?????the full contents of the pipeline editor. Only kept for archival purposes| string| Optional|
4044
|`metadata.projectId`| The ID of the project to which the pipeline belongs.| obejctId| Optional|
4145
|`metadata.project`| The name of the project to which the pipeline belongs.| string| Optional|
42-
|`metadata.template`| ????Determines if the pipeline is available as a template when creating a new pipeline. <br>When set to`true`, the pipeline name is displayed in the Pipeline Template list.| boolean| Optional|
46+
|`metadata.template`| ????Determines if the pipeline is available as a template when creating a new pipeline. <br>When set to`true`, the pipeline name is displayed in the Pipeline Template list.| boolean| Optional|
4347
|`metadata.template.isTemplate`| When set to`true`, the pipeline name is displayed in the Pipeline Template list.| boolean| Optional|
4448
|`metadata.template.generatedFrom`|????? When set to`true`, the pipeline name is displayed in the Pipeline Template list.| boolean| Optional|
45-
|`metadata.executionContextId`| ???The ID of the specific execution context to use for the pipeline to makes API calls to the pipeline.<br>If there are no execution contexts created for the pipeline, the default execution context is used. (NIMA: is this the CF provided one? what are the implications - that it allows all API calls or minimal ones?).<br>See[Pipeline execution context]({{site.baseurl}}/docs/administration/account-user-management/pipeline-execution-context/).| string| Required????|
46-
47-
48-
49-
50-
51-
52-
53-
54-
49+
|`metadata.executionContextId`| ???The ID of the specific execution context to use for the pipeline to makes API calls to the pipeline.<br>If there are no execution contexts created for the pipeline, the default execution context is used. (NIMA: is this the CF provided one? what are the implications - that it allows all API calls or minimal ones?).<br>See[Pipeline execution context]({{site.baseurl}}/docs/administration/account-user-management/pipeline-execution-context/).| string| Optional|
5550

5651
##.spec
5752

5853
{: .table .table-bordered .table-hover}
54+
5955
| Field| Description| Type| Required/Optional|
6056
| --------------| ----------------------------|-----------| -------------------------|
61-
|`spec.scopes`| ???| string|`????'`|
62-
|`spec.scopeSnapshot`| The ID of the pipeline.| string|`????'`|
57+
|`spec.scopes`| ???| string|Optional|
58+
|`spec.scopeSnapshot`| The ID of the pipeline.| string|Optional|
6359
|`spec.permitRestartFromFailedSteps`| Determines if users can restart a failed pipeline from the failed step, instead of from the beginning of the pipeline.<br>When set to`true`, users can restart the pipeline from the failed step. <br>See[Restarting a failed pipeline]({{site.baseurl}}/docs/pipelines/monitoring-pipelines/#restarting-the-pipeline).| boolean| Optional|
6460
|`spec.build_version`| ???| string| Optional|
65-
|`spec.triggers`| The list of Git triggers defined for the pipeline. For details, see[`spec.triggers](#spectriggers).| array|???|
66-
|`spec.cronTriggers`| The list of Cron or timer-based triggers defined for the pipeline. For details, see[`spec.cronTriggers](#speccrontriggers).| array|`????'`|
67-
|`spec.runtimeEnvironment`| The runtime environment selected for the pipeline and its configuration settings such as memory and CPU. For details, see[`spec.runtimeEnvironments](#specruntimeenvironment).| object| Optional??|
61+
|`spec.triggers`| The list of Git triggers defined for the pipeline. For details, see[`spec.triggers](#spectriggers).| array|Optional|
62+
|`spec.cronTriggers`| The list of Cron or timer-based triggers defined for the pipeline. For details, see[`spec.cronTriggers](#speccrontriggers).| array|Optional|
63+
|`spec.runtimeEnvironment`| The runtime environment selected for the pipeline and its configuration settings such as memory and CPU. For details, see[`spec.runtimeEnvironments](#specruntimeenvironment).| object| Optional|
6864
|`spec.lowMemoryWarningThreshold`| The memory-usage threshold for the pipelines build exceeding which to display banner alerts. Useful to get timely warnings and prevent build failures. <br>Can be one of the following:{::nomarkdown}<ul><li><b>WARNING</b>: Displays a banner when memory usage exceeds 70% of the available memory. </li><li><b>CRITICAL</b>: Displays a banner when memory usage exceeds 90% of the available memory. </li><li><b>REACHED_LIMIT</b>: Displays a banner when memory usage exceeds 100% of the available memory. Setting this threshold means that the pipeline build has already failed when the banner is displayed.</li> {:/}See also[Set memory usage threshold for pipeline build]({{site.baseurl}}/docs/pipelines/pipelines/#set-memory-usage-threshold-for-pipeline-build).| string| Optional|
69-
|`spec.packId`|???| string|`????'`|
65+
|`spec.packId`|SAAS Only (`5cd1746617313f468d669013` for Small,`5cd1746717313f468d669014` for Medium,`5cd1746817313f468d669015` for Large,`5cd1746817313f468d669017` for XL,`5cd1746817313f468d669018` for XXL,`5cd1746817313f468d669020` for 4XL)| string|Required for SAAS<br />Optional for Hybrid|
7066
|`spec.requiredAvailableStorage`| ???The minimum disk space for the pipeline’s build volume. <br> When defined, Codefresh assigns either a cached disk with sufficient disk space or a new empty disk at the start of the build. Otherwise, only the space not allocated for caching is available for the build volume. <br>See[Set minimum disk space for a pipeline build]({{site.baseurl}}/docs/pipelines/pipelines/#set-minimum-disk-space-for-a-pipeline-build). (NIMA: is there a default min and max? is it the same as the UI?)| string| Optional|
71-
|`spec.contexts`|?? The The IDof the pipeline.|string|`????'`|
67+
|`spec.contexts`|A list of strings representing the namesofthat[shared configuration]({{site.baseurl}}/docs/pipelines/configuration/shared-configuration/) to be added tothe pipeline|Array of strings| Optional|
7268
|`spec.clustersInfo`| Determines if all (`injectAll`) or specific (`clusters`) Kubernetes cluster contexts are available for the pipeline build.<br>See[Select Kubernetes cluster contexts]({{site.baseurl}}/docs/pipelines/pipelines/#select-kubernetes-cluster-contexts).| object| Optional|
7369
|`spec.clustersInfo.injectAll`| When set as`true` (NIMA is this the default?), injects all clusters integrated with Codefresh into the pipeline build.| boolean| Optional|
7470
|`spec.clustersInfo.clusters`| Applicable only when`injectAll`is set to`false`.<br>One or more comma-separated names of clusters to inject during the pipeline build. For example,`aws`,`eks-prod`.| array| Optional|
@@ -93,36 +89,22 @@ toc: true
9389
|`spec.debug`| The ID of the pipeline.| string|`????'`|
9490
|`spec.serviceAccount`| The ID of the pipeline.| string|`????'`|
9591

96-
97-
98-
99-
10092
###spec.triggers
10193

102-
10394
###spec.triggers.events
10495

105-
10696
###spec.cronTriggers
10797

10898
###spec.runtimeEnvironment
10999

110100
###spec.lowMemoryWarningThreshold
111101

112-
113102
###spec.requiredAvailableStorage
114103

115104
###spec.clustersInfo
116105

117106
###spec.variables
118107

119-
120108
###spec.specTemplate
121109

122-
123110
###spec.debug.steps
124-
125-
126-
127-
128-

0 commit comments

Comments
 (0)

[8]ページ先頭

©2009-2025 Movatter.jp