[PYTHON] Vom "Zeichnen" zum "Schreiben" des Konfigurationsdiagramms: Zeichnen Sie das AWS-Konfigurationsdiagramm mit Diagrammen

Dinge die zu tun sind

Versuchen Sie, ein AWS-Konfigurationsdiagramm mit Code in Diagrammen zu zeichnen, das auch als "Diagramm als Code" bezeichnet wird.

Was sind Diagramme?

--Figures ist ein Python-Modul --Graphviz ist auch erforderlich, um Diagramme zu verwenden

• Sie können die Cloud-Systemarchitektur mit Python-Code zeichnen
• Die Seite ist hier
  • https://diagrams.mingrammer.com/ ――Die Erklärung der Diagramme auf der Website ist auf Englisch, aber die Menge ist gering, deshalb sollten Sie sie lesen! (Automatische Übersetzung ist genug, um zu verstehen)

Auf diese Weise können Sie das Konfigurationsdiagramm in Python-Code schreiben. Wenn dieser Code als Python-Skript ausgeführt wird, wird das Konfigurationsdiagramm als Image ausgegeben.

-** Gute Argumente **

• Sie können das Konfigurationsdiagramm codieren ――Da Sie die Zeichnung durch Codebearbeitung bearbeiten können, ist dies einfacher als die Bildkorrektur
• Da es sich um einen Code handelt, kann er von Git zusammen mit dem CloudFormation-Code verwaltet werden.
• Nicht-AWS-Symbole sind ebenfalls verfügbar
• Das Ausgabekonfigurationsdiagramm kann als grobe Skizze oder besser verwendet werden
• ** Aufgabe **
• Nicht alle AWS-Symbole sind verfügbar
• Sie können nicht angeben, wo das Symbol platziert werden soll (deshalb handelt es sich um einen einfachen Code).

Diagramme Installationsumgebung

Ich habe Diagrams in zwei Umgebungen installiert, " Raspberry Pi 4 Model B " und " Cloud9 ".

Umgebung (1) Raspberry Pi 4 Modell B.

$ cat /etc/os-release
PRETTY_NAME="Raspbian GNU/Linux 10 (buster)"
NAME="Raspbian GNU/Linux"
VERSION_ID="10"
VERSION="10 (buster)"
VERSION_CODENAME=buster
ID=raspbian
ID_LIKE=debian
HOME_URL="http://www.raspbian.org/"
SUPPORT_URL="http://www.raspbian.org/RaspbianForums"
BUG_REPORT_URL="http://www.raspbian.org/RaspbianBugs"

Python gibt es in zwei Versionen, 2.7 und 3.7. Installieren Sie Diagrams unter Python 3.7

$ python --version
Python 2.7.16
$ python3 --version
Python 3.7.3

Umgebung (2) Cloud9

$ cat /etc/os-release
NAME="Amazon Linux AMI"
VERSION="2018.03"
ID="amzn"
ID_LIKE="rhel fedora"
VERSION_ID="2018.03"
PRETTY_NAME="Amazon Linux AMI 2018.03"
ANSI_COLOR="0;33"
CPE_NAME="cpe:/o:amazon:linux:2018.03:ga"
HOME_URL="http://aws.amazon.com/amazon-linux-ami/"

Cloud9 ist nur Python 3.x, nicht Python 2.x.

$ python --version
Python 3.6.8

Installation der Diagramme

Installation (1) Raspberry Pi

Installieren Sie einfach Diagramme und Graphviz auf Python3.

Installieren Sie das Diagramm auf Python3

$ python3 -m pip install diagrams

Graphviz-Installation

$ sudo apt-get install graphviz

Installation (2) Cloud9

$ sudo pip install --upgrade pip
$ sudo python3 -m pip install diagrams
$ sudo yum install graphviz

(Überprüfung) Zeichnen Sie das AWS-Konfigurationsdiagramm

• "Zeichnen" → "Schreiben" des Konfigurationsdiagramms

(Überprüfung 1) Zeichnen Sie ein Konfigurationsdiagramm des Webservers

Folgendes konnte ich tun

Ich konnte es in Cloud9 so sehen (praktisch!)

