SlideShare a Scribd company logo
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

More Related Content

What's hot

Introduction to NoSQL Databases
Introduction to NoSQL DatabasesIntroduction to NoSQL Databases
Introduction to NoSQL Databases
Derek Stainer
 

What's hot (20)

Oracle SOA Suite in use – a practical experience report
Oracle SOA Suite in use – a practical experience reportOracle SOA Suite in use – a practical experience report
Oracle SOA Suite in use – a practical experience report
 
Apache hive
Apache hiveApache hive
Apache hive
 
Sqoop
SqoopSqoop
Sqoop
 
Troubleshooting Kerberos in Hadoop: Taming the Beast
Troubleshooting Kerberos in Hadoop: Taming the BeastTroubleshooting Kerberos in Hadoop: Taming the Beast
Troubleshooting Kerberos in Hadoop: Taming the Beast
 
IBM Integration Bus & WebSphere MQ - High Availability & Disaster Recovery
IBM Integration Bus & WebSphere MQ - High Availability & Disaster RecoveryIBM Integration Bus & WebSphere MQ - High Availability & Disaster Recovery
IBM Integration Bus & WebSphere MQ - High Availability & Disaster Recovery
 
Oracle Data Integrator 12c - Getting Started
Oracle Data Integrator 12c - Getting StartedOracle Data Integrator 12c - Getting Started
Oracle Data Integrator 12c - Getting Started
 
Introducing Delta Live Tables: Make Reliable ETL Easy on Delta Lake
Introducing Delta Live Tables: Make Reliable ETL Easy on Delta LakeIntroducing Delta Live Tables: Make Reliable ETL Easy on Delta Lake
Introducing Delta Live Tables: Make Reliable ETL Easy on Delta Lake
 
Microservices Patterns with GoldenGate
Microservices Patterns with GoldenGateMicroservices Patterns with GoldenGate
Microservices Patterns with GoldenGate
 
MongoDB Fundamentals
MongoDB FundamentalsMongoDB Fundamentals
MongoDB Fundamentals
 
NoSQL Databases
NoSQL DatabasesNoSQL Databases
NoSQL Databases
 
An overview of reference architectures for Postgres
An overview of reference architectures for PostgresAn overview of reference architectures for Postgres
An overview of reference architectures for Postgres
 
6.hive
6.hive6.hive
6.hive
 
Ten Reasons Why You Should Prefer PostgreSQL to MySQL
Ten Reasons Why You Should Prefer PostgreSQL to MySQLTen Reasons Why You Should Prefer PostgreSQL to MySQL
Ten Reasons Why You Should Prefer PostgreSQL to MySQL
 
Couchbase Performance Benchmarking
Couchbase Performance BenchmarkingCouchbase Performance Benchmarking
Couchbase Performance Benchmarking
 
Relational RDBMS : MySQL, PostgreSQL and SQL SERVER
Relational RDBMS  : MySQL, PostgreSQL and SQL SERVERRelational RDBMS  : MySQL, PostgreSQL and SQL SERVER
Relational RDBMS : MySQL, PostgreSQL and SQL SERVER
 
Apache Spark overview
Apache Spark overviewApache Spark overview
Apache Spark overview
 
Reducing Database Pain & Costs with Postgres
Reducing Database Pain & Costs with PostgresReducing Database Pain & Costs with Postgres
Reducing Database Pain & Costs with Postgres
 
Oracle Data Integrator
Oracle Data Integrator Oracle Data Integrator
Oracle Data Integrator
 
Getting Ready to Use Redis with Apache Spark with Dvir Volk
Getting Ready to Use Redis with Apache Spark with Dvir VolkGetting Ready to Use Redis with Apache Spark with Dvir Volk
Getting Ready to Use Redis with Apache Spark with Dvir Volk
 
Introduction to NoSQL Databases
Introduction to NoSQL DatabasesIntroduction to NoSQL Databases
Introduction to NoSQL Databases
 

Similar to 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
 

Similar to 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
 

More from 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
 

More from 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
 

Recently uploaded

AI/ML Infra Meetup | Improve Speed and GPU Utilization for Model Training & S...
AI/ML Infra Meetup | Improve Speed and GPU Utilization for Model Training & S...AI/ML Infra Meetup | Improve Speed and GPU Utilization for Model Training & S...
AI/ML Infra Meetup | Improve Speed and GPU Utilization for Model Training & S...
Alluxio, Inc.
 

Recently uploaded (20)

AI/ML Infra Meetup | Improve Speed and GPU Utilization for Model Training & S...
AI/ML Infra Meetup | Improve Speed and GPU Utilization for Model Training & S...AI/ML Infra Meetup | Improve Speed and GPU Utilization for Model Training & S...
AI/ML Infra Meetup | Improve Speed and GPU Utilization for Model Training & S...
 
Beyond Event Sourcing - Embracing CRUD for Wix Platform - Java.IL
Beyond Event Sourcing - Embracing CRUD for Wix Platform - Java.ILBeyond Event Sourcing - Embracing CRUD for Wix Platform - Java.IL
Beyond Event Sourcing - Embracing CRUD for Wix Platform - Java.IL
 
