Answers: <p>The established method is infrastructure as code. </p>
  
  <p>Want to find out what processes run in a container? Check the Dockerfile. Infrastructure dependencies? Check the Cloudformation template/Terraform blueprint. Interactions between containers? Check the docker-compose.yml or Kubernetes yaml file. </p>
  
Answers: CC BY-SA 3.0
Answers: 2017-09-21T08:55:06.320Z
Answers: Yes, that is the implementation, but this question is about a graphical representation. "program code <=> UML"   vs. "config files <=> ???".
Answers: AnoE
Answers: CC BY-SA 3.0
Answers: 2017-09-21T08:39:25.467Z
Answers: 2017-09-21T08:54:55.447Z
Answers: 2017-09-21T08:54:55.447Z
Answers: user2640621
Answers: <p>If you are in AWS, there is a very large native set of icons. Confluence has an imported drawing system (draw.io) that includes the AWS icons, it works but its a bit buggy. You can download the AWS icons. In Kubernetes there might be some new mapping tools. You can draw anything with FOSS Inkscape using imported icons. There are likely many other tools. At my shop developers just hack away at their own drawings and copy each other's style. </p>
  
  <p>However I think you were asking for a UML-type of graphical language for cloud representation. Wouldn't it be great to have a 3D system that shows network flows and security connections? A startup for Kubernetes would be a great idea. I think New Relic and/or Datadog have some ability to map network flows, too.</p>
  
Answers: CC BY-SA 4.0
Answers: 2018-08-11T18:16:27.613Z
Answers: 2018-08-11T18:16:27.613Z
Answers: John Fisher
Body: <p>We have UML to describe classes, components, workflows. We have BPMN to describe business processes. We have more old-fashioned forms used in times past for structural diagrams.</p>
  
  <p>Is there anything established or semi-established in the DevOps world? The information contained in a simple diagram should be something like:</p>
  
  <ul>
  <li>Which containers are there in a containerized app, including their associations (i.e. which statically depends on which for building) and the (micro)services they provide?</li>
  <li>How do they interact dynamically (networking etc.)?</li>
  <li>What responsibility does each of the containers fulfill?</li>
  <li>What requirements does each container have on the host, if relevant?</li>
  <li>... and so on.</li>
  </ul>
  
  <p>I'm neither asking for a list of any private schemes somebody may fancy, nor about opinions on which is the most beautiful. </p>
  
  <p>I'm strictly asking about whether there <em>exist</em> any that either by purpose are industry standards or have turned out to just be used in many places by chance/convention.</p>
  
  <p>The purpose of using such a scheme would be to have something that would instantly be recognized by fellow DevOps people; or which could easily be shown in contexts where it is not appropriate to look into Dockerfiles or other Infrastructure-as-code sources (e.g., when scribbling on a board, or holding a more abstract presentation).</p>
  
Comments: CC BY-SA 3.0
Comments: 2017-09-21T09:15:42.027Z
Comments: https://stackoverflow.com/a/38300650/2777965
Comments: 030
Comments: CC BY-SA 3.0
Comments: 2017-09-23T02:31:05.950Z
Comments: I was literally about to provide an answering saying UML is still applicable here with Deployment Diagrams.
Comments: Matt O.
Tags: <culture><documentation>
Title: Is there an established scheme for creating diagrams about Containers, Services etc.?
UserDisplayName: AnoE
ThreadText: # Is there an established scheme for creating diagrams about Containers, Services etc.?
  
  (Asked by: username_0 on 2017-09-21)
  
  We have UML to describe classes, components, workflows. We have BPMN to describe business processes. We have more old-fashioned forms used in times past for structural diagrams.
  
  Is there anything established or semi-established in the DevOps world? The information contained in a simple diagram should be something like:
  
  * Which containers are there in a containerized app, including their associations (i.e. which statically depends on which for building) and the (micro)services they provide?
  * How do they interact dynamically (networking etc.)?
  * What responsibility does each of the containers fulfill?
  * What requirements does each container have on the host, if relevant?
  * ... and so on.
  
  I'm neither asking for a list of any private schemes somebody may fancy, nor about opinions on which is the most beautiful.
  
  I'm strictly asking about whether there *exist* any that either by purpose are industry standards or have turned out to just be used in many places by chance/convention.
  
  The purpose of using such a scheme would be to have something that would instantly be recognized by fellow DevOps people; or which could easily be shown in contexts where it is not appropriate to look into Dockerfiles or other Infrastructure-as-code sources (e.g., when scribbling on a board, or holding a more abstract presentation).
  
  **Tags:** culture, documentation
  
  > **Comments:**
  > **username_1**: https://stackoverflow.com/a/38300650/2777965  
  > **username_2**: I was literally about to provide an answering saying UML is still applicable here with Deployment Diagrams.  
  
  ---
  
  ## 2 answers
  
  ### Answer by username_3 on 2017-09-21. Score: 2
  
  The established method is infrastructure as code.
  
  Want to find out what processes run in a container? Check the Dockerfile. Infrastructure dependencies? Check the Cloudformation template/Terraform blueprint. Interactions between containers? Check the docker-compose.yml or Kubernetes yaml file.
  
  > **Comments:**
  > **username_0**: Yes, that is the implementation, but this question is about a graphical representation. "program code <=> UML"   vs. "config files <=> ???".  
  
  ---
  
  ### Answer by username_4 on 2018-08-11. Score: 0
  
  If you are in AWS, there is a very large native set of icons. Confluence has an imported drawing system (draw.io) that includes the AWS icons, it works but its a bit buggy. You can download the AWS icons. In Kubernetes there might be some new mapping tools. You can draw anything with FOSS Inkscape using imported icons. There are likely many other tools. At my shop developers just hack away at their own drawings and copy each other's style.
  
  However I think you were asking for a UML-type of graphical language for cloud representation. Wouldn't it be great to have a 3D system that shows network flows and security connections? A startup for Kubernetes would be a great idea. I think New Relic and/or Datadog have some ability to map network flows, too.
  
  
  ---
  
  