--Outline der Konfiguration

• Erstellen Sie einen WebApp-Server mit EC2
• Bereiten Sie zwei WebApp-Server auf Redundanz vor
• Verteilen Sie die Last auf dem WebApp-Server mit ALB
• Domain bei Rote53 registrieren
• Bereiten Sie die WebApp-Serverdatenbank mit RDS vor

Dies ist der Code, den ich gemacht habe.

Konfigurationsdiagramm des Webservers

from diagrams import Cluster, Diagram, Edge
from diagrams.aws.network import VPC
from diagrams.aws.compute import EC2
from diagrams.aws.database import RDS
from diagrams.aws.network import Route53
from diagrams.aws.network import NATGateway
from diagrams.aws.network import InternetGateway
from diagrams.aws.network import ElasticLoadBalancing
from diagrams.onprem.network import Internet
from diagrams.onprem.client import Client
from diagrams.onprem.client import Users

with Diagram("Fig-001-WebSite", show=False):
    with Cluster("Fig-001-WebSite"):
        internet_01 = Internet("Internet")
        users_01 = Users("Nutzer")
        with Cluster("AWS/Develop/ap-northeast-1"):
            r53_01 = Route53("hoge.fuga.local")
            with Cluster("VPC/192.168.0.0/HOGE-SYSTEM"):
                alb_01 = ElasticLoadBalancing("ALB")
                igw_01 = InternetGateway("InternetGateway")
                with Cluster("subnet/192.168.1.0/public"):
                    natgw_01 = NATGateway("NATGW")
                    ec2_01 = EC2("WebApp")
                with Cluster("subnet/192.168.101.0/private"):
                    rds_01 = RDS("postgres-Master")
                with Cluster("subnet/192.168.2.0/public"):
                    natgw_02 = NATGateway("NATGW")
                    ec2_02 = EC2("WebApp")
                with Cluster("subnet/192.168.102.0/private"):
                    rds_02 = RDS("postgres-Slave")

    #Konfigurationsdiagramm Webserver
    users_01 - internet_01 - igw_01 - alb_01 #Benutzerzugriffsroute
    alb_01 - ec2_01 - rds_01 #WebApp-Redundanz
    alb_01 - ec2_02 - rds_01 #WebApp-Redundanz
    rds_01 - Edge(style="dotted") - rds_02 #DB-Redundanz

(Überprüfung 2) Zeichnen Sie ein Blockdiagramm von WorkSpaces

--Amazon WorkSpaces ist ein virtueller Desktop-Service von AWS. --Graphics hat kein WorkSpaces-Symbol

• Dies ist das Konfigurationsdiagramm, das Sie erstellen möchten ↓

Dies ist, was ich in Diagramme geschrieben habe (ich denke, es ist vernünftig)

• Ersetzen Sie Symbole, die nicht in Diagrammen enthalten sind, z. B. Storage Gateway und WorkSpaces, durch unterschiedliche Symbole.

Ersetzen Sie Symbole, die nicht in Diagrammen enthalten sind, wie z. B. WorkSpaces und ENI, durch das Client-Symbol.

WorkSpace-Konfigurationsdiagramm

from diagrams import Cluster, Diagram, Edge
from diagrams.aws.network import VPC
from diagrams.aws.compute import EC2
from diagrams.aws.database import RDS
from diagrams.aws.network import Route53
from diagrams.aws.network import NATGateway
from diagrams.aws.network import InternetGateway
from diagrams.onprem.network import Internet
from diagrams.onprem.client import Client
from diagrams.aws.security import DirectoryService
from diagrams.aws.network import DirectConnect
from diagrams.onprem.compute import Server
from diagrams.onprem.client import User
from diagrams.onprem.compute import Nomad

