Giter Site home page Giter Site logo

azadr's Introduction

Azure Architecture Decision Records (AzADR)

Decision Sets

Decision Set: Select an Enterprise Scale Landing Zone Reference Architecture

Other Documents

Cloud Adoption Framework - Functions & Roles Assignment

What is the AzADR Toolkit?

The AzADR toolkit is a repository of standard architecture decision records for common Azure decisions. By providing templates with many considerations already populated, users of this repository can be guided through complex decisions.

Organizations can use these decision records to rapidly guide them through critical decisions in their Azure adoption. These documents are more aimed at technical architecture, not organizational alignment.

This is intended as a supplement to other documents, such as Microsoft's Cloud Adoption Framework. It is not intended to replace these frameworks, but to rather help guide and capture through key decisions.

Why use AzADR? Or ADRs at all, for that matter?

There are a few principles driving this effort:

  1. Decision-centric architecture, as a practice, allows for the creating of links between the design of architecture and the requirements; this process makes selecting the right tools easier, as well as provides a way to understand when the requirements have changed sufficiently that the previous architecture is no longer appropriate.
  2. There is no one size fits all recommendation for Azure - an organization's best-fit architecture will come from considering needs and requirements, and the capabilities and limitations of the Azure services that might meet the need.
  3. It can be difficult to find comparisons between services that detail the specific capabilities and limitations of Azure services.
  4. Organizations adopting Azure for migrations or new product development may not have decision-centric architecture practices in place.

In short, this toolkit aspires to provide architects with pre-built decision records in order to allow them to quickly adopt decision-centric architecture for their Azure implementation.

Where can I go to learn more about ADRs and decision-centric architecture?

Here are some good places to get started:

Intro to architectural decision records

Sustainable Architectural Design Decisions

Architecture Decisions: Demystifying Architecture

What is contained in the AzADR Toolkit?

The decision records in this toolkit are organized into decision sets.

A decision set is a broad topic or matter that will require several decisions to be answered in order to conclusively resolve. Topics like "Security for PCI workloads" or "Strategy for scalable compute" would be decision sets.

Each decision set then contains one or more architecture decision records; the actual ADRs in the toolkit. These cover well defined requirements, needs, or challenges, and can be answered individually. For example, for the decision set of "Strategy for scalable compute," you might have an ADR for "Kubernetes vs. App Services" that will detail out the comparable strengths and weakness of customer managed Kubernetes clusters, Azure Kubernetes Services, Azure web apps, and Azure functions.

By answering the individual decision records and coming to a conclusion in the ADRs, the bigger matter can be answered. As a result, Decision Sets contain summaries of their child decisions, to act as a roll up.

How do I get started?

  • Make a fork of this repository for your own use
  • Identify which decision sets you are concerned with
  • Customize the decision sets with your notes and selections
  • Begin detailed architecture and build

You can also use the generic AzADR template to make your own ADRs based on your needs.

azadr's People

Contributors

aarhoden avatar brsteph avatar

Stargazers

 avatar  avatar

Watchers

 avatar

azadr's Issues

Update Templates

AzADR-000-Template doesn't match the revised format from the MVP - update it and remove the Gov example.

Create ADR for VNet Segmentation

"How should we segment our vnets?"

  • Multiple workload environments in 1 vnet, with segmentation by subnets?
  • One environment per vnet, with workload segmentation by subnets?
  • 1 vnet per workload environment?

vWan vs VNET Hub & Spoke

I suggest a weighing option to the elements of the decision-making lists.

Meaning: even though several boxes for features or limitations are checked, do some weigh more than others and how would a customer express that?

Best,

  • Aaron

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.