Skip to main content

Manual sign-offs

Manual sign-offs are default quality gates prepared by Guidewire to ensure that builds in your CI/CD pipeline are manually checked and signed off by a designated approver.

See an example procedure for creating a manual sign-off:

Required and optional manual sign-offs​

There are two types of manual sign-offs:

  • A required sign-off

    It must have at least one approval from the specified approvers for a build to be promoted.

  • An optional sign-off

    It doesn't block a build from being promoted.

Stages for manual sign-offs​

Manual sign-offs can be applied at the following two stages:

  • Before promoting: pre-prod

    If a required manual sign-off for this stage doesn't have the Successful status, it blocks a build from being promoted to a pre-production star system.

  • Before promoting: prod

    If a required manual sign-off for this stage doesn't have the Successful status, it blocks a build from being promoted to a production star system.

Verifications for manual sign-offs​

Verifications for manual sign-offs are set up automatically. You can check the verification status of manual sign-offs in the Build Promotion app.

Verification status of a manual sign-off gate for a build that you want to promote can be one of the following:

  • Successful
  • Pending

Pending is a default status when a build is ready to be promoted and a verification is created. When the manual sign-off is approved, the verification changes its status to Successful.

Note:

With the Insurer Admin permissions, you can promote a build regardless of the quality gate status using API. For details, see Promote a build regardless of the quality gate status in the Build Promoter API.

Create a manual sign-off​

For each InsuranceSuite app, you must create the manual sign-offs separately.

Note:

To manage the manual sign-offs, you can also use the CI/CD Manager API.

To create a manual sign-off:

  1. In the Quality gates app, select the InsuranceSuite app for which you want to set the quality gates.

  2. Go to Manual sign-offs and select + Add manual sign-off.

  3. Provide the following details:

    • Stage

      Select one of the following stages:

      • Before promoting: pre-prod
      • Before promoting: prod.

      For details, see Stages for manual sign-offs.

    • Approvers

      Provide usernames of approvers that will have to approve builds. The usernames should be in a format of an email address.

      You can add a maximum of ten approvers.

      This field is obligatory.

    • Description (Optional)

      You can provide a description to explain the purpose of the quality gate.

    • Required

      By default, a manual sign-off is required. To make it optional, clear the Required check box.

  4. Select Add.

Edit a manual sign-off​

You can modify the following parameters:

  • Approvers

    You can add and remove approvers.

  • Description

    You can add the optional description of your custom gate.

  • Required

    You can choose if the quality gate is required or optional.

To modify a manual sign-off, select Edit in the Actions column.

Delete a manual sign-off​

You can delete manual sign-offs that you no longer need.

To delete a manual sign-off, select Delete in the Actions column.

Tip:

Instead of deleting a manual sign-off, you can make it optional. Optional gates don’t block builds from being promoted.