You signed in with another tab or window.Reload to refresh your session.You signed out in another tab or window.Reload to refresh your session.You switched accounts on another tab or window.Reload to refresh your session.Dismiss alert
* Update jira project prefix param descriptionUpdated jira project prefix desc to include multiple prefixes* Add runtime version requirement to Jira project prefixAdded runtime version 0.1.30 as requirement for multi project prefix support* Add runtime version for multi project prefixes in jira* Edit multi-project-prefix param
Copy file name to clipboardExpand all lines: _docs/gitops-integrations/ci-integrations.md
+9-9Lines changed: 9 additions & 9 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -70,13 +70,13 @@ max-width="50%"
70
70
{:start="6"}
71
71
1. Paste the copied manifest as the last step in your CI pipeline.
72
72
73
-
###CI integration argument reference
73
+
##CI integration argument reference
74
74
The table describes_all_ the arguments required for CI integrations in general. The actual arguments required, differs according to the CI integration tool.
|`CF_HOST`|_Deprecated from v 0.0.460 and higher._ Recommend using`CF_RUNTIME_NAME` instead. {::nomarkdown}<br><spanstyle="font-family:var(--font-family-monospace);font-size:87.5%;color:#ad6800;background-color:#fffbe6">CF_HOST</span> has been deprecated because the URL is not static, and any change can fail the enrichment.<br><br> The URL to the cluster with the Codefresh runtime to integrate with. If you have more than one runtime, select the runtime from the list. Codefresh displays the URL of the selected runtime cluster.{:/}|_Deprecated_|
79
+
|`CF_HOST`|_Deprecated from v 0.0.460 and higher._ Recommend using`CF_RUNTIME_NAME` instead. {::nomarkdown}<br><codeclass="highlighter-rouge">CF_HOST</code> has been deprecated because the URL is not static, and any change can fail the enrichment.<br><br> The URL to the cluster with the Codefresh runtime to integrate with. If you have more than one runtime, select the runtime from the list. Codefresh displays the URL of the selected runtime cluster.{:/}|_Deprecated_|
80
80
|`CF_RUNTIME_NAME`| The runtime to use for the integration. If you have more than one runtime, select the runtime from the list.| Required|
81
81
|`CF_PLATFORM_URL`| The root URL of the Codefresh application. The default value is`https://g.codefresh.io`.| Optional|
82
82
|`CF_API_KEY`| The API key for authentication. Generate the key for the integration.| Required|
@@ -87,13 +87,13 @@ The table describes _all_ the arguments required for CI integrations in general.
87
87
|`CF_WORKFLOW_NAME`| The name assigned to the workflow that builds the image. When defined, the name is displayed in the Codefresh platform. Example,`Staging step`| Optional|
88
88
|`CF_GIT_BRANCH`| The Git branch with the commit and PR (pull request) data to add to the image. Pass the Branch from the event payload used to trigger your action.| Required|
89
89
|`CF_GIT_REPO`| The Git repository with the configuration and code used to build the image. {::nomarkdown} <ul><li>Optional for GitHub Actions. <li>Required for Codefresh pipelines and Jenkins.</li><ul>{:/}| Required|
90
-
| `CF_GIT_PROVIDER` | The Git provider for the integration, and can be either `github`, `gitlab`, or `bitbucket`. {::nomarkdown} <ul><li>Optional when you don't define other related Git provider arguments. When not defined, Codefresh retrieves the required information from the runtime selected for the integration. <li>Required when you define at least one of the Git provider arguments. For example, when you define <span style="font-family: var(--font-family-monospace); font-size: 87.5%; color: #ad6800; background-color: #fffbe6">CF_GITLAB_TOKEN</span>, then you <i>must</i> define all Git provider arguments, in this case, <span style="font-family: var(--font-family-monospace); font-size: 87.5%; color: #ad6800; background-color: #fffbe6">CF_GIT_PROVIDER</span> as <span style="font-family: var(--font-family-monospace); font-size: 87.5%; color: #ad6800; background-color: #fffbe6">gitlab</span>, and <span style="font-family: var(--font-family-monospace); font-size: 87.5%; color: #ad6800; background-color: #fffbe6">CF_GITLAB_HOST_URL</span>.</li><ul>{:/}| Optional |
91
-
|`CF_GITLAB_TOKEN`| The token to authenticate the GitLab account. {::nomarkdown} <ul><li>Optional when you don't define any GitLab-specific arguments. When not defined, Codefresh retrieves the required information from the runtime selected for the integration. <li>Required when you define at least one of the GitLab-specific arguments, such as <spanstyle="font-family:var(--font-family-monospace);font-size:87.5%;color:#ad6800;background-color:#fffbe6">CF_GIT_PROVIDER</span> as <spanstyle="font-family:var(--font-family-monospace);font-size:87.5%;color:#ad6800;background-color:#fffbe6">gitlab</span>, or <spanstyle="font-family:var(--font-family-monospace);font-size:87.5%;color:#ad6800;background-color:#fffbe6">CF_GITLAB_HOST_URL</span>.</li><ul>{:/}| Optional|
92
-
|`CF_GITLAB_HOST_URL`| The URL address of your GitLab Cloud/Server instance. {::nomarkdown} <ul><li>Optional when you don't define other related GitLab-specific arguments. When not defined, Codefresh retrieves the required information from the runtime selected for the integration. <li>Required when you define at least one of the GitLab-specific arguments, such as <spanstyle="font-family:var(--font-family-monospace);font-size:87.5%;color:#ad6800;background-color:#fffbe6">CF_GIT_PROVIDER</span> as <spanstyle="font-family:var(--font-family-monospace);font-size:87.5%;color:#ad6800;background-color:#fffbe6">gitlab</span>, or <spanstyle="font-family:var(--font-family-monospace);font-size:87.5%;color:#ad6800;background-color:#fffbe6">CF_GITLAB_TOKEN</span>.</li><ul>{:/}| Optional|
93
-
|`CF_BITBUCKET_USERNAME`| The username for the Bitbucket or the Bitbucket Server (on-prem) account. {::nomarkdown}<ul><li>Optional when you don't define other related Bitbucket-specific arguments. When not defined, Codefresh retrieves the required information from the runtime selected for the integration. <li>Required when you define at least one of the Bitbucket-specific arguments, such as <spanstyle="font-family:var(--font-family-monospace);font-size:87.5%;color:#ad6800;background-color:#fffbe6">CF_GIT_PROVIDER</span> as <spanstyle="font-family:var(--font-family-monospace);font-size:87.5%;color:#ad6800;background-color:#fffbe6">bitbucket</span>, <spanstyle="font-family:var(--font-family-monospace);font-size:87.5%;color:#ad6800;background-color:#fffbe6">CF_BITBUCKET_PASSWORD</span> or <spanstyle="font-family:var(--font-family-monospace);font-size:87.5%;color:#ad6800;background-color:#fffbe6">CF_BITBUCKET_HOST_URL</span>.</li><ul>{:/}| Optional|
94
-
|`CF_BITBUCKET_PASSWORD`| The password for the Bitbucket or the BitBucket Server (on-prem) account. {::nomarkdown} <ul><li>Optional when you don't define other related Bitbucket-specific arguments. When not defined, Codefresh retrieves the required information from the runtime selected for the integration. <li>Required when you define at least one of the Bitbucket-specific arguments, such as <spanstyle="font-family:var(--font-family-monospace);font-size:87.5%;color:#ad6800;background-color:#fffbe6">CF_GIT_PROVIDER</span> as <spanstyle="font-family:var(--font-family-monospace);font-size:87.5%;color:#ad6800;background-color:#fffbe6">bitbucket</span>, <spanstyle="font-family:var(--font-family-monospace);font-size:87.5%;color:#ad6800;background-color:#fffbe6">CF_BITBUCKET_USERNAME</span>, or <spanstyle="font-family:var(--font-family-monospace);font-size:87.5%;color:#ad6800;background-color:#fffbe6">CF_BITBUCKET_HOST_URL</span>.</li><ul>{:/}| Optional|
95
-
| `CF_BITBUCKET_HOST_URL` | Relevant for Bitbucket Server accounts only. The URL address of your Bitbucket Server instance. Example, `https://bitbucket-server:7990`. {::nomarkdown}<ul><li>Optional when you don't define other related Bitbucket Server-specific arguments. When not defined, Codefresh retrieves the required information from the runtime selected for the integration. </li><li>Required when you define at least one of the Bitbucket Server-specific arguments, such as <span style="font-family: var(--font-family-monospace); font-size: 87.5%; color: #ad6800; background-color: #fffbe6">CF_GIT_PROVIDER</span> as <span style="font-family: var(--font-family-monospace); font-size: 87.5%; color: #ad6800; background-color: #fffbe6">bitbucket</span>, <span style="font-family: var(--font-family-monospace); font-size: 87.5%; color: #ad6800; background-color: #fffbe6">CF_BITBUCKET_USERNAME</span> or <span style="font-family: var(--font-family-monospace); font-size: 87.5%; color: #ad6800; background-color: #fffbe6">CF_BITBUCKET_PASSWORD</span>.</li></ul>{:/} | Optional |
96
-
|`CF_JIRA_PROJECT_PREFIX`| Relevant only when`CF_ISSUE_TRACKING_INTEGRATION` is defined.The Jiraprojectprefix that identifiesthe ticket number to use.| Required|
90
+
|`CF_GIT_PROVIDER`| The Git provider for the integration, and can be either`github`,`gitlab`, or`bitbucket`. {::nomarkdown} <ul><li>Optional when you don't define other related Git provider arguments. When not defined, Codefresh retrieves the required information from the runtime selected for the integration. <li>Required when you define at least one of the Git provider arguments. For example, when you define <codeclass="highlighter-rouge">CF_GITLAB_TOKEN</code>, then you <i>must</i> define all Git provider arguments, in this case, <codeclass="highlighter-rouge">CF_GIT_PROVIDER</code> as <codeclass="highlighter-rouge">gitlab</code>, and <codeclass="highlighter-rouge">CF_GITLAB_HOST_URL</code>.</li><ul>{:/}| Optional|
91
+
|`CF_GITLAB_TOKEN`| The token to authenticate the GitLab account. {::nomarkdown} <ul><li>Optional when you don't define any GitLab-specific arguments. When not defined, Codefresh retrieves the required information from the runtime selected for the integration. <li>Required when you define at least one of the GitLab-specific arguments, such as <codeclass="highlighter-rouge">CF_GIT_PROVIDER</code> as <codeclass="highlighter-rouge">gitlab</code>, or <codeclass="highlighter-rouge">CF_GITLAB_HOST_URL</code>.</li><ul>{:/}| Optional|
92
+
|`CF_GITLAB_HOST_URL`| The URL address of your GitLab Cloud/Server instance. {::nomarkdown} <ul><li>Optional when you don't define other related GitLab-specific arguments. When not defined, Codefresh retrieves the required information from the runtime selected for the integration. <li>Required when you define at least one of the GitLab-specific arguments, such as <codeclass="highlighter-rouge">CF_GIT_PROVIDER</code> as <codeclass="highlighter-rouge">gitlab</code>, or <codeclass="highlighter-rouge">CF_GITLAB_TOKEN</code>.</li><ul>{:/}| Optional|
93
+
|`CF_BITBUCKET_USERNAME`| The username for the Bitbucket or the Bitbucket Server (on-prem) account. {::nomarkdown}<ul><li>Optional when you don't define other related Bitbucket-specific arguments. When not defined, Codefresh retrieves the required information from the runtime selected for the integration. <li>Required when you define at least one of the Bitbucket-specific arguments, such as <codeclass="highlighter-rouge">CF_GIT_PROVIDER</code> as <codeclass="highlighter-rouge">bitbucket</code>, <codeclass="highlighter-rouge">CF_BITBUCKET_PASSWORD</code> or <codeclass="highlighter-rouge">CF_BITBUCKET_HOST_URL</code>.</li><ul>{:/}| Optional|
94
+
|`CF_BITBUCKET_PASSWORD`| The password for the Bitbucket or the BitBucket Server (on-prem) account. {::nomarkdown} <ul><li>Optional when you don't define other related Bitbucket-specific arguments. When not defined, Codefresh retrieves the required information from the runtime selected for the integration. <li>Required when you define at least one of the Bitbucket-specific arguments, such as <codeclass="highlighter-rouge">CF_GIT_PROVIDER</code> as <codeclass="highlighter-rouge">bitbucket</code>, <codeclass="highlighter-rouge">CF_BITBUCKET_USERNAME</code>, or <codeclass="highlighter-rouge">CF_BITBUCKET_HOST_URL</code>.</li><ul>{:/}| Optional|
95
+
|`CF_BITBUCKET_HOST_URL`| Relevant for Bitbucket Server accounts only. The URL address of your Bitbucket Server instance. Example,`https://bitbucket-server:7990`. {::nomarkdown}<ul><li>Optional when you don't define other related Bitbucket Server-specific arguments. When not defined, Codefresh retrieves the required information from the runtime selected for the integration. </li><li>Required when you define at least one of the Bitbucket Server-specific arguments, such as <codeclass="highlighter-rouge">CF_GIT_PROVIDER</code> as <codeclass="highlighter-rouge">bitbucket</code>, <code class="highlighter-rouge"">CF_BITBUCKET_USERNAME</code> or <codeclass="highlighter-rouge">CF_BITBUCKET_PASSWORD</code>.</li></ul>{:/}| Optional|
96
+
|`CF_JIRA_PROJECT_PREFIX`| Relevant only when`CF_ISSUE_TRACKING_INTEGRATION` is defined.One or moreprojectprefixes in Jira to identifytheJiraticket number to use.<br>**NOTE**: Multiple project prefixes require runtime version 0.1.30 or higher. <br>To specify more than one prefix, use a comma-separated list or a regex. {::nomarkdown}<ul><li>Comma-separated list: <codeclass="highlighter-rouge">DEV,PROD,SAAS</code></li><li>Regex: Regex must start with a front slash <codeclass="highlighter-rouge">/</code> and end with <codeclass="highlighter-rouge">/g</code>. <br>Example: <codeclass="highlighter-rouge">/[A-Z]{2,}-\d+/g</code>.</li></ul>{:/}| Required|
97
97
|`CF_JIRA_MESSAGE`| Relevant only when`CF_ISSUE_TRACKING_INTEGRATION` is defined. The Jira issue IDs matching the string to associate with the image.| Required|
98
98
|`CF_JIRA_FAIL_ON_NOT_FOUND`| Relevant only when`CF_ISSUE_TRACKING_INTEGRATION` is defined. The report image action when the`CF_JIRA_MESSAGE` is not found. When set to`true`, the report image action is failed.| Required|