with Diagram("Fig-002-WorkSpaces", show=False):
    with Cluster("Fig-002-WorkSpaces"):
        Internet_01 = Internet("Internet")
        User_01 = User("Benutzer 1")
        User_02 = User("Benutzer 2")
        UserDevice_01 = Client("Gerät")
        UserDevice_02 = Client("Gerät")

        with Cluster("VPC/AWS-Management"):
            StorageGw_01 = Client("StorageGateway")
            WorkSpace_01 = Client("WorkSpacesForUser1")
            WorkSpace_02 = Client("WorkSpacesForUser2")

        with Cluster("VPC/192.168.0.0/HOGE"):
            with Cluster("subnet/192.168.1.0/public"):
                eni_01 = Client("ENI User1")
                eni_02 = Client("ENI User2")

        DirectConnect_01 = DirectConnect("DirectConnect")
        ADConnector_01 = DirectoryService("AD Connector")

        with Cluster("Nabe"):
            with Cluster("Internes Netzwerk"):
                ActiveDirectory_01 = Server("AD")

    #Konfigurationsdiagramm WorkSpace
    User_01 - UserDevice_01 - Internet_01 - StorageGw_01 - WorkSpace_01 - eni_01 #Gerät-Kommunikationspfad zwischen WorkSpaces
    User_02 - UserDevice_02 - Internet_01
    StorageGw_01 - WorkSpace_02 - eni_02
    ADConnector_01 - DirectConnect_01 - ActiveDirectory_01 #In-Base AD-Kommunikationspfad zwischen AD Connector
    ADConnector_01 - Edge(style="dotted") - WorkSpace_01
    ADConnector_01 - Edge(style="dotted") - WorkSpace_02

• Nebenbei * Es fiel mir schwer, weil sich das Symbol der Basis oben links befand und ich das Symbol nicht dort platzieren konnte, wo ich es erwartet hatte.

Impressionen: Was ich über die Verwendung von Diagrammen gedacht habe

• Das ganze
• Ersetzen Sie Symbole, die nicht in Diagrammen enthalten sind, z. B. Storage Gateway und WorkSpaces, durch unterschiedliche Symbole. ――Wenn Sie sich für ein Ersatzsymbol entscheiden, können Sie es als Konfigurationsdiagramm verwenden, das vom Team gemeinsam genutzt wird.
• (Ich würde mich freuen, wenn Diagramme ein Ersatzsymbol bereitstellen würden!) ――Eine Ebene, die als grobe Skizze verwendet werden kann, scheint nützlich zu sein, wenn Sie nach einer sauberen Kopie fragen
• Die Lernkosten sind niedrig und es hilft
• Wie schreibe ich den Code? --Variable Namensregeln sind wichtig (nicht darauf beschränkt)
• Es wird empfohlen, die Verbindungsinformationen der einzelnen Symbole am Ende des Codes zusammenzufassen.
• Teilen Sie die Regeln mit dem Team, damit Sie das Konfigurationsdiagramm anhand der Verbindungsinformationen sehen können (* 1).

(* 1) Wenn Sie die Regeln festlegen, können Sie ein Kompositionsdiagramm in Ihrem Gehirn erstellen, indem Sie es betrachten.

Bonus

Fügen Sie die Symbolausgabe von onPrem und Python-Code (Informationen ab Mai 2020) ein.

Ausgabe des onPrem-Symbols

