Skip to content

How to do a Deployment

Mitchell Alessio edited this page Sep 9, 2025 · 24 revisions

How to Perform a BFD Deployment

Follow this runbook to successfully build and deploy the BFD Services code to target environment(s).

  1. In GitHub, navigate to the Release and Deploy BFD Workflow
  2. Start the Workflow by clicking the Run workflow button. For typical deployments you do not need to enter any overrides and can just click the green Run workflow button in the dropdown
  3. Monitor the Workflow run for any errors or issues. If issues occur, notify the team in the #bfd Slack channel
    1. If you are able to identify the issue and are able to determine that it was either an intermittent failure or a problem that could be solved by retrying, you can simply continue the Release and Deployment from where it failed by clicking the Re-run jobs dropdown and selecting Re-run failed jobs in the Workflow run view
  4. Once complete, send the following message to the #bfd-users channel making sure to replace <version> with the latest version, e.g. 2.999.0
@here :wave: [BFD has deployed release <version>](https://github.com/CMSgov/beneficiary-fhir-data/releases/tag/<version>)
Clone this wiki locally