support-reviewed:2023-04-18 LG

You are trying to run a specific step only if a variable is set. You are trying to have branching logic in one pipeline.

This condition determines how values are substituted for variables, when and if referenced variables do not exist in the pipeline definitions. In such cases, Codefresh retains the variable name string as-is, without substituting it with a value.

The condition determines how variable values are substituted within the pipeline's build when these variables are not defined in the pipeline configuration. In such instances, Codefresh maintains the variable name string unchanged, without replacing it with a value.

The following condition:

evaluates to`true` if`CF_RELEASE_TAG` does not exist, and`false` if it does exist.

1. Using the following syntax, you can check whether a variable exists for the current build:

Use the following syntax:

{% raw %}

Use the following syntax:

{% raw %}

Combinemultiple checks as required.

[Conditional execution of steps]({{site.baseurl}}/docs/pipelines/conditional-execution-of-steps/)

title:"How To: Check out onlythe PR merge commit, and not the HEAD ofthe target branch"

title:"How To: Check out onlypull request merge commit for target branch instead ofHEAD"

description:

group:kb

sub-group:articles

support-reviewed:2023-05-04 LG

Sometimes, when you re-run a pipeline based on a PR you might find your tests that passed the first time failing the second time. This can happen because the default behavior of your pipeline is to run based on a merge of the PR and the HEAD of the target branch - so it includes the latest changes to HEAD that may not have present when the PR itself was first made.

When re-running a pipeline based on a PR, tests that passed the previous fails during the rerun.

This can happen because the default behavior of the pipeline is to run based on a merge of the PR and the HEAD of the target branch. This behavior includes the latest changes to HEAD which may not have been present when the PR itself was created.

If you want a pipelineto only runagainst the target branch asit wasat the time of thepull request, you can clone your repository using the exact SHA of the merge request.

To only run the pipeline against the target branch as at the time of thePR, clone your repository using the exact SHA of the merge request.

WhenCodefreshis triggered by aPull Request, your pipeline will haveaccess tosomeadditional variables[1]. This includesCF_PULL_REQUEST_MERGED_COMMIT_SHA, which is the commit SHA on the base branch after thepull request was merged.

Whenthe pipelineis triggered by aPR, it hasaccess to additional variablesincluding`CF_PULL_REQUEST_MERGED_COMMIT_SHA`, which is the commit SHA on the base branch after thePR was merged.

You can set up your pipeline to test and see if this variable exists[2], and depending on it's existence do two different clone steps. One clone as your existing clone if the variable is not there, or a second clone step if it is that uses CF_PULL_REQUEST_MERGED_COMMIT_SHA in the`revision` field of your clone step[3] to check out your codebase as it was at the exact moment of the PR with the PR merged into it.

Configure[conditional execution for the pipeline]({{site.baseurl}}/docs/pipelines/conditional-execution-of-steps/) to check if the`CF_PULL_REQUEST_MERGED_COMMIT_SHA` variable exists.

Depending on result, execute one of two`git-clone` steps:

* If the variable exists, specify it in the`revision` field of your`git-clone` step. This ensures that your codebase is checked out to the state it was at the precise moment the PR was merged.

* If the variable does not exist, continue with your regular clone process.

[1]<https://codefresh.io/docs/docs/pipelines/variables/#github-pull-request-variables>

[2]<https://codefresh.io/docs/docs/kb/articles/check-env-vars-in-conditionals/>

[3]<https://codefresh.io/docs/docs/pipelines/steps/git-clone/#fields>