from diagrams import Cluster, Diagram, Edge
# onprem.database
from diagrams.onprem.database import Cassandra
from diagrams.onprem.database import Clickhouse, ClickHouse
from diagrams.onprem.database import Cockroachdb, CockroachDB
from diagrams.onprem.database import Couchdb, CouchDB
from diagrams.onprem.database import Dgraph
from diagrams.onprem.database import Hbase, HBase
from diagrams.onprem.database import Influxdb, InfluxDB
from diagrams.onprem.database import Janusgraph, JanusGraph
from diagrams.onprem.database import Mariadb, MariaDB
from diagrams.onprem.database import Mongodb, MongoDB
from diagrams.onprem.database import Mssql, MSSQL
from diagrams.onprem.database import Mysql, MySQL
from diagrams.onprem.database import Neo4J
from diagrams.onprem.database import Oracle
from diagrams.onprem.database import Postgresql, PostgreSQL
from diagrams.onprem.database import Scylla
# onprem.security
from diagrams.onprem.security import Trivy
from diagrams.onprem.security import Vault
# onprem.ci
from diagrams.onprem.ci import Circleci, CircleCI
from diagrams.onprem.ci import Jenkins
from diagrams.onprem.ci import Teamcity, TC
from diagrams.onprem.ci import Travisci, TravisCI
# onprem.etl
from diagrams.onprem.etl import Embulk
# onprem.mlops
from diagrams.onprem.mlops import Polyaxon
# onprem.network
from diagrams.onprem.network import Apache
from diagrams.onprem.network import Caddy
from diagrams.onprem.network import Consul
from diagrams.onprem.network import Envoy
from diagrams.onprem.network import Etcd, ETCD
from diagrams.onprem.network import Haproxy, HAProxy
from diagrams.onprem.network import Internet
from diagrams.onprem.network import Istio
from diagrams.onprem.network import Kong
from diagrams.onprem.network import Linkerd
from diagrams.onprem.network import Nginx
from diagrams.onprem.network import Pfsense, PFSense
from diagrams.onprem.network import Pomerium
from diagrams.onprem.network import Tomcat
from diagrams.onprem.network import Traefik
from diagrams.onprem.network import Vyos, VyOS
from diagrams.onprem.network import Zookeeper
# onprem.inmemory
from diagrams.onprem.inmemory import Aerospike
from diagrams.onprem.inmemory import Hazelcast
from diagrams.onprem.inmemory import Memcached
from diagrams.onprem.inmemory import Redis
# onprem.search
from diagrams.onprem.search import Elasticsearch
from diagrams.onprem.search import Solr
# onprem.container
from diagrams.onprem.container import Docker
from diagrams.onprem.container import Rkt, RKT
# onprem.iac
from diagrams.onprem.iac import Ansible
from diagrams.onprem.iac import Awx
from diagrams.onprem.iac import Terraform
# onprem.compute
from diagrams.onprem.compute import Nomad
from diagrams.onprem.compute import Server
# onprem.vcs
from diagrams.onprem.vcs import Git
from diagrams.onprem.vcs import Github
from diagrams.onprem.vcs import Gitlab
# onprem.workflow
from diagrams.onprem.workflow import Airflow
from diagrams.onprem.workflow import Digdag
from diagrams.onprem.workflow import Kubeflow, KubeFlow
from diagrams.onprem.workflow import Nifi, NiFi
# onprem.queue
from diagrams.onprem.queue import Activemq, ActiveMQ
from diagrams.onprem.queue import Celery
from diagrams.onprem.queue import Kafka
from diagrams.onprem.queue import Rabbitmq, RabbitMQ
from diagrams.onprem.queue import Zeromq, ZeroMQ
# onprem.cd
from diagrams.onprem.cd import Spinnaker
# onprem.gitops
from diagrams.onprem.gitops import Argocd, ArgoCD
# onprem.monitoring
from diagrams.onprem.monitoring import Datadog
from diagrams.onprem.monitoring import Grafana
from diagrams.onprem.monitoring import Kibana
from diagrams.onprem.monitoring import Prometheus
from diagrams.onprem.monitoring import Splunk
from diagrams.onprem.monitoring import Thanos
# onprem.client
from diagrams.onprem.client import Client
from diagrams.onprem.client import User
from diagrams.onprem.client import Users
# onprem.logging
from diagrams.onprem.logging import Fluentd
from diagrams.onprem.logging import Logstash, LogStash
from diagrams.onprem.logging import Loki
# onprem.analytics
from diagrams.onprem.analytics import Beam
from diagrams.onprem.analytics import Flink
from diagrams.onprem.analytics import Hadoop
from diagrams.onprem.analytics import Hive
from diagrams.onprem.analytics import Metabase
from diagrams.onprem.analytics import Norikra
from diagrams.onprem.analytics import Spark
from diagrams.onprem.analytics import Storm
from diagrams.onprem.analytics import Tableau



