Skip to content

tsypuk/multicloud-diagrams

Repository files navigation

Explore and Document Your Cloud Infrastructure with multicloud-diagrams


license PyPI version python version tests pages release

As Professional Architects, Developers and DevOps with experience in operating on Public Cloud Providers, we all recognize the crucial importance of well-documented Infrastructure and Architecture in a representable form for driving successful projects.

multicloud-diagrams is a framework that combines multiple approaches: Diagrams as a Code (Dac), resources ingestion from external yaml sources, interaction through programmatic API integration.

It allows to store the Infrastructure snippet in drawio format, which is editable vector-based representation. Since source file is not a Raster form, it is easy to edit, customize, position elements based on our needs and track the history.


Supported Nodes Landscape (Autogenerated on-release):

AWS nodes:

lambda_function.jpg sqs.jpg sns.jpg iam_role.jpg iam_policy.jpg iam_permission.jpg dynamo.jpg dynamo_stream.jpg api_gw.jpg s3.jpg kms.jpg ssm.jpg mq.jpg event_bridge.jpg client_vpn.jpg certificate_manager.jpg ecs.jpg ecs_service.jpg ecs_task.jpg ec2.jpg kafka.jpg redis.jpg postgresql.jpg mysql.jpg ecr.jpg elasticsearch_service.jpg aurora.jpg glacier.jpg glacier_standard.jpg glacier_deep_archival.jpg glacier_instant_retrival.jpg chime_voice_connector.jpg chime_sdk.jpg neptune.jpg eks.jpg backup.jpg appflow.jpg datasync.jpg exchange.jpg xray.jpg access_analyzer.jpg resource_access_manager.jpg security_hub.jpg app_runner.jpg

AWS2024 nodes:

AWS2024 / Application Integration

app_sync.jpg step_functions.jpg

AWS2024 / Network & Content Delivery

route_53.jpg direct_connect.jpg

AWS2024 / Compute

outpost.jpg elastic_beanstalk.jpg elastic_fabric_adapter.jpg

AWS2024 / Analytics

glue.jpg lake_formation.jpg kinesis_video_stream.jpg apache_flink.jpg data_brew.jpg data_pipeline.jpg

AWS2024 / Machine Learning

sagemaker_ground_truth.jpg lex.jpg bedrock.jpg codeguru.jpg

AWS2024 / AR & VR

sumerian.jpg ar_vr.jpg

ONPREM nodes:

http.jpg mq_broker.jpg docker.jpg github_code.jpg git_repository.jpg



Support OS Project:

Support from sponsors is invaluable for the continued maintenance and development of open-source projects. You can use any of most popular platforms: Patreon or Buy me a Cofee, by following these links:

  • patreon
  • Buy Me A Coffee

Examples of diagrams generated using multicloud-diagrams:

End-to-End with AWS resources:

draw-e2e.gif


API Gateway with integrations:

draw-apigw.gif


DynamoDB Insights:

drawio-dynamodb.gif


Augment Diagram from UML:

drawio-uml.gif


Supported Cloud Provides:

provider supported in multicloud-diagrams
aws provider [x] since project start
on premise provider [x] since v0.2.1
azure provider [ ]
gcp provider [ ]

Why multicloud-diagrams is written on Python?

The choice of Python as the programming language for our initial project was driven by several key factors that align seamlessly with our goals and requirements. Here's why Python was selected as the foundation for our project's development:

  • Seamless Integration and Data Ingestion using AWS Boto3 (official SDK for Amazon Web Services, developed in Python).
  • Simplicity: Python's clean and readable syntax simplifies the development process. Its ease of use and elegant structure enable to focus on the core components without being bogged down by unnecessary complexities.
  • Broad Appeal among DevOps and Developers: Python's popularity within the DevOps and Development communities is undeniable. Its extensive adoption is a testament to its effectiveness for building robust applications. By choosing Python, we cater to a broader audience, fostering collaboration and easing the learning curve for newcomers.
  • Cross-Platform Availability: Python's cross-platform compatibility ensures that our project can be run on a wide array of environments without compatibility issues. Whether you're working on Windows, macOS, or Linux, Python's ubiquity guarantees consistent functionality across platforms.

Why multicloud-diagrams chooses drawio as the Output Format?

During my exploration of various tools on this journey, I've encountered several options, each with its own set of advantages and compromises. However, after careful consideration, the decision to adopt the drawio format emerged as the optimal choice for several compelling reasons:

  • Editable form of drawio format provides a great level of customization, enabling users to easily fine-tune diagrams to meet specific needs and scenarios.
  • Widespread Adoption: with a broad user base, drawio stands as one of the most widely used diagramming tools, ensuring familiarity and compatibility across diverse teams.
  • Enhanced Plugin and Tool Support: the format seamlessly integrates with a set of plugins and tools, enriching the ecosystem with expanded capabilities and possibilities.
  • Compact File Sizes: leveraging the drawio format results in compact file sizes, facilitating swift sharing and distribution without compromising visual quality.
  • Git-trackable Infrastructure Evolution: allowing for efficient tracking and visualization of infrastructure mutations over time.
  • Smooth Compilation to Raster and other formats: drawio supports out of the box converting to PNG, JPG, PDF, SVG, VSDX, XML

About

PyPI package to draw AWS infrastructure diagrams in popular drawio vector editable format

Topics

Resources

License

Code of conduct

Security policy

Stars

Watchers

Forks

Sponsor this project

Languages