@aws-prototyping-sdk/cdk-graph-plugin-diagram
Project description
Diagram Plugin - Cdk Graph
@aws-prototyping-skd/cdk-graph-plugin-diagram
This plugin generates diagrams utilizing the cdk-graph framework.
More comprehensive documentation to come as this package stabilizes.
Disclaimer: This is the first cdk graph plugin, it is highly experimental, and subject to major refactors as we gain feedback from the community.
Quick Start
// bin/app.ts
// Must wrap cdk app with async IIFE function to enable async cdk-graph report
(async () => {
const app = new App();
// ... add stacks, etc
const graph = new CdkGraph(app, {
plugins: [new CdkGraphDiagramPlugin()],
});
app.synth();
// async cdk-graph reporting hook
await graph.report();
})
// => cdk.out/diagram.dot
// => cdk.out/diagram.svg
// => cdk.out/diagram.png
This plugin currently only supports
async report()
generation following the above example. Make sure to wrap the cdk app with async IIFE.
Supported Formats
Format | Status | Extends | Provider |
---|---|---|---|
DOT | - | Graphviz | |
SVG | DOT | Graphviz | |
PNG | SVG | Graphviz |
Diagram Providers
Provider | Status | Formats |
---|---|---|
Graphviz | DOT, SVG, PNG | |
Drawio | TBD: very early stage design and development |
Configuration
See API Documentation for details, and look in unit tests for more examples.
Example Configurations (expand below)
Presets
Preset: compact
{
name: "compact",
title: "Compact Diagram",
filterPlan: {
preset: FilterPreset.COMPACT,
},
},
Preset: verbose
{
name: "verbose",
title: "Verbose Diagram",
format: DiagramFormat.PNG,
ignoreDefaults: true,
},
Focus
Focus: hoist
{
name: "focus",
title: "Focus Lambda Diagram (non-extraneous)",
filterPlan: {
focus: (store) =>
store.getNode(getConstructUUID(app.stack.lambda)),
preset: FilterPreset.NON_EXTRANEOUS,
},
ignoreDefaults: true,
},
Focus: no hoist
{
name: "focus-nohoist",
title: "Focus WebServer Diagram (noHoist, verbose)",
filterPlan: {
focus: {
node: (store) =>
store.getNode(getConstructUUID(app.stack.webServer)),
noHoist: true,
},
},
ignoreDefaults: true,
},
Filters
Filter: Include specific cfn resource types
{
name: "includeCfnType",
title: "Include CfnType Diagram (filter)",
filterPlan: {
filters: [
Filters.includeCfnType([
aws_arch.CfnSpec.ServiceResourceDictionary.EC2.Instance,
/AWS::Lambda::Function.*/,
"AWS::IAM::Role",
]),
Filters.compact(),
],
},
},
Filter: Exclude specific cfn resource types
{
name: "excludeCfnType",
title: "Exclude CfnType Diagram (filter)",
filterPlan: {
filters: [
Filters.excludeCfnType([
/AWS::EC2::VPC.*/,
aws_arch.CfnSpec.ServiceResourceDictionary.IAM.Role,
]),
Filters.compact(),
],
},
},
Filter: Include specific graph node types
{
name: "includeNodeType",
title: "Include NodeType Diagram (filter)",
filterPlan: {
filters: [
Filters.includeNodeType([
NodeTypeEnum.STACK,
NodeTypeEnum.RESOURCE,
]),
Filters.compact(),
],
},
},
Filter: Include specific graph node types
{
name: "includeNodeType",
title: "Include NodeType Diagram (filter)",
filterPlan: {
filters: [
Filters.includeNodeType([
NodeTypeEnum.STACK,
NodeTypeEnum.RESOURCE,
]),
Filters.compact(),
],
},
},
Filter: Exclude specific graph node types
{
name: "excludeNodeType",
title: "Exclude NodeType Diagram (filter)",
filterPlan: {
filters: [
Filters.excludeNodeType([
NodeTypeEnum.NESTED_STACK,
NodeTypeEnum.CFN_RESOURCE,
NodeTypeEnum.OUTPUT,
NodeTypeEnum.PARAMETER,
]),
Filters.compact(),
],
},
},
Themes
Theme: Dark - render service icons
{
name: "dark-services",
title: "Dark Theme Custom Diagram",
theme: {
theme: theme,
rendering: {
resourceIconMin: GraphThemeRenderingIconTarget.SERVICE,
resourceIconMax: GraphThemeRenderingIconTarget.CATEGORY,
cfnResourceIconMin: GraphThemeRenderingIconTarget.DATA,
cfnResourceIconMax: GraphThemeRenderingIconTarget.RESOURCE,
},
},
},
Theme: Dark - verbose
{
name: "dark-verbose",
title: "Dark Theme Verbose Diagram",
ignoreDefaults: true,
theme: theme,
},
Next Steps
- Battle test in the wild and get community feedback
- Improve image coverage and non-image node rendering
- Add drawio support
- Add common filter patterns and helpers
- Enable generating diagrams outside of synthesis process (maybe CLI)
- Implement interactive diagram, with potential for dynamic filtering and config generation
- Support using interactive diagram as config generator for other plugins (or as separate plugin that depends on this)
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
Built Distribution
Close
Hashes for aws_prototyping_sdk.cdk_graph_plugin_diagram-0.12.18.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | 049928c4ae489299991becbe8ff264e1c4cc157ff35633a3a076d7555470ec32 |
|
MD5 | 1c2795bee8c34a4d25ca51d00ffe951d |
|
BLAKE2b-256 | cd0d41aad0624c6c7ae4c20119c49a739fb786aded138cb260c0010b2130a6b6 |
Close
Hashes for aws_prototyping_sdk.cdk_graph_plugin_diagram-0.12.18-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | c7383aebcd521ee2abc4e12f72af31b0f0fdc8891379d2ab1702b76139dc8da3 |
|
MD5 | 1be15ebb17fd222f228d0a7118c2fdc6 |
|
BLAKE2b-256 | 947d3dddf016c066308f08d6ae9716a7b809bbc0f5772eae6bfbaea621490c23 |