SlideShare ist ein Scribd-Unternehmen logo
1 von 29
arc42 in a Real DevOps Team
Lessons Learned
DB Systel GmbH | Johannes Dienst | @JohannesDienst
Digital partner of
Deutsche Bahn
DB Systel GmbH | Johannes Dienst | @JohannesDienst 2
DB Content Hub
DB Systel GmbH | Johannes Dienst | @JohannesDienst 3
‒ Content as a Service (CaaS)
‒ Headless CMS
‒ Self hosted in Cloud
‒ You build it, you run it!
Product Development
DB Systel GmbH | Johannes Dienst | @JohannesDienst 4
The Cost of Poor Documentation
DB Systel GmbH | Johannes Dienst | @JohannesDienst 5Icons made by Freepik, Good Ware, Sprang and Smashicons from www.flaticon.com
The Cost of Poor Documentation
DB Systel GmbH | Johannes Dienst | @JohannesDienst 6Icons made by Freepik, Good Ware, Sprang and Smashicons from www.flaticon.com
arc42
DB Systel GmbH | Johannes Dienst | @JohannesDienst 7
arc42
DB Systel GmbH | Johannes Dienst | @JohannesDienst 8
Building Block View
Deployment View
Runtime View
arc42
1. Introduction and Goals
2. Constraints
3. Context and Scope
4. Solution Strategy
5. Building Block View
6. Deployment View
7. Runtime View
8. Concepts
9. Architecture Decisions
10. Quality
11. Risks and Technical debt
11. Glossary
Technical Architecture in a Devops Team
DB Systel GmbH | Johannes Dienst | @JohannesDienst 9
Betriebshandbuch
Icons made by Freepik, Good Ware, Sprang and Smashicons from www.flaticon.com
Must Haves
DB Systel GmbH | Johannes Dienst | @JohannesDienst 10
‒ Introduction and Goals
‒ Constraints
‒ Context and Scope
‒ Solution Strategy
‒ (Building block view)
‒ (Deployment view)
‒ (Runtime view)
‒ Concepts
‒ Architecture Decisions
‒ Quality
‒ Risks and technical Debt
‒ Glossary
Glossary
DB Systel GmbH | Johannes Dienst | @JohannesDienst 11
Content
Asset
Content
Type
Icons made by Freepik, Good Ware, Sprang and Smashicons from www.flaticon.com
A Wiki Is Born
DB Systel GmbH | Johannes Dienst | @JohannesDienst 12Icons made by Freepik, Good Ware, Sprang and Smashicons from www.flaticon.com
Technical Architecture Documentation!= Tutorial
DB Systel GmbH | Johannes Dienst | @JohannesDienst 13Icons made by Freepik, Good Ware, Sprang and Smashicons from www.flaticon.com
The Wiki Is a Problem Child
DB Systel GmbH | Johannes Dienst | @JohannesDienst 14Icons made by Freepik, Good Ware, Sprang and Smashicons from www.flaticon.com
The Wiki Is a Problem Child
DB Systel GmbH | Johannes Dienst | @JohannesDienst 15Icons made by Freepik, Good Ware, Sprang and Smashicons from www.flaticon.com
Switch to Docs-As-Code
DB Systel GmbH | Johannes Dienst | @JohannesDienst 16Icons made by Freepik, Good Ware, Sprang and Smashicons from www.flaticon.com
Advantages of Docs-As-Code
DB Systel GmbH | Johannes Dienst | @JohannesDienst 17
VonFreeSoftware
Foundation-[1],FAL,
https://commons.wikimedi
a.org/w/index.php?curid=
53428398
Icons made by Freepik, Good Ware, Sprang and Smashicons from www.flaticon.com
Advantages of Docs-As-Code
DB Systel GmbH | Johannes Dienst | @JohannesDienst 18Icons made by Freepik, Good Ware, Sprang and Smashicons from www.flaticon.com
Advantages of Docs-As-Code: Docs Review
DB Systel GmbH | Johannes Dienst | @JohannesDienst 19
main
adr-042
Icons made by Freepik, Good Ware, Sprang and Smashicons from www.flaticon.com
AsciiDoc > Markdown
DB Systel GmbH | Johannes Dienst | @JohannesDienst 20
Standard
Includes
Icons made by Freepik, Good Ware, Sprang and Smashicons from www.flaticon.com
Documentation in the Corporate Environment
DB Systel GmbH | Johannes Dienst | @JohannesDienst 21Icons made by Freepik, Good Ware, Sprang and Smashicons from www.flaticon.com
docToolchain
Docs-As-Code and arc42: A Love Story
DB Systel GmbH | Johannes Dienst | @JohannesDienst 22
Docs-As-Code and arc42: A Love Story
DB Systel GmbH | Johannes Dienst | @JohannesDienst 23
Outdated Documentation
DB Systel GmbH | Johannes Dienst | @JohannesDienst 24Icons made by Freepik, Good Ware, Sprang and Smashicons from www.flaticon.com
Architecture Decision
DB Systel GmbH | Johannes Dienst | @JohannesDienst 25
Building Block View
Deployment View
Runtime View
arc42
1. Introduction and Goals
2. Constraints
3. Context and Scope
4. Solution Strategy
5. Building Block View
6. Deployment View
7. Runtime View
8. Concepts
9. Architecture Decisions
10. Quality
11. Risks and Technical debt
11. Glossary
ADR-003: Staging- vs Cluster-Environment for CMS
We use two environments (IAT, Prod). These are set up as clusters.
DB Systel GmbH | Johannes Dienst | @JohannesDienst 26
Status
Accepted
Context
A solution is sought to ensure scalability for the entire system. The goal is to potentially serve dozens of
customers with thousands of requests per second.
Consequences
Change of system architecture necessary
‒ Dismantling of the two public instances
‒ Deconfigure push publishing
No environment is provided on which content is pushed
Alternatives
Cluster-Solution
‒ Operation of the CMS in the cluster -> Horizontal Scaling
Push Publishing
‒ Vertical Scaling
Architecture Decisions
DB Systel GmbH | Johannes Dienst | @JohannesDienst 27
DB Systel GmbH | Johannes Dienst | @JohannesDienst 28
Which two questions are still open?
Johannes.Dienst@deutschebahn.com
@JohannesDienst
DB Systel GmbH | Johannes Dienst | @JohannesDienst 29
Links
https://arc42.org/
https://leanpub.com/arc42byexample
https://www.dokchess.de/
https://github.com/joelparkerhenderson/architecture_decision_reco
rd

