Project

General

Profile

Feature #15096

Create high level documentation for our infrastructure

Added by groente almost 2 years ago. Updated 4 months ago.

Status:
Confirmed
Priority:
Normal
Assignee:
Category:
Infrastructure
Target version:
-
Start date:
12/23/2017
Due date:
% Done:

0%

Feature Branch:
Type of work:
Sysadmin
Blueprint:
Starter:
Affected tool:

Description

The project could benefit from visual high level documentation (flowcharts) giving insight in the different processes that run on our infrastructure. This will make it easier to:

  • onboard new people
  • analyse problems where multiple parts of the infra interact
  • identify points of improvement within the infra

BPMN seems like a good candidate, ideally (at least in part) auto-generated from inline comments in puppet to ensure the documentation stays up-to-date.

For this first iteration:

  • set up the framework to write & maintain this documentation, so that our sysadmins can automatically generate locally a useful visualization out of it
  • private output, don't bother about public/private separation
  • document the CI setup

Related issues

Blocks Tails - Feature #13284: Core work: Sysadmin (Adapt our infrastructure) Confirmed 06/30/2017
Blocks Tails - Feature #15097: Risk analysis on our infrastructure Confirmed 12/23/2017

History

#1 Updated by intrigeri almost 2 years ago

  • Subject changed from High level documentation to High level documentation for our infrastructure

#2 Updated by intrigeri almost 2 years ago

  • Description updated (diff)

#3 Updated by u almost 2 years ago

  • Subject changed from High level documentation for our infrastructure to Create high level documentation for our infrastructure
  • Status changed from New to Confirmed

#4 Updated by intrigeri over 1 year ago

  • Blocks Feature #13284: Core work: Sysadmin (Adapt our infrastructure) added

#5 Updated by intrigeri over 1 year ago

#6 Updated by CyrilBrulebois 12 months ago

  • Target version changed from Tails_3.11 to Tails_3.12

#7 Updated by anonym 10 months ago

  • Target version changed from Tails_3.12 to Tails_3.13

#8 Updated by CyrilBrulebois 9 months ago

  • Target version changed from Tails_3.13 to Tails_3.14

#9 Updated by CyrilBrulebois 7 months ago

  • Target version changed from Tails_3.14 to Tails_3.15

#10 Updated by CyrilBrulebois 5 months ago

  • Target version changed from Tails_3.15 to Tails_3.16

#11 Updated by intrigeri 4 months ago

  • Target version deleted (Tails_3.16)

(As per today's sysadmin team meeting.)

Also available in: Atom PDF