with Diagram("OnPrem-Aicons", show=False):
    with Cluster("OnPrem"):
        # onprem.database("# onprem.database")
        Cassandra("Cassandra")
        Clickhouse, ClickHouse("Clickhouse, ClickHouse")
        Cockroachdb, CockroachDB("Cockroachdb, CockroachDB")
        Couchdb, CouchDB("Couchdb, CouchDB")
        Dgraph("Dgraph")
        Hbase, HBase("Hbase, HBase")
        Influxdb, InfluxDB("Influxdb, InfluxDB")
        Janusgraph, JanusGraph("Janusgraph, JanusGraph")
        Mariadb, MariaDB("Mariadb, MariaDB")
        Mongodb, MongoDB("Mongodb, MongoDB")
        Mssql, MSSQL("Mssql, MSSQL")
        Mysql, MySQL("Mysql, MySQL")
        Neo4J("Neo4J")
        Oracle("Oracle")
        Postgresql, PostgreSQL("Postgresql, PostgreSQL")
        Scylla("Scylla")
        # onprem.security("# onprem.security")
        Trivy("Trivy")
        Vault("Vault")
        # onprem.ci("# onprem.ci")
        Circleci, CircleCI("Circleci, CircleCI")
        Jenkins("Jenkins")
        Teamcity, TC("Teamcity, TC")
        Travisci, TravisCI("Travisci, TravisCI")
        # onprem.etl("# onprem.etl")
        Embulk("Embulk")
        # onprem.mlops("# onprem.mlops")
        Polyaxon("Polyaxon")
        # onprem.network("# onprem.network")
        Apache("Apache")
        Caddy("Caddy")
        Consul("Consul")
        Envoy("Envoy")
        Etcd, ETCD("Etcd, ETCD")
        Haproxy, HAProxy("Haproxy, HAProxy")
        Internet("Internet")
        Istio("Istio")
        Kong("Kong")
        Linkerd("Linkerd")
        Nginx("Nginx")
        Pfsense, PFSense("Pfsense, PFSense")
        Pomerium("Pomerium")
        Tomcat("Tomcat")
        Traefik("Traefik")
        Vyos, VyOS("Vyos, VyOS")
        Zookeeper("Zookeeper")
        # onprem.inmemory("# onprem.inmemory")
        Aerospike("Aerospike")
        Hazelcast("Hazelcast")
        Memcached("Memcached")
        Redis("Redis")
        # onprem.search("# onprem.search")
        Elasticsearch("Elasticsearch")
        Solr("Solr")
        # onprem.container("# onprem.container")
        Docker("Docker")
        Rkt, RKT("Rkt, RKT")
        # onprem.iac("# onprem.iac")
        Ansible("Ansible")
        Awx("Awx")
        Terraform("Terraform")
        # onprem.compute("# onprem.compute")
        Nomad("Nomad")
        Server("Server")
        # onprem.vcs("# onprem.vcs")
        Git("Git")
        Github("Github")
        Gitlab("Gitlab")
        # onprem.workflow("# onprem.workflow")
        Airflow("Airflow")
        Digdag("Digdag")
        Kubeflow, KubeFlow("Kubeflow, KubeFlow")
        Nifi, NiFi("Nifi, NiFi")
        # onprem.queue("# onprem.queue")
        Activemq, ActiveMQ("Activemq, ActiveMQ")
        Celery("Celery")
        Kafka("Kafka")
        Rabbitmq, RabbitMQ("Rabbitmq, RabbitMQ")
        Zeromq, ZeroMQ("Zeromq, ZeroMQ")
        # onprem.cd("# onprem.cd")
        Spinnaker("Spinnaker")
        # onprem.gitops("# onprem.gitops")
        Argocd, ArgoCD("Argocd, ArgoCD")
        # onprem.monitoring("# onprem.monitoring")
        Datadog("Datadog")
        Grafana("Grafana")
        Kibana("Kibana")
        Prometheus("Prometheus")
        Splunk("Splunk")
        Thanos("Thanos")
        # onprem.client("# onprem.client")
        Client("Client")
        User("User")
        Users("Users")
        # onprem.logging("# onprem.logging")
        Fluentd("Fluentd")
        Logstash, LogStash("Logstash, LogStash")
        Loki("Loki")
        # onprem.analytics("# onprem.analytics")
        Beam("Beam")
        Flink("Flink")
        Hadoop("Hadoop")
        Hive("Hive")
        Metabase("Metabase")
        Norikra("Norikra")
        Spark("Spark")
        Storm("Storm")
        Tableau("Tableau")