Crafting the Perfect Measurement Sheet with PLM Integration
Crafting the Perfect Measurement Sheet with PLM IntegrationCrafting the Perfect Measurement Sheet with PLM Integration
Crafting the Perfect Measurement Sheet with PLM Integration
 
Using IESVE for Room Loads Analysis - Australia & New Zealand
Using IESVE for Room Loads Analysis - Australia & New ZealandUsing IESVE for Room Loads Analysis - Australia & New Zealand
Using IESVE for Room Loads Analysis - Australia & New Zealand
 
Studiovity film pre-production and screenwriting software
Studiovity film pre-production and screenwriting softwareStudiovity film pre-production and screenwriting software
Studiovity film pre-production and screenwriting software
 
Corporate Management | Session 3 of 3 | Tendenci AMS
Corporate Management | Session 3 of 3 | Tendenci AMSCorporate Management | Session 3 of 3 | Tendenci AMS
Corporate Management | Session 3 of 3 | Tendenci AMS
 
AI/ML Infra Meetup | Reducing Prefill for LLM Serving in RAG
AI/ML Infra Meetup | Reducing Prefill for LLM Serving in RAGAI/ML Infra Meetup | Reducing Prefill for LLM Serving in RAG
AI/ML Infra Meetup | Reducing Prefill for LLM Serving in RAG
 
Facemoji Keyboard released its 2023 State of Emoji report, outlining the most...
Facemoji Keyboard released its 2023 State of Emoji report, outlining the most...Facemoji Keyboard released its 2023 State of Emoji report, outlining the most...
Facemoji Keyboard released its 2023 State of Emoji report, outlining the most...
 
Into the Box 2024 - Keynote Day 2 Slides.pdf
Into the Box 2024 - Keynote Day 2 Slides.pdfInto the Box 2024 - Keynote Day 2 Slides.pdf
Into the Box 2024 - Keynote Day 2 Slides.pdf
 
WSO2Con2024 - WSO2's IAM Vision: Identity-Led Digital Transformation
WSO2Con2024 - WSO2's IAM Vision: Identity-Led Digital TransformationWSO2Con2024 - WSO2's IAM Vision: Identity-Led Digital Transformation
WSO2Con2024 - WSO2's IAM Vision: Identity-Led Digital Transformation
 
Field Employee Tracking System| MiTrack App| Best Employee Tracking Solution|...
Field Employee Tracking System| MiTrack App| Best Employee Tracking Solution|...Field Employee Tracking System| MiTrack App| Best Employee Tracking Solution|...
Field Employee Tracking System| MiTrack App| Best Employee Tracking Solution|...
 
AI/ML Infra Meetup | ML explainability in Michelangelo
AI/ML Infra Meetup | ML explainability in MichelangeloAI/ML Infra Meetup | ML explainability in Michelangelo
AI/ML Infra Meetup | ML explainability in Michelangelo
 
Accelerate Enterprise Software Engineering with Platformless
Accelerate Enterprise Software Engineering with PlatformlessAccelerate Enterprise Software Engineering with Platformless
Accelerate Enterprise Software Engineering with Platformless
 
De mooiste recreatieve routes ontdekken met RouteYou en FME
De mooiste recreatieve routes ontdekken met RouteYou en FMEDe mooiste recreatieve routes ontdekken met RouteYou en FME
De mooiste recreatieve routes ontdekken met RouteYou en FME
 
AI/ML Infra Meetup | Perspective on Deep Learning Framework
AI/ML Infra Meetup | Perspective on Deep Learning FrameworkAI/ML Infra Meetup | Perspective on Deep Learning Framework
AI/ML Infra Meetup | Perspective on Deep Learning Framework
 
Breaking the Code : A Guide to WhatsApp Business API.pdf
Breaking the Code : A Guide to WhatsApp Business API.pdfBreaking the Code : A Guide to WhatsApp Business API.pdf
Breaking the Code : A Guide to WhatsApp Business API.pdf
 
SOCRadar Research Team: Latest Activities of IntelBroker
SOCRadar Research Team: Latest Activities of IntelBrokerSOCRadar Research Team: Latest Activities of IntelBroker
SOCRadar Research Team: Latest Activities of IntelBroker
 
A Python-based approach to data loading in TM1 - Using Airflow as an ETL for TM1
A Python-based approach to data loading in TM1 - Using Airflow as an ETL for TM1A Python-based approach to data loading in TM1 - Using Airflow as an ETL for TM1
A Python-based approach to data loading in TM1 - Using Airflow as an ETL for TM1
 
GraphAware - Transforming policing with graph-based intelligence analysis
GraphAware - Transforming policing with graph-based intelligence analysisGraphAware - Transforming policing with graph-based intelligence analysis
GraphAware - Transforming policing with graph-based intelligence analysis
 
Top Mobile App Development Companies 2024
Top Mobile App Development Companies 2024Top Mobile App Development Companies 2024
Top Mobile App Development Companies 2024
 

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

Editor's Notes

  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