Skip to main content

Library to generate DRAW.IO compatible diagrams to represent Cloud infrastructure. AWS Cloud supported.

Project description

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 iam_role.jpg iam_policy.jpg iam_permission.jpg dynamo.jpg dynamo_stream.jpg api_gw.jpg s3.jpg kms.jpg ssm.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 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 sqs.jpg sns.jpg mq.jpg event_bridge.jpg appflow.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 codewhisperer.jpg comprehend.jpg comprehend_medical.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

Project details


Release history Release notifications | RSS feed

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

multicloud_diagrams-0.3.71.tar.gz (21.5 kB view details)

Uploaded Source

Built Distribution

multicloud_diagrams-0.3.71-py3-none-any.whl (19.8 kB view details)

Uploaded Python 3

File details

Details for the file multicloud_diagrams-0.3.71.tar.gz.

File metadata

  • Download URL: multicloud_diagrams-0.3.71.tar.gz
  • Upload date:
  • Size: 21.5 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/1.8.3 CPython/3.10.14 Linux/6.5.0-1022-azure

File hashes

Hashes for multicloud_diagrams-0.3.71.tar.gz
Algorithm Hash digest
SHA256 83bdba68df04f13775b635ae9822dde867ad56088392bd54315c7adf5a9bd239
MD5 91bdea31a3cf9f55e1e67ea3497e4286
BLAKE2b-256 fc5a63dba652a5c4c0caeb3f07b4a9e923f114d74047aad9e0f58ff4ee37b66d

See more details on using hashes here.

File details

Details for the file multicloud_diagrams-0.3.71-py3-none-any.whl.

File metadata

File hashes

Hashes for multicloud_diagrams-0.3.71-py3-none-any.whl
Algorithm Hash digest
SHA256 773af98fc83d6eadd7ab7eb2f74a1edb0fbe8c8cbf66e6366cd88c04e61823c6
MD5 8ed7b132c8dcbb663cf6eeb75cdf496d
BLAKE2b-256 5bbd1877694a31671339ed79de2fa46bf6a93385d5f39c4f35dadec8cc0f0460

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page