amplify-build-status is a GitHub action to check the build status of an app on AWS Amplify.

It can also be used to wait until a build is complete before continuing the workflow. If the build fails the workflow will fail (unless set otherwise).

Example:

- name: Wait for Amplify to finish remote build
  uses: duckbytes/amplify-build-status@v1
  with:
    app-id: ${{ secrets.AMPLIFY_APP_ID }}
    branch-name: ${{ github.ref_name }}
    commit-id: ${{ github.sha }}
    wait: true
  env:
    AWS_ACCESS_KEY_ID: ${{ secrets.AWS_ACCESS_KEY_ID }}
    AWS_SECRET_ACCESS_KEY: ${{ secrets.AWS_SECRET_ACCESS_KEY }}
    AWS_REGION: ${{ secrets.AWS_REGION }}

This step when run on a branch connected to the Amplify console will stop the workflow from continuing until the remote build is complete.

You can access the app ID by going to Amplify on the AWS console:

Open your app on the list, and go to the Backend environments tab.

Click on Edit backend and copy the appId value.

app-id, branch-name and commit-id are all required input. You also must set AWS_ACCESS_KEY_ID, AWS_SECRET_ACCESS_KEY and AWS_REGION in your environnment variables.

Other inputs are:

• wait # Whether or not to wait until the remote build is completed or failed before continuing the workflow (default: false).
• timeout # How long to wait in minutes for the remote build to complete or fail, if wait is set (default: 120).
• no-fail # If the remote build fails the script will still use a successful exit status and not interrupt the workflow (default: false).

• status # The build status output according to the AWS CLI.

If you are connecting a branch to Amplify for the first time, the commit-id may be HEAD instead of the commit sha. Any subsequent bulds triggered by commits will use the actual commit sha.