Documentare le decisioni relative all'infrastruttura prima che la conoscenza vada persa

Cosa deve contenere una decisione infrastrutturale per rimanere comprensibile in seguito?

Una voce datata elenca il problema iniziale, le ipotesi, le opzioni considerate, la soluzione scelta, le conseguenze e il ruolo responsabile. I dati di misurazione e la configurazione sono collegati; le modifiche successive integrano la cronologia anziché riscrivere la giustificazione originale.

Conseguenze e revisione

Contesto decisionale

• Conseguenze e revisione Costi, rischi e fattori scatenanti per una rivalutazione sono identificati e assegnati a un ruolo responsabile e a un motivo specifico.

Opzione rifiutata

1. Documentare il problema, i vincoli tecnici e organizzativi e le prove disponibili in modo comprensibile prima di effettuare una selezione.

2. Confrontare le alternative con le relative conseguenze e dichiarare chiaramente la decisione.

3. Aggiungere fattori scatenanti per la revisione, responsabili e collegamenti all'implementazione e alla misurazione.

Caso di controllo: "Solo stato finale"

Un team decide di non aggiungere una cache supplementare perché il carico del database misurato è basso e l'invalidazione è complessa. La voce specifica questi presupposti e definisce l'aumento della latenza delle query come un fattore scatenante per una successiva revisione.

Solo stato finale

• Solo stato finale – I team successivi conoscono la configurazione, ma non i suoi limiti, e quindi ripetono opzioni o presupposti precedentemente scartati.

• Smoothing retrospettivo – Nuove informazioni sostituiscono i presupposti originali e distruggono il valore dell'apprendimento.

• Voce orfana – Nessun responsabile rivede la decisione in condizioni mutate, anche se il carico, i costi o i requisiti di protezione sono cambiati da tempo.

Cosa segue "Documentazione permanente delle decisioni sull'infrastruttura"

Una domanda di approfondimento pertinente con relativa risposta Archiviare i log del server in modo da consentire la successiva tracciabilità degli errori."Quale metodo di archiviazione rende i log del server analizzabili e gestibili in un secondo momento? "

Un secondo collegamento per "Documentare in modo permanente le decisioni relative all'infrastruttura" porta a Documentare le decisioni SEO per evitare che le strategie falliscanoQuesto articolo si concentra sulla domanda: "Quali decisioni SEO devono essere documentate per garantire la stabilità della strategia? "

Se si desidera mettere in pratica "Documentare in modo permanente le decisioni relative all'infrastruttura", è possibile fare riferimento a Sistemi web robusti Questo articolo si concentra su "Gestione del server e diagnosi dei guasti" e "Contesto decisionale".

Conclusione: Documentare in modo permanente le decisioni relative all'infrastruttura

Le decisioni documentate preservano le motivazioni e i limiti, non solo gli aspetti tecnici. Ciò consente di basare le modifiche future sulla conoscenza piuttosto che su supposizioni.

Fonti e ulteriori informazioni

Le seguenti fonti documentano le linee guida tecniche e metodologiche utilizzate per "documentare in modo permanente le decisioni relative all'infrastruttura".

• Gestione dei documenti di decisione architetturale — Microsoft LearnMicrosoft illustra la struttura, il ciclo di vita, le alternative, le conseguenze e la sostituzione delle precedenti decisioni architetturali.

• Utilizzo dei record di decisione architetturale — Guida prescrittiva AWSAWS descrive i record di decisione architetturale come una registrazione tracciabile del contesto, della decisione e delle motivazioni, riducendo la necessità di discussioni fondamentali ricorrenti.