Kiradigi-Cycles-Workshop-Apien Kehitys Ja Hallinta

Kiradigi-Cycles-Workshop-Apien Kehitys Ja Hallinta. cyclesin vaiheet kanvaksista eteenpäin

Transcript

1. #kiradigi APIOps® Cycles TYÖPAJA 9.3.2018 API:en kehitys ja hallinta Twitter: @APInf_io | @ilarimikkonen | @SakariPaloviita Email: sakari.paloviita@apinf.io | ilari.mikkonen@apinf.io #kiradigi
2. #kiradigi Agenda Warmup 5 Remaining steps 25 workshop part 15 discussion 15 suggestions welcome, ideas for workshop
3. #kiradigi APIOps® Cycles - http://cycles.apiops.net • APIOps® Cycles on kokoelma työkaluja ja menetelmiä toteuttamaan API-hallintaan yhteensopivia apeja (API) liiketoimintalähtöisesti ja parhaiden arkkitehtuurikäytäntöjen mukaisesti. • APIOps® Cycles alkuperäiset kehittäjät ◦ Digia Oyj; kehittää ja käyttää APIOps® Cycles:iä omissa asiakasprojekteissaan. Tarkoitus on luoda standardit API-vetoiseen kehitykseen sekä kehittää jatkuvasti näitä metodeja ja parhaita käytäntöjä. ◦ APInf Oy; kehittää ja promoaa APIOps® Cycles:iä asiakkailleen. APIOps® tavaramerkki on rekisteröity APInf Oy:n nimiin, mikä suojaa APIOps yhteisön panostukset yhteisön hyväksi ja vapauden käyttää niitä. APInf Oy on sitoutunut pitämään APIOps® identiteetin vapaana ja neutraalina.
4. #kiradigi APIOps Cycles prosessi http://cycles.apiops.net/ API teknologiayhteisö: APIOps Perustana toimivat menetelmät 1. DevOps 2. Business Model Canvas 3. Value Proposition Canvas 4. Lean Startup Sovelletut menetelmät (Cycles) 1. Minimum Viable Architecture 2. API Canvas 3. API Value Proposition Canvas
5. #kiradigi Mutta meillä on jo prosessit! http://cycles.apiops.net/ Jos näin pääsi käymään niin kannattaa käydä läpi ja rehellisesti arvioida mitä voidaan missäkin parantaa. Jos ei ole omia systeemejä, tästä on hyvä aloittaa
6. #kiradigi APIOps Cycles prosessi http://cycles.apiops.net/ 1. API Canvas Liiketoiminnan suunnittelu 2. Min. Viable API Architecture Riittävä API Arkkitehtuuri 3. Build API Valmista API 4. API Audit API:n auditointi 5. API Lifecycle API:n elinkaarihallinta 6. Developer Experience Kehittäjäkokemus 7. Measure Mittaa 8. Learn Opi käsitelty
7. #kiradigi Canvases let’s take a look at the cycles site: http://cycles.apiops.net/apicanvas/
8. #kiradigi APIOps Cycles prosessi http://cycles.apiops.net/ 1. API Canvas Liiketoiminnan suunnittelu 2. Min. Viable API Architecture Riittävä API Arkkitehtuuri 3. Build API Valmista API 4. API Audit API:n auditointi 5. API Lifecycle API:n elinkaarihallinta 6. Developer Experience Kehittäjäkokemus 7. Measure Mittaa 8. Learn Opi
9. #kiradigi Collecting Architecture Requirements Do before starting with MVA Some elements: Business impact identification - collect risk items (house in usual matrix) try not to solve - identify stakeholders, collect risk items - API related: API availability, API security and privacy, problems in API data - Traditional items: schedule, profitability, cost, technical resources, etc Capacity estimations Where are the data and systems located related to this API? - legacy / existing systems API Consumer requirements Technology choices: stack, API management systems, Identification management, etc <- can wait when we do design 1st Main focus on initial iterations, review on subsequent iterations
10. #kiradigi Transition from canvas to architecture Yes! we go the canvases! Then what? API Canvas (as input to MVA): http://cycles.apiops.net/minimumviableapiarchitecturemvaa/mvaa-phases/ Examples: Who are the first API -consuming users? Do they or their platform have special requirements? What is their key pain, what problem does this API solve? What data or logic they absolutely must have to publish their service? How can the API -consumers be contacted for feedback on the designs?
11. #kiradigi Minimum viable Architecture Is a set of design principles which is very suitable for APIs, microservices and API management as it is designed for different stages of growth and maturity. Phases of Minimum Viable Architecture are: 1. Prototyping - typically when building a new API ◦ Goal: Zero code or tech products used (or only existing), minimal budget, still possibility to change plans radically 2. Building Just enough - implementation - typically when building a new API for 1-2 API consumers ◦ Goal: Nothing is built “Just in Case”, customer needs can evolve while building, as small budget as possible 3. Scaling - typically when existing API needs to serve a growing number of consumers ◦ Goal: Scale your architecture with the growing business
12. #kiradigi APIOps Cycles prosessi http://cycles.apiops.net/ 1. API Canvas Liiketoiminnan suunnittelu 2. Min. Viable API Architecture Riittävä API Arkkitehtuuri 3. Build API Valmista API 4. API Audit API:n auditointi 5. API Lifecycle API:n elinkaarihallinta 6. Developer Experience Kehitäjäkokemus 7. Measure Mittaa 8. Learn Opi
13. #kiradigi Building API Scrum / Agile methods recommended Iterative approach Include end users as soon as possible Design First! / no code Devops - automate as much as possible
14. #kiradigi APIOps Cycles prosessi http://cycles.apiops.net/ 1. API Canvas Liiketoiminnan suunnittelu 2. Min. Viable API Architecture Riittävä API Arkkitehtuuri 3. Build API Valmista API 4. API Audit API:n auditointi 5. API Lifecycle API:n elinkaarihallinta 6. Developer Experience Kehitäjäkokemus 7. Measure Mittaa 8. Learn Opi
15. #kiradigi API Audit Checklist based approach - easy way to ensure basic quality. Example items: API management: Has a version of the API already been published via API management? Is it visible in a Developer Portal? Have any users already subscribed to the API?
16. #kiradigi APIOps Cycles prosessi http://cycles.apiops.net/ 1. API Canvas Liiketoiminnan suunnittelu 2. Min. Viable API Architecture Riittävä API Arkkitehtuuri 3. Build API Valmista API 4. API Audit API:n auditointi 5. API Lifecycle API:n elinkaarihallinta 6. Developer Experience Kehitäjäkokemus 7. Measure Mittaa 8. Learn Opi
17. #kiradigi API Lifecycle Close ties to API management - API management tends to have lifecycle management All things die, there is no forever* - plan versioning - Example states: draft, beta, production, deprecated - Semantic distinction, draws from traditional SW industry and practices
18. #kiradigi APIOps Cycles prosessi http://cycles.apiops.net/ 1. API Canvas Liiketoiminnan suunnittelu 2. Min. Viable API Architecture Riittävä API Arkkitehtuuri 3. Build API Valmista API 4. API Audit API:n auditointi 5. API Lifecycle API:n elinkaarihallinta 6. Developer Experience Kehitäjäkokemus 7. Measure Mittaa 8. Learn Opi
19. #kiradigi Developer experience API is a product, treat is as such. Some topics: Developer onboarding - 1st impressions matter - documentation, documentation, documentation - less is more - functionality - reliability - cost -free tier Developer support https://www.oppia.fi/webinars/apikehittajakokemus
20. #kiradigi APIOps Cycles prosessi http://cycles.apiops.net/ 1. API Canvas Liiketoiminnan suunnittelu 2. Min. Viable API Architecture Riittävä API Arkkitehtuuri 3. Build API Valmista API 4. API Audit API:n auditointi 5. API Lifecycle API:n elinkaarihallinta 6. Developer Experience Kehitäjäkokemus 7. Measure Mittaa 8. Learn Opi
21. #kiradigi Measure Figure out what is relevant for your organisation. Typical KPIs and APIOps dashboards: • Business performance • API Consumer dashboard • API Provider dashboard • Change events (deployments and infrastructure changes) dashboard • Alerts dashboard Financials • Revenue (MRR) generated by APIs • Other added value generated by APIs • API management recurring costs • API management licensing and maintenance costs • API management infrastructure costs • APIOps costs Money flows in API canvas
22. #kiradigi APIOps Cycles prosessi http://cycles.apiops.net/ 1. API Canvas Liiketoiminnan suunnittelu 2. Min. Viable API Architecture Riittävä API Arkkitehtuuri 3. Build API Valmista API 4. API Audit API:n auditointi 5. API Lifecycle API:n elinkaarihallinta 6. Developer Experience Kehitäjäkokemus 7. Measure Mittaa 8. Learn Opi
23. #kiradigi Learn Can’t stop learning - Here focus on the product; varies depending on the maturity of the API product. In Prototyping phase the API Consumers are different to when the API is in production Make sure hidden becomes visible - retrospective Ties into measurement If you really want to make progress, learn about yourself
24. #kiradigi APIOps Cycles prosessi http://cycles.apiops.net/ 1. API Canvas Liiketoiminnan suunnittelu 2. Min. Viable API Architecture Riittävä API Arkkitehtuuri 3. Build API Valmista API 4. API Audit API:n auditointi 5. API Lifecycle API:n elinkaarihallinta 6. Developer Experience Kehitäjäkokemus 7. Measure Mittaa 8. Learn Opi
25. #kiradigi Workshop osuus
26. #kiradigi Pekan Pallot oy tekee palloja. Ne ajatteli että sen sijaan että Sirkka vastaa puhelimeen ja ottaa tilauksia vastaan, olisi API joka tekee saman. Sirkka haluaa eläkkeelle -> API joka tekee (tai tekee tilauksen tuotannonhallintajärjestelmään) pallon kun sille kertoo halkaisijan ja värin
27. #kiradigi NASA intergration own web page ball sales - indirect API creation, it cost joosepin webbisivupulju build api contact stakeholder s, kysyä asiakkailta mitä pitää rakentaa ITn kalle, tuotannon hallinta global balls Sirkka can retire, (ostamisen helppous), asiakaspalvelun tehostaminen, asiakkaan liiketoiminnan tukeminen ball paint industry (paints balls) individuals who needs balls ball resellers host in API management, NASA procurement
28. #kiradigi If you can, do contribute https://github.com/APIOps/APIOps-cycles
29. #kiradigi KIITOS Twitter: @APInf_io | @ilarimikkonen | @SakariPaloviita Email: sakari.paloviita@apinf.io | ilari.mikkonen@apinf.io #kiradigi http://cycles.apiops.net