Weitere ähnliche Inhalte

Was ist angesagt?

Event Driven Architecture with a RESTful Microservices Architecture (Kyle Ben...
Event Driven Architecture with a RESTful Microservices Architecture (Kyle Ben...Event Driven Architecture with a RESTful Microservices Architecture (Kyle Ben...
Event Driven Architecture with a RESTful Microservices Architecture (Kyle Ben...
confluent
 
DBA Fundamentals Group: Continuous SQL with Kafka and Flink
DBA Fundamentals Group: Continuous SQL with Kafka and FlinkDBA Fundamentals Group: Continuous SQL with Kafka and Flink
DBA Fundamentals Group: Continuous SQL with Kafka and Flink
Timothy Spann
 

Was ist angesagt? (20)

Custom Reports & Integrations with GraphQL
Custom Reports & Integrations with GraphQLCustom Reports & Integrations with GraphQL
Custom Reports & Integrations with GraphQL
 
What’s New in SAP Extended ECM 16 and SAP Archiving and Document Access 16
What’s New in SAP Extended ECM 16 and SAP Archiving and Document Access 16What’s New in SAP Extended ECM 16 and SAP Archiving and Document Access 16
What’s New in SAP Extended ECM 16 and SAP Archiving and Document Access 16
 
Application Portfolio Management Webinar
Application Portfolio Management WebinarApplication Portfolio Management Webinar
Application Portfolio Management Webinar
 
Best Practices for ETL with Apache NiFi on Kubernetes - Albert Lewandowski, G...
Best Practices for ETL with Apache NiFi on Kubernetes - Albert Lewandowski, G...Best Practices for ETL with Apache NiFi on Kubernetes - Albert Lewandowski, G...
Best Practices for ETL with Apache NiFi on Kubernetes - Albert Lewandowski, G...
 
Event Driven Architecture with a RESTful Microservices Architecture (Kyle Ben...
Event Driven Architecture with a RESTful Microservices Architecture (Kyle Ben...Event Driven Architecture with a RESTful Microservices Architecture (Kyle Ben...
Event Driven Architecture with a RESTful Microservices Architecture (Kyle Ben...
 
SysML v2 - What's the big deal, anyway?
SysML v2 - What's the big deal, anyway?SysML v2 - What's the big deal, anyway?
SysML v2 - What's the big deal, anyway?
 
Introduction to Apache Flink
Introduction to Apache FlinkIntroduction to Apache Flink
Introduction to Apache Flink
 
With events to a modern integration architecture
With events to a modern integration architectureWith events to a modern integration architecture
With events to a modern integration architecture
 
Forrester Research: Total Economic Impact of the Dell Boomi Platform
Forrester Research: Total Economic Impact of the Dell Boomi PlatformForrester Research: Total Economic Impact of the Dell Boomi Platform
Forrester Research: Total Economic Impact of the Dell Boomi Platform
 
LeanIX-Signavio Integration
LeanIX-Signavio IntegrationLeanIX-Signavio Integration
LeanIX-Signavio Integration
 
Cloud Adoption
Cloud AdoptionCloud Adoption
Cloud Adoption
 
DBA Fundamentals Group: Continuous SQL with Kafka and Flink
DBA Fundamentals Group: Continuous SQL with Kafka and FlinkDBA Fundamentals Group: Continuous SQL with Kafka and Flink
DBA Fundamentals Group: Continuous SQL with Kafka and Flink
 
Open Metadata and Governance with Apache Atlas
Open Metadata and Governance with Apache AtlasOpen Metadata and Governance with Apache Atlas
Open Metadata and Governance with Apache Atlas
 
DevOps + DataOps = Digital Transformation
DevOps + DataOps = Digital Transformation DevOps + DataOps = Digital Transformation
DevOps + DataOps = Digital Transformation
 
Best practices and lessons learnt from Running Apache NiFi at Renault
Best practices and lessons learnt from Running Apache NiFi at RenaultBest practices and lessons learnt from Running Apache NiFi at Renault
Best practices and lessons learnt from Running Apache NiFi at Renault
 
Unlocking the Power of Lakehouse Architectures with Apache Pulsar and Apache ...
Unlocking the Power of Lakehouse Architectures with Apache Pulsar and Apache ...Unlocking the Power of Lakehouse Architectures with Apache Pulsar and Apache ...
Unlocking the Power of Lakehouse Architectures with Apache Pulsar and Apache ...
 
Primavera gateway SAP provider - Oracle Primavera P6 Collaborate 14
Primavera gateway SAP provider - Oracle Primavera P6 Collaborate 14Primavera gateway SAP provider - Oracle Primavera P6 Collaborate 14
Primavera gateway SAP provider - Oracle Primavera P6 Collaborate 14
 
Cloud Architecture - Multi Cloud, Edge, On-Premise
Cloud Architecture - Multi Cloud, Edge, On-PremiseCloud Architecture - Multi Cloud, Edge, On-Premise
Cloud Architecture - Multi Cloud, Edge, On-Premise
 
Elastic-Engineering
Elastic-EngineeringElastic-Engineering
Elastic-Engineering
 
Re-Architect Your Legacy Environment To Enable An Agile, Future-Ready Enterprise
Re-Architect Your Legacy Environment To Enable An Agile, Future-Ready EnterpriseRe-Architect Your Legacy Environment To Enable An Agile, Future-Ready Enterprise
Re-Architect Your Legacy Environment To Enable An Agile, Future-Ready Enterprise
 

Ähnlich wie Lessons Learned Using arc42 in a Real DevOps Team

Managed Cloud to GitOps: Deploying Several Client Clusters
Managed Cloud to GitOps: Deploying Several Client ClustersManaged Cloud to GitOps: Deploying Several Client Clusters
Managed Cloud to GitOps: Deploying Several Client Clusters
Johannes Dienst
 
Managed Cloud to GitOps: Deploying Several Client Clusters
Managed Cloud to GitOps: Deploying Several Client ClustersManaged Cloud to GitOps: Deploying Several Client Clusters
Managed Cloud to GitOps: Deploying Several Client Clusters
Johannes Dienst
 
Built -aia_southern_arizona_article_draft_v8_send
Built  -aia_southern_arizona_article_draft_v8_sendBuilt  -aia_southern_arizona_article_draft_v8_send
Built -aia_southern_arizona_article_draft_v8_send
Mike Bordenaro
 
Hyperion planning integration with odi
Hyperion planning integration with odiHyperion planning integration with odi
Hyperion planning integration with odi
Amit Sharma
 

Ähnlich wie Lessons Learned Using arc42 in a Real DevOps Team (20)

Managed Cloud to GitOps: Deploying Several Client Clusters
Managed Cloud to GitOps: Deploying Several Client ClustersManaged Cloud to GitOps: Deploying Several Client Clusters
Managed Cloud to GitOps: Deploying Several Client Clusters
 
Managed Cloud to GitOps: Deploying Several Client Clusters
Managed Cloud to GitOps: Deploying Several Client ClustersManaged Cloud to GitOps: Deploying Several Client Clusters
Managed Cloud to GitOps: Deploying Several Client Clusters
 
Work efficiently with Architecture Decision Records
Work efficiently with Architecture Decision RecordsWork efficiently with Architecture Decision Records
Work efficiently with Architecture Decision Records
 
OpenAsset + Deltek Vision = Enhanced marketing capabilities
OpenAsset + Deltek Vision = Enhanced marketing capabilitiesOpenAsset + Deltek Vision = Enhanced marketing capabilities
OpenAsset + Deltek Vision = Enhanced marketing capabilities
 
Graphs for Enterprise Architects
Graphs for Enterprise ArchitectsGraphs for Enterprise Architects
Graphs for Enterprise Architects
 
Using an openBim Workflow
Using an openBim WorkflowUsing an openBim Workflow
Using an openBim Workflow
 
Scan to BIM: Step by step process of inserting point cloud data into Revit!
Scan to BIM: Step by step process of inserting point cloud data into Revit!Scan to BIM: Step by step process of inserting point cloud data into Revit!
Scan to BIM: Step by step process of inserting point cloud data into Revit!
 
Web Performance & You
Web Performance & YouWeb Performance & You
Web Performance & You
 
BIMwm - local BIM when you need it
BIMwm - local BIM when you need itBIMwm - local BIM when you need it
BIMwm - local BIM when you need it
 
R Michael Pickering CBIP
R Michael Pickering CBIPR Michael Pickering CBIP
R Michael Pickering CBIP
 
Big Data LDN 2018: A TALE OF TWO BI STANDARDS: DATA WAREHOUSES AND DATA LAKES
Big Data LDN 2018: A TALE OF TWO BI STANDARDS: DATA WAREHOUSES AND DATA LAKESBig Data LDN 2018: A TALE OF TWO BI STANDARDS: DATA WAREHOUSES AND DATA LAKES
Big Data LDN 2018: A TALE OF TWO BI STANDARDS: DATA WAREHOUSES AND DATA LAKES
 
Why marketers are the real winners with Sitecore XM Cloud
Why marketers are the real winners with Sitecore XM CloudWhy marketers are the real winners with Sitecore XM Cloud
Why marketers are the real winners with Sitecore XM Cloud
 
The Art of Web Design, 101
The Art of Web Design, 101The Art of Web Design, 101
The Art of Web Design, 101
 
Modern Data Platforms
Modern Data Platforms Modern Data Platforms
Modern Data Platforms
 
edeploy
edeployedeploy
edeploy
 
Enterprise Architecture 2012
Enterprise Architecture 2012Enterprise Architecture 2012
Enterprise Architecture 2012
 
Summit 2017 cyber delivery v4 long version
Summit 2017 cyber delivery v4 long versionSummit 2017 cyber delivery v4 long version
Summit 2017 cyber delivery v4 long version
 
Built -aia_southern_arizona_article_draft_v8_send
Built  -aia_southern_arizona_article_draft_v8_sendBuilt  -aia_southern_arizona_article_draft_v8_send
Built -aia_southern_arizona_article_draft_v8_send
 
Hyperion planning integration with odi
Hyperion planning integration with odiHyperion planning integration with odi
Hyperion planning integration with odi
 
Keynote SUGCON 2021 - Sitecore and SaaS our shared journey
Keynote SUGCON 2021 - Sitecore and SaaS our shared journeyKeynote SUGCON 2021 - Sitecore and SaaS our shared journey
Keynote SUGCON 2021 - Sitecore and SaaS our shared journey
 

Mehr von Johannes Dienst

Stoizismus - Praktische Philosophie für den IT-Alltag (Pecha Kucha)
Stoizismus - Praktische Philosophie für den IT-Alltag (Pecha Kucha)Stoizismus - Praktische Philosophie für den IT-Alltag (Pecha Kucha)
Stoizismus - Praktische Philosophie für den IT-Alltag (Pecha Kucha)
Johannes Dienst
 
Von Managed-Cloud zu GitOps - Multi Client-Cluster Deployments
Von Managed-Cloud zu GitOps - Multi Client-Cluster DeploymentsVon Managed-Cloud zu GitOps - Multi Client-Cluster Deployments
Von Managed-Cloud zu GitOps - Multi Client-Cluster Deployments
Johannes Dienst
 
Griechische Philosophie für moderne Softwareentwicklung
Griechische Philosophie für moderne SoftwareentwicklungGriechische Philosophie für moderne Softwareentwicklung
Griechische Philosophie für moderne Softwareentwicklung
Johannes Dienst
 
Effizient arbeiten mit Architecture Decision Records (ADR)
Effizient arbeiten mit Architecture Decision Records (ADR)Effizient arbeiten mit Architecture Decision Records (ADR)
Effizient arbeiten mit Architecture Decision Records (ADR)
Johannes Dienst
 
Pride & Prejudice: Teambildung & Motivation im agilen Umfeld
Pride & Prejudice: Teambildung & Motivation im agilen UmfeldPride & Prejudice: Teambildung & Motivation im agilen Umfeld
Pride & Prejudice: Teambildung & Motivation im agilen Umfeld
Johannes Dienst
 

Mehr von Johannes Dienst (20)

Developer Relations Metrics - A Humble Guide
Developer Relations Metrics - A Humble GuideDeveloper Relations Metrics - A Humble Guide
Developer Relations Metrics - A Humble Guide
 
Real Cross-Platform Workflow UI Automation_JohannesDienst.pdf
Real Cross-Platform Workflow UI Automation_JohannesDienst.pdfReal Cross-Platform Workflow UI Automation_JohannesDienst.pdf
Real Cross-Platform Workflow UI Automation_JohannesDienst.pdf
 
The Future of UI Testing - Challenges in UI Automation
The Future of UI Testing - Challenges in UI AutomationThe Future of UI Testing - Challenges in UI Automation
The Future of UI Testing - Challenges in UI Automation
 
Rock Solid Software Architecture with ADRs, arc42 and Microsites
Rock Solid Software Architecture with ADRs, arc42 and MicrositesRock Solid Software Architecture with ADRs, arc42 and Microsites
Rock Solid Software Architecture with ADRs, arc42 and Microsites
 
Stoizismus - Praktische Philosophie für den IT-Alltag (Pecha Kucha)
Stoizismus - Praktische Philosophie für den IT-Alltag (Pecha Kucha)Stoizismus - Praktische Philosophie für den IT-Alltag (Pecha Kucha)
Stoizismus - Praktische Philosophie für den IT-Alltag (Pecha Kucha)
 
Von Managed-Cloud zu GitOps - Multi Client-Cluster Deployments
Von Managed-Cloud zu GitOps - Multi Client-Cluster DeploymentsVon Managed-Cloud zu GitOps - Multi Client-Cluster Deployments
Von Managed-Cloud zu GitOps - Multi Client-Cluster Deployments
 
Griechische Philosophie für moderne Softwareentwicklung
Griechische Philosophie für moderne SoftwareentwicklungGriechische Philosophie für moderne Softwareentwicklung
Griechische Philosophie für moderne Softwareentwicklung
 
Lessons Learned: arc42 in einem echten DevOps Team
Lessons Learned: arc42 in einem echten DevOps TeamLessons Learned: arc42 in einem echten DevOps Team
Lessons Learned: arc42 in einem echten DevOps Team
 
The Dev, The Ops, And The Team: What works in a DevOps Team?
The Dev, The Ops, And The Team: What works in a DevOps Team?The Dev, The Ops, And The Team: What works in a DevOps Team?
The Dev, The Ops, And The Team: What works in a DevOps Team?
 
Effizient arbeiten mit Architecture Decision Records (ADR)
Effizient arbeiten mit Architecture Decision Records (ADR)Effizient arbeiten mit Architecture Decision Records (ADR)
Effizient arbeiten mit Architecture Decision Records (ADR)
 
Leichtgewichtige Softwarearchitektur mit Architecture Decision Records und Qu...
Leichtgewichtige Softwarearchitektur mit Architecture Decision Records und Qu...Leichtgewichtige Softwarearchitektur mit Architecture Decision Records und Qu...
Leichtgewichtige Softwarearchitektur mit Architecture Decision Records und Qu...
 
Spock vs Supermutanten: Spezifikationstesten trifft Mutationstesten
Spock vs Supermutanten: Spezifikationstesten trifft MutationstestenSpock vs Supermutanten: Spezifikationstesten trifft Mutationstesten
Spock vs Supermutanten: Spezifikationstesten trifft Mutationstesten
 
Everything as Code: Pipeline, Infrastructure, Configuration, Documentation
Everything as Code: Pipeline, Infrastructure, Configuration, DocumentationEverything as Code: Pipeline, Infrastructure, Configuration, Documentation
Everything as Code: Pipeline, Infrastructure, Configuration, Documentation
 
DevOps im Konzern - Autonomie vs Betriebssicherheit (Continuous Lifecycle)
DevOps im Konzern - Autonomie vs Betriebssicherheit (Continuous Lifecycle)DevOps im Konzern - Autonomie vs Betriebssicherheit (Continuous Lifecycle)
DevOps im Konzern - Autonomie vs Betriebssicherheit (Continuous Lifecycle)
 
Leichtgewichtige Softwarearchitektur mit Architecture Decision Records und Qu...
Leichtgewichtige Softwarearchitektur mit Architecture Decision Records und Qu...Leichtgewichtige Softwarearchitektur mit Architecture Decision Records und Qu...
Leichtgewichtige Softwarearchitektur mit Architecture Decision Records und Qu...
 
Pride & Prejudice: Teambildung & Motivation im agilen Umfeld
Pride & Prejudice: Teambildung & Motivation im agilen UmfeldPride & Prejudice: Teambildung & Motivation im agilen Umfeld
Pride & Prejudice: Teambildung & Motivation im agilen Umfeld
 
Leichtgewichtige Softwarearchitektur mit Architecture Decision Records und Qu...
Leichtgewichtige Softwarearchitektur mit Architecture Decision Records und Qu...Leichtgewichtige Softwarearchitektur mit Architecture Decision Records und Qu...
Leichtgewichtige Softwarearchitektur mit Architecture Decision Records und Qu...
 
Leichtgewichtige Softwarearchitektur mit Architecture Decision Records und Qu...
Leichtgewichtige Softwarearchitektur mit Architecture Decision Records und Qu...Leichtgewichtige Softwarearchitektur mit Architecture Decision Records und Qu...
Leichtgewichtige Softwarearchitektur mit Architecture Decision Records und Qu...
 
DevOps im Konzern: Autonomie vs Betriebssicherheit
DevOps im Konzern: Autonomie vs BetriebssicherheitDevOps im Konzern: Autonomie vs Betriebssicherheit
DevOps im Konzern: Autonomie vs Betriebssicherheit
 
Und wer testet die Tests? - Mutationstesten mit PIT
Und wer testet die Tests? - Mutationstesten mit PITUnd wer testet die Tests? - Mutationstesten mit PIT
Und wer testet die Tests? - Mutationstesten mit PIT
 

Kürzlich hochgeladen

AI Mastery 201: Elevating Your Workflow with Advanced LLM Techniques
AI Mastery 201: Elevating Your Workflow with Advanced LLM TechniquesAI Mastery 201: Elevating Your Workflow with Advanced LLM Techniques
AI Mastery 201: Elevating Your Workflow with Advanced LLM Techniques
VictorSzoltysek
 
TECUNIQUE: Success Stories: IT Service provider
TECUNIQUE: Success Stories: IT Service providerTECUNIQUE: Success Stories: IT Service provider
TECUNIQUE: Success Stories: IT Service provider
mohitmore19
 

Kürzlich hochgeladen (20)

Reassessing the Bedrock of Clinical Function Models: An Examination of Large ...
Reassessing the Bedrock of Clinical Function Models: An Examination of Large ...Reassessing the Bedrock of Clinical Function Models: An Examination of Large ...
Reassessing the Bedrock of Clinical Function Models: An Examination of Large ...
 
AI Mastery 201: Elevating Your Workflow with Advanced LLM Techniques
AI Mastery 201: Elevating Your Workflow with Advanced LLM TechniquesAI Mastery 201: Elevating Your Workflow with Advanced LLM Techniques
AI Mastery 201: Elevating Your Workflow with Advanced LLM Techniques
 
Diamond Application Development Crafting Solutions with Precision
Diamond Application Development Crafting Solutions with PrecisionDiamond Application Development Crafting Solutions with Precision
Diamond Application Development Crafting Solutions with Precision
 
The Guide to Integrating Generative AI into Unified Continuous Testing Platfo...
The Guide to Integrating Generative AI into Unified Continuous Testing Platfo...The Guide to Integrating Generative AI into Unified Continuous Testing Platfo...
The Guide to Integrating Generative AI into Unified Continuous Testing Platfo...
 
How to Choose the Right Laravel Development Partner in New York City_compress...
How to Choose the Right Laravel Development Partner in New York City_compress...How to Choose the Right Laravel Development Partner in New York City_compress...
How to Choose the Right Laravel Development Partner in New York City_compress...
 
How To Use Server-Side Rendering with Nuxt.js
How To Use Server-Side Rendering with Nuxt.jsHow To Use Server-Side Rendering with Nuxt.js
How To Use Server-Side Rendering with Nuxt.js
 
Learn the Fundamentals of XCUITest Framework_ A Beginner's Guide.pdf
Learn the Fundamentals of XCUITest Framework_ A Beginner's Guide.pdfLearn the Fundamentals of XCUITest Framework_ A Beginner's Guide.pdf
Learn the Fundamentals of XCUITest Framework_ A Beginner's Guide.pdf
 
8257 interfacing 2 in microprocessor for btech students
8257 interfacing 2 in microprocessor for btech students8257 interfacing 2 in microprocessor for btech students
8257 interfacing 2 in microprocessor for btech students
 
Optimizing AI for immediate response in Smart CCTV
Optimizing AI for immediate response in Smart CCTVOptimizing AI for immediate response in Smart CCTV
Optimizing AI for immediate response in Smart CCTV
 
Define the academic and professional writing..pdf
Define the academic and professional writing..pdfDefine the academic and professional writing..pdf
Define the academic and professional writing..pdf
 
Software Quality Assurance Interview Questions
Software Quality Assurance Interview QuestionsSoftware Quality Assurance Interview Questions
Software Quality Assurance Interview Questions
 
Direct Style Effect Systems - The Print[A] Example - A Comprehension Aid
Direct Style Effect Systems -The Print[A] Example- A Comprehension AidDirect Style Effect Systems -The Print[A] Example- A Comprehension Aid
Direct Style Effect Systems - The Print[A] Example - A Comprehension Aid
 
Introducing Microsoft’s new Enterprise Work Management (EWM) Solution
Introducing Microsoft’s new Enterprise Work Management (EWM) SolutionIntroducing Microsoft’s new Enterprise Work Management (EWM) Solution
Introducing Microsoft’s new Enterprise Work Management (EWM) Solution
 
Tech Tuesday-Harness the Power of Effective Resource Planning with OnePlan’s ...
Tech Tuesday-Harness the Power of Effective Resource Planning with OnePlan’s ...Tech Tuesday-Harness the Power of Effective Resource Planning with OnePlan’s ...
Tech Tuesday-Harness the Power of Effective Resource Planning with OnePlan’s ...
 
W01_panagenda_Navigating-the-Future-with-The-Hitchhikers-Guide-to-Notes-and-D...
W01_panagenda_Navigating-the-Future-with-The-Hitchhikers-Guide-to-Notes-and-D...W01_panagenda_Navigating-the-Future-with-The-Hitchhikers-Guide-to-Notes-and-D...
W01_panagenda_Navigating-the-Future-with-The-Hitchhikers-Guide-to-Notes-and-D...
 
Shapes for Sharing between Graph Data Spaces - and Epistemic Querying of RDF-...
Shapes for Sharing between Graph Data Spaces - and Epistemic Querying of RDF-...Shapes for Sharing between Graph Data Spaces - and Epistemic Querying of RDF-...
Shapes for Sharing between Graph Data Spaces - and Epistemic Querying of RDF-...
 
TECUNIQUE: Success Stories: IT Service provider
TECUNIQUE: Success Stories: IT Service providerTECUNIQUE: Success Stories: IT Service provider
TECUNIQUE: Success Stories: IT Service provider
 
A Secure and Reliable Document Management System is Essential.docx
A Secure and Reliable Document Management System is Essential.docxA Secure and Reliable Document Management System is Essential.docx
A Secure and Reliable Document Management System is Essential.docx
 
10 Trends Likely to Shape Enterprise Technology in 2024
10 Trends Likely to Shape Enterprise Technology in 202410 Trends Likely to Shape Enterprise Technology in 2024
10 Trends Likely to Shape Enterprise Technology in 2024
 
call girls in Vaishali (Ghaziabad) 🔝 >༒8448380779 🔝 genuine Escort Service 🔝✔️✔️
call girls in Vaishali (Ghaziabad) 🔝 >༒8448380779 🔝 genuine Escort Service 🔝✔️✔️call girls in Vaishali (Ghaziabad) 🔝 >༒8448380779 🔝 genuine Escort Service 🔝✔️✔️
call girls in Vaishali (Ghaziabad) 🔝 >༒8448380779 🔝 genuine Escort Service 🔝✔️✔️
 

Lessons Learned Using arc42 in a Real DevOps Team

  • 1. arc42 in a Real DevOps Team Lessons Learned DB Systel GmbH | Johannes Dienst | @JohannesDienst
  • 2. Digital partner of Deutsche Bahn DB Systel GmbH | Johannes Dienst | @JohannesDienst 2
  • 3. DB Content Hub DB Systel GmbH | Johannes Dienst | @JohannesDienst 3 ‒ Content as a Service (CaaS) ‒ Headless CMS ‒ Self hosted in Cloud ‒ You build it, you run it!
  • 4. Product Development DB Systel GmbH | Johannes Dienst | @JohannesDienst 4
  • 5. The Cost of Poor Documentation DB Systel GmbH | Johannes Dienst | @JohannesDienst 5Icons made by Freepik, Good Ware, Sprang and Smashicons from www.flaticon.com
  • 6. The Cost of Poor Documentation DB Systel GmbH | Johannes Dienst | @JohannesDienst 6Icons made by Freepik, Good Ware, Sprang and Smashicons from www.flaticon.com
  • 7. arc42 DB Systel GmbH | Johannes Dienst | @JohannesDienst 7
  • 8. arc42 DB Systel GmbH | Johannes Dienst | @JohannesDienst 8 Building Block View Deployment View Runtime View arc42 1. Introduction and Goals 2. Constraints 3. Context and Scope 4. Solution Strategy 5. Building Block View 6. Deployment View 7. Runtime View 8. Concepts 9. Architecture Decisions 10. Quality 11. Risks and Technical debt 11. Glossary
  • 9. Technical Architecture in a Devops Team DB Systel GmbH | Johannes Dienst | @JohannesDienst 9 Betriebshandbuch Icons made by Freepik, Good Ware, Sprang and Smashicons from www.flaticon.com
  • 10. Must Haves DB Systel GmbH | Johannes Dienst | @JohannesDienst 10 ‒ Introduction and Goals ‒ Constraints ‒ Context and Scope ‒ Solution Strategy ‒ (Building block view) ‒ (Deployment view) ‒ (Runtime view) ‒ Concepts ‒ Architecture Decisions ‒ Quality ‒ Risks and technical Debt ‒ Glossary
  • 11. Glossary DB Systel GmbH | Johannes Dienst | @JohannesDienst 11 Content Asset Content Type Icons made by Freepik, Good Ware, Sprang and Smashicons from www.flaticon.com
  • 12. A Wiki Is Born DB Systel GmbH | Johannes Dienst | @JohannesDienst 12Icons made by Freepik, Good Ware, Sprang and Smashicons from www.flaticon.com
  • 13. Technical Architecture Documentation!= Tutorial DB Systel GmbH | Johannes Dienst | @JohannesDienst 13Icons made by Freepik, Good Ware, Sprang and Smashicons from www.flaticon.com
  • 14. The Wiki Is a Problem Child DB Systel GmbH | Johannes Dienst | @JohannesDienst 14Icons made by Freepik, Good Ware, Sprang and Smashicons from www.flaticon.com
  • 15. The Wiki Is a Problem Child DB Systel GmbH | Johannes Dienst | @JohannesDienst 15Icons made by Freepik, Good Ware, Sprang and Smashicons from www.flaticon.com
  • 16. Switch to Docs-As-Code DB Systel GmbH | Johannes Dienst | @JohannesDienst 16Icons made by Freepik, Good Ware, Sprang and Smashicons from www.flaticon.com
  • 17. Advantages of Docs-As-Code DB Systel GmbH | Johannes Dienst | @JohannesDienst 17 VonFreeSoftware Foundation-[1],FAL, https://commons.wikimedi a.org/w/index.php?curid= 53428398 Icons made by Freepik, Good Ware, Sprang and Smashicons from www.flaticon.com
  • 18. Advantages of Docs-As-Code DB Systel GmbH | Johannes Dienst | @JohannesDienst 18Icons made by Freepik, Good Ware, Sprang and Smashicons from www.flaticon.com
  • 19. Advantages of Docs-As-Code: Docs Review DB Systel GmbH | Johannes Dienst | @JohannesDienst 19 main adr-042 Icons made by Freepik, Good Ware, Sprang and Smashicons from www.flaticon.com
  • 20. AsciiDoc > Markdown DB Systel GmbH | Johannes Dienst | @JohannesDienst 20 Standard Includes Icons made by Freepik, Good Ware, Sprang and Smashicons from www.flaticon.com
  • 21. Documentation in the Corporate Environment DB Systel GmbH | Johannes Dienst | @JohannesDienst 21Icons made by Freepik, Good Ware, Sprang and Smashicons from www.flaticon.com docToolchain
  • 22. Docs-As-Code and arc42: A Love Story DB Systel GmbH | Johannes Dienst | @JohannesDienst 22
  • 23. Docs-As-Code and arc42: A Love Story DB Systel GmbH | Johannes Dienst | @JohannesDienst 23
  • 24. Outdated Documentation DB Systel GmbH | Johannes Dienst | @JohannesDienst 24Icons made by Freepik, Good Ware, Sprang and Smashicons from www.flaticon.com
  • 25. Architecture Decision DB Systel GmbH | Johannes Dienst | @JohannesDienst 25 Building Block View Deployment View Runtime View arc42 1. Introduction and Goals 2. Constraints 3. Context and Scope 4. Solution Strategy 5. Building Block View 6. Deployment View 7. Runtime View 8. Concepts 9. Architecture Decisions 10. Quality 11. Risks and Technical debt 11. Glossary
  • 26. ADR-003: Staging- vs Cluster-Environment for CMS We use two environments (IAT, Prod). These are set up as clusters. DB Systel GmbH | Johannes Dienst | @JohannesDienst 26 Status Accepted Context A solution is sought to ensure scalability for the entire system. The goal is to potentially serve dozens of customers with thousands of requests per second. Consequences Change of system architecture necessary ‒ Dismantling of the two public instances ‒ Deconfigure push publishing No environment is provided on which content is pushed Alternatives Cluster-Solution ‒ Operation of the CMS in the cluster -> Horizontal Scaling Push Publishing ‒ Vertical Scaling
  • 27. Architecture Decisions DB Systel GmbH | Johannes Dienst | @JohannesDienst 27
  • 28. DB Systel GmbH | Johannes Dienst | @JohannesDienst 28 Which two questions are still open? Johannes.Dienst@deutschebahn.com @JohannesDienst
  • 29. DB Systel GmbH | Johannes Dienst | @JohannesDienst 29 Links https://arc42.org/ https://leanpub.com/arc42byexample https://www.dokchess.de/ https://github.com/joelparkerhenderson/architecture_decision_reco rd

Hinweis der Redaktion

  1. Schnelllebig durch kurze Iterationszyklen Fehler werden gemacht und daraus wird gelernt Kostendruck Agile Entwicklung im DevOps-Produktionsmodell Kundenorientiert (Muffin)
  2. Schnelllebig durch kurze Iterationszyklen „Dokumentation ist nicht agil“ -> Talk von Kevin Goldsmith verlinken Hinleitung auf nächste Folie: Warum ist Dokumentation denn wichtig?
  3. Warum dokumentiere ich eigentlich? -> OnBoarding sonst zeitintensiv, Zertifizierung im Konzernumfeld Für andere Teams „Für mich selbst“
  4. Frage stellen: Wer kennt arc42?
  5. Hier noch nichts drüber erzählen, warum das gerade für DevOps-Teams gut ist!!! Kommt auf nächster Folie
  6. Arc42 eignet sich perfekt für DevOps-Teams * Struktur ist immer gleich -> Schnelle Einarbeitung * Leichtgewichtig: Nicht alle Kapitel müssen ausgefüllt werden * Dokumentiere, was du lesen willst * Kapitel teilweise wiederverwendbar in Betriebshandbüchern
  7. Hier erläutern: Einführung und Ziele Randbedingungen Kontextabgrenzung Querschnittliche Konzepte
  8. Haben wir nie ausgefüllt -> Immer wieder reden wir aneinander vorbei 
  9. Leicht zu benutzen Leichtes Setup -> Einfach bestellen und schon ist es da Erwartung: Da wird mir die Welt erklärt!
  10. Oft Tutorialähnliches in arc42 Lieber in Readme des Repos
  11. Wiki hat folgende Probleme * Information geht da zum Sterben hin: Symbolisiert Icon 1 * Jeder kann einfach Braindumpen -> Entwicklerprosa Icon2 * Kommentarfunktion * Vermischung von fachlichen und technischen Themen Was fehlt noch? Siehe nächste Folie
  12. * Kein Review -> Qualität ist schlecht * Versionierbarkeit?! Stressen, dass das Tool der entscheidende Faktor ist, ob Dokumentation genutzt wird oder nicht!
  13. Was ist das überhaupt?
  14. Entwicklerwerkzeuge WYSIWYM -> Plain Text (Endlich kein Formatierungskrieg mehr!)
  15. WYSIWYM -> Plain Text (Endlich kein Formatierungskrieg mehr!)
  16. Entwicklerwerkzeuge Qualitätssicherung über Feature Branches WYSIWYM -> Plain Text (Endlich kein Formatierungskrieg mehr!)
  17. Warum Liebesgeschichte? 1. Jedes Kapitel in eigene adoc-Datei 2. Kann diese Dateien dann zusammenincluden wie ich will
  18. Kann nicht nur geforderte Dokumente daraus generieren Sondern auch Microsite: - Leicht Indizierbar in interner Suchmaschine - Einfach durchsuchbar - Angenehm zu benutzen
  19. Wegwerfen, da im VCS noch vorhanden: Wie geil ist das denn? Feste Termine einplanen, um die Architektur immer wieder glattzuziehen: Geht leider nicht anders 
  20. Für unser Team fast das Wichtigste 1-2 Minuten etwas darüber erzählen
  21. Für unser Team fast das Wichtigste 1-2 Minuten etwas darüber erzählen
  22. Für unser Team fast das Wichtigste 1-2 Minuten etwas darüber erzählen