[GitHub Pull Request variables]({{site.baseurl}}/docs/pipelines/variables/#github-pull-request-variables)

[Check environment variable value or existence in conditionals]({{site.baseurl}}/kb/articles/check-env-vars-in-conditionals)

[Fields for`git-clone` step]({{site.baseurl}}/docs/pipelines/steps/git-clone/#fields)

* In the pipline step, add the`retry` attribute, as in the following example:

* In the pipeline step, add the`retry` attribute, as in the following example:

steps:

exponentialFactor:2

support-reviewed:2023-04-18 LG

You would liketo back up yourPipelines orProjects locally.

This article describes howto back up yourpipelines orprojects locally.

You will need to have the[Codefresh CLI installed](https://codefresh-io.github.io/cli/installation/). When installed, run the following command:

[Install the Codefresh CLI](https://codefresh-io.github.io/cli/installation/).

{% raw %}

**Back up the pipeline**

{% raw %}

codefresh get pip"pipeline_name" -o yaml> pipeline_backup_file

codefresh get pip"<pipeline_name>" -o yaml><pipeline_backup_file>

{% endraw %}

If you would like to export protected variables, run the following:

where:

*`"<pipeline_name>"` is the name of the pipeline to back up.

*`<pipeline_backup_file>` is the name of the file to which to save the backed up pipeline.

**Export protected variables**

{% raw %}

{% endraw %}

To recreate a pipeline from a backup file, run the following command:

**Recreate a pipeline from a backup file**

{% raw %}

{% endraw %}

[Codefresh CLI](https://codefresh-io.github.io/cli/installation/)

title:"How To: Clone target instead of source branchon pull request"

title:"How To: Clone target instead of source branchfor pull request"

description:

group:kb

sub-group:articles

support-reviewed:2023-04-18 LG

In most cases,buildswilluse thevariable`CF_BRANCH` to referencethebranchassociated with agit triggered build.

Typically, pipelinebuilds use the`CF_BRANCH`variableto referencethe branchassociated with abuild triggeredby a Git event. However, in the case of abuild triggered by a PR,`CF_BRANCH` specifically references the source branch. To clone the_target branch_ instead of the_source branch_ during a merge, use the`CF_PULL_REQUEST_TARGET` variable, which specifically points to the target branch.

In a pull request triggered build,`CF_BRANCH` specifically refers to the

source branch, and another variable`CF_PULL_REQUEST_TARGET` refers to the

target branch. You may need to use the target branch instead in your merge

build.

* Create a separate pipeline that uses {% raw %}`${{CF_PULL_REQUEST_TARGET}}`{% endraw %} instead of the standard {% raw %}`${{CF_BRANCH}}`{% endraw %} or

* Add the following step before your clone step to check if`CF_PULL_REQUEST_TARGET` exists, and if it does assign its value to`CF_BRANCH`:

`CF_BRANCH` is available only for PR-triggered builds. Updating its value to match`CF_PULL_REQUEST_TARGET` clones the target branch instead.

If`CF_PULL_REQUEST_TARGET` is not present, the build defaults to cloning the source branch.

* Create a separate pipeline that uses {% raw %}`${{CF_PULL_REQUEST_TARGET}}`{% endraw %} instead of the standard {% raw %}`${{CF_BRANCH}}`{% endraw %}

OR

* Add the following step before your`git-clone` step to check if`CF_PULL_REQUEST_TARGET` exists.

If it does, to assign its value to`CF_BRANCH`:

{% raw %}

support-reviewed:2023-04-18 LG

This article describes how to enable debug mode when using the Codefresh CLI for pipeline management.

Enabling the`debug` mode provides detailed output helping you to understand the reasons for potential issues.

When you're running commands using Codefresh CLI you may face some issues related to:

Debig mode is useful when facing issues related to:

* Authentication

* Network access, such as connectivity to the Codefresh platform

* Delays or errors during command execution, as when running a pipeline locally

* Authentication problems

* Network-related issues (e.g.: trying to reach Codefresh platform)

* Delays or errors executing a command (e.g.: running a pipeline locally)

Make sure you have the[latest version of the CLI](https://codefresh-io.github.io/cli/installation/){:target="\_blank"}.

1. Enable the`debug` mode for the Codefresh CLI: to do so, you need to initialize the`DEBUG` environment variable as follows:

1. Initialize the`DEBUG` environment variable:

DEBUG=codefresh*

```

2. Run the Codefresh CLIcommand you would like to debug. For example:

1. Run the Codefresh CLIcommand you want to debug.

For example:

(or any other Codefresh CLI command)

3. You will get an output similar to this:

1. Analyze the output to identify issues.

Below is an example of CLIcommand outputin debug mode.


>**_Note:_**

>If after reviewing the output provided by the debug mode you're still unable to fix the issue, please include that output in a ticket. That way the Support Team will be able to help you.

{{site.data.callout.callout_tip}}

**TIP**

If after analyzing the debug output you're unable to resolve the issue, please submit a ticket to Codefresh Support, including the output details.

* [Codefresh CLI Installation and upgrade process](https://codefresh-io.github.io/cli/installation/) (it's important to keep your Codefresh CLI up to date)

support-reviewed:2023-04-18 LG

You need to option to stop status update to github from a pipeline

To disable status updates to Github, please follow these steps (it's currently supported only via CLI):

Disabling status updates to GitHub is currently supported only via CLI for Codefresh pipelines.

2. Authenticate the CLI to your Codefresh account:<https://codefresh-io.github.io/cli/authentication/>

* Install the CLI](https://codefresh-io.github.io/cli/installation/){:target="\_blank"}

*[Authenticate the CLI to your Codefresh account](https://codefresh-io.github.io/cli/authentication/){:target="\_blank"}

4. Add the options section under`spec`, set`enableNotifications: false` and save the changes. The updated YAML should look like this:

1. Export the full pipeline spec as a YAML file:

`codefresh get pipeline <project_name/pipeline_name> -o yaml > pipeline_name_spec.yaml` to

1. Below`spec`, add`options` and then add`enableNotifications: false`, as in the example below.

version:'1.0'

options:

enableNotifications:false

title:"How To:Ensure Clean Up CommandsAlwaysRun If a Pipeline Is Manually Stopped"

title:"How To: Alwaysrun clean-up commands after pipeline execution"

description:

group:kb

sub-group:articles

support-reviewed:2023-05-04 LG

Sometimes you might want to run code at the end of every pipeline (eg to clean up resources) regardless of success, failure, or the pipeline is manually stopped.

When working with a sequential (default) pipeline, you will find that manually stopping a pipeline halts the entire pipeline - including any pipeline hooks set to run on_success or on_failure[1]. However, if you switch the entire pipeline work in parallel[2], you can use the below step as a template to ensure that your clean up code will always run:

The parallel step always runs at the end of the pipeline, regardless of its build status, or if the pipeline was manually terminated.

In a sequential pipeline, which is the default execution mode for pipelines, manually terminating the pipeline, also terminates the execution of subsequent steps, including any pipeline hooks set to run on success or failure.

You can circumvent this behavior by inserting a parallel step within the pipeline.

* Add the step below as a template to ensure code clean-up will always run:

cleaner_always_executed:

buildSuccess:workflow.result == 'success'