Ram Gopinathan, Red Hat, Principal Specialist Solutions Architect, Edge Computing
This session will first cover what design first API development means and compare and contrast with code first approach. We will then go over how backstage can help API developers practice design first API development using software templates and github actions workflow. API designers after designing openapi spec in swagger editor can use the software template to provide information about the API along with the spec. Once the information is submitted, using backstage scaffolding capabilities required catalog entity files are created and added to git repo and a pull request is created. PR url will be displayed as output. Open pull request action will also trigger a github actions workflow to update the targets in the location file and since our backstage instance is configured to automatically ingest entities from this location as soon as the pull request is merged within a few minutes this new API will become available in the backstage software catalog. At this point development team can use a software template to implement this newly created API.