# sfops - On Pull Request Comments

This workflow gets triggered on a comment created in an issue within the project repository.

```
name: "sfops - On Pull Request Comments"

on:
  issue_comment:
    types: [created]

jobs:
  exec-on-pr-comment:
    name: "Execute Action on PR Comment"
    uses: flxbl-io/sfops-gh-actions/.github/workflows/exec-on-pr-comment.yml@main
    with:
      issue-number: ${{ github.event.issue.number }}
      pathToReleaseConfigs: "config"
      dashboard-repo: ${{ vars.SFOPS_DASHBOARD_REPO }}
      releasename: ${{ vars.releaseName }}
      metrics-provider: ${{ vars.SFOPS_METRICS_PROVIDER }}
      workitem-url: ${{ vars.SFOPS_ISSUETRACKER_URL }}
      workitem-filter: ${{ vars.SFOPS_ISSUETRACKER_WORKITEM_FILTER }}
      sfopsbot-app-id: ${{ vars.SFOPSBOT_APP_ID }}
    secrets:
      DEVHUB_SFDX_AUTH_URL: ${{ secrets.DEVHUB_SFDX_AUTH_URL }}
      SB_SFDX_AUTH_URL: ${{ secrets.SB_SFDX_AUTH_URL }}
      DATADOG_API_KEY: ${{ secrets.DATADOG_API_KEY }}
      DATADOG_HOST: ${{ secrets.DATADOG_HOST }}
      SFOPSBOT_APP_PRIVATE_KEY: ${{ secrets.SFOPSBOT_APP_PRIVATE_KEY }}
      NPM_TOKEN: ${{ secrets.GITHUB_TOKEN }}
```

The reusable workflow expands into multiple jobs and is responsible for the following actions

* **Extend a review sandbox:** If you want to extend a review sandbox for more than the default duration of 24 hours, this workflow triggers the action responsible for extending based on the comment `sfops extend` issued in the PR comments
* **Renew a review sandbox:** Fetch a new review sandbox to be associated with your PR, if a comment with `sfops renew` is created
* **Retrigger validation with new flags:** Change validation behavior by adding validation control commands (`sfops fast`, `sfops individual`, `sfops quick`, `sfops skiptests`) in a PR comment. The PR will automatically close and reopen to apply the new flags
* **Deploy a PR to test environment:** If you have activated the branch deploy model, you will be able to deploy the PR to a test environment before merging when a comment with `sfops test` is created

## Available Commands

| Command                                   | Description                                               |
| ----------------------------------------- | --------------------------------------------------------- |
| `sfops extend` or `/sfops extend`         | Extend the review sandbox duration beyond 24 hours        |
| `sfops renew` or `/sfops renew`           | Fetch a new review sandbox for the PR                     |
| `sfops fast` or `/sfops fast`             | Re-run validation in individual mode (faster, diff-based) |
| `sfops individual` or `/sfops individual` | Re-run validation in individual mode                      |
| `sfops quick` or `/sfops quick`           | Re-run validation in individual mode                      |
| `sfops skiptests` or `/sfops skiptests`   | Re-run validation with tests skipped                      |
| `sfops test` or `/sfops test`             | Deploy the PR to a test environment (branch deploy model) |

{% hint style="info" %}
The `/` prefix is optional for all commands!
{% endhint %}

For more details on validation control commands, see [PR Validation Controls](/flxbl/sfops/environments/review-environments/pr-validation-controls.md).


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.flxbl.io/flxbl/sfops/project-workflows/sfops-on-pull-request-comments.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.