Skip to main content

Pull Request Workflow in Holistics

Coming Soon

This feature is under development and will be coming soon!

Introduction

In a typical development process, when you make changes in the development branch, you need to create a Pull Request (in GitHub) or a Merge Request (in GitLab) before publishing to production. This allows other users to review your changes and triggers the CI workflow for testing and validation.

This step is essential to ensure no downtime and maintain code quality in the production environment.

How to setup PR Workflow in Holistics

Prerequisites

  • You have connected to your GitHub or GitLab repository to Holistics.
  • You have admin permission to the repository that you have connected to Holistics.

Step 1: Enable PR Workflow for your organization

  • Navigate to Settings > Project Settings > Enable PR Workflow.
  • Toggle on Enable PR Workflow button.
  • You will then be prompted to add the GitHub Access Token.
    • Go to GitHub Settings > Developer settings > Personal access tokens > Fine-grained tokens (or you can visit this link from GitHub)
    • Add Create new token
    • Set the expiration date for your token:
      • Holistics PR Workflow cannot function properly if the token is expired. So make sure to set the expiration date for your token to be far enough in the future.
      • 5 days before the token expires, you will see the inapp warning banner in Holistics.
    • Select the Repository that you have connected to Holistics
    • Set up Repository permissions:
      • Pull requests: Read only -> this is necessary for Holistics to create Pull Request in your repository from Holistics
      • Webhooks: Read and Write -> this is necessary for Holistics to check PR Status and set up Auto-Publish workflow
    • Click on Generate token
    • Copy the token and paste it in the Holistics dialog

Step 2: Go back to Holistics, make changes, and create a PR

  • Make changes to your files in Development Workspace. And then Commit
  • Click on Create PR button in the top right corner
  • After that, you will be redirected to GitHub to create a PR.
  • Once the PR is created, back in Holistics, you will see the PR status has been updated in Holistics with Open status.

Step 3: Review, update, and approve the PR

  • Once the PR is created, other people can review your PR and make comments.
  • In the meantime, you can make changes to your PR in Holistics.

Step 4: Publish the PR

  • Once the PR is approved and merged to master branch, the changes will be published to production automatically.
  • If somehow the Publish process failed, you can try to publish it manually by clicking on Publish button in Holistics.
  • In case you want to customize the Publish logic (for e.g., don't publish to production in weekend), you can use our Publish API instead of our normal Auto-Publish workflow.

Let us know what you think about this document :)