deployable_api_infrastructure_with_nginx.pdf

Transcript

1. Deployable API infrastructure with nginx Daniel Kocot, Senior Solution Architect / Head of API Experience & Operations
2. Name: Daniel Kocot Role: Senior Solution Architect / Head of API Experience & Operations Email: Twitter: @dk_1977 LinkedIn: daniel.kocot@codecentric.de https://www.linkedin.com/in/danielkocot/
3. Deployable Infrastructure based on a API description Gateways Portals Hubs Registries
4. API Mediation Architectural layer to manage, protect and enrich an API Intercepting API traffic Concept of "outer" APIs No business logic should be handled within this layers
5. OpenAPI Specification
6. OpenAPI Definition in Detail openapi: 3.0.3 servers: - url: 'http://localhost:8080' info: version: 1.0.0 title: News API contact: name: Daniel Kocot url: 'http://www.codecentric.de' email: daniel.kocot@codecentric.de license: name: MIT url: 'https://www.tldrelgal.com/mit' description: An API to provide news tags: - name: news paths: /news: x-nginx-upstream: 'http://remotehost:4000' get: description: gets latest news operationId: getNews tags: - news
7. OpenAPI Map
8. Use of references with $ref local '#/components/schemas/myElement' remote 'myElement.yaml' url 'http://path/to/your/myElement.yaml'
9. Use of OpenAPI Extensions/X-Objects to handle own or vendor needs x-vendor-…​ x-…​ Supported by: root level info paths operation parameters responses tags security schemes
10. From OpenAPI Definition to Configuration as Code paths: /news: x-nginx-upstream: 'http://remotehost:4000' get: description: gets latest news operationId: getNews tags: - news responses: '200':
11. Converting YAML to JSON > npm install -g yaml2json > yaml2json specs/news.yaml
12. Parsing JSON Using a parser of choice Depending on the preferred programming language
13. Fetch information Using variables to fetch data from JSON
14. Creating nginx configuration Using templating engine (Handlebars, Mustache, …​) Writing configuration templates
15. Automation Putting everything in a CI/CD pipeline
16. No standardization (so far)
18. Wrap Up Posts on codecentric blog: Posts on my blog: Posts on Medium: https://blog.codecentric.de/en/author/daniel-kocot/ https://danielkocot.github.io https://medium.com/@daniel.kocot
19. Q&A
20. Thank you