{"id":37069983,"url":"https://github.com/ludwigm/infrastructure-graph","last_synced_at":"2026-01-14T08:03:34.458Z","repository":{"id":57413267,"uuid":"219143291","full_name":"ludwigm/infrastructure-graph","owner":"ludwigm","description":"Small CLI utility which allows to visualize Infra dependencies on AWS based on CloudFormation stacks","archived":false,"fork":false,"pushed_at":"2020-08-25T17:45:03.000Z","size":137,"stargazers_count":11,"open_issues_count":0,"forks_count":1,"subscribers_count":2,"default_branch":"master","last_synced_at":"2026-01-02T14:09:35.824Z","etag":null,"topics":["aws","cloudformation","graphs","graphviz","python"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ludwigm.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2019-11-02T11:18:47.000Z","updated_at":"2025-02-23T08:35:29.000Z","dependencies_parsed_at":"2022-09-07T03:02:46.755Z","dependency_job_id":null,"html_url":"https://github.com/ludwigm/infrastructure-graph","commit_stats":null,"previous_names":[],"tags_count":5,"template":false,"template_full_name":null,"purl":"pkg:github/ludwigm/infrastructure-graph","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ludwigm%2Finfrastructure-graph","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ludwigm%2Finfrastructure-graph/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ludwigm%2Finfrastructure-graph/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ludwigm%2Finfrastructure-graph/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ludwigm","download_url":"https://codeload.github.com/ludwigm/infrastructure-graph/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ludwigm%2Finfrastructure-graph/sbom","scorecard":{"id":603199,"data":{"date":"2025-08-11","repo":{"name":"github.com/ludwigm/infrastructure-graph","commit":"a0fc6fe691debaa176eba31a58dc6e95e54b5294"},"scorecard":{"version":"v5.2.1-40-gf6ed084d","commit":"f6ed084d17c9236477efd66e5b258b9d4cc7b389"},"score":2.2,"checks":[{"name":"Binary-Artifacts","score":10,"reason":"no binaries found in the repo","details":null,"documentation":{"short":"Determines if the project has generated executable (binary) artifacts in the source repository.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#binary-artifacts"}},{"name":"Packaging","score":-1,"reason":"packaging workflow not detected","details":["Warn: no GitHub/GitLab publishing workflow detected."],"documentation":{"short":"Determines if the project is published as a package that others can easily download, install, easily update, and uninstall.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#packaging"}},{"name":"Token-Permissions","score":0,"reason":"detected GitHub workflow tokens with excessive permissions","details":["Warn: no topLevel permission defined: .github/workflows/build_test_python.yml:1","Warn: no topLevel permission defined: .github/workflows/bump_python.yml:1","Warn: no topLevel permission defined: .github/workflows/release_python_package.yml:1","Info: no jobLevel write permissions found"],"documentation":{"short":"Determines if the project's workflows follow the principle of least privilege.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#token-permissions"}},{"name":"Code-Review","score":0,"reason":"Found 0/30 approved changesets -- score normalized to 0","details":null,"documentation":{"short":"Determines if the project requires human code review before pull requests (aka merge requests) are merged.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#code-review"}},{"name":"Dangerous-Workflow","score":10,"reason":"no dangerous workflow patterns detected","details":null,"documentation":{"short":"Determines if the project's GitHub Action workflows avoid dangerous patterns.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#dangerous-workflow"}},{"name":"Maintained","score":0,"reason":"0 commit(s) and 0 issue activity found in the last 90 days -- score normalized to 0","details":null,"documentation":{"short":"Determines if the project is \"actively maintained\".","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#maintained"}},{"name":"CII-Best-Practices","score":0,"reason":"no effort to earn an OpenSSF best practices badge detected","details":null,"documentation":{"short":"Determines if the project has an OpenSSF (formerly CII) Best Practices Badge.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#cii-best-practices"}},{"name":"Pinned-Dependencies","score":0,"reason":"dependency not pinned by hash detected -- score normalized to 0","details":["Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/build_test_python.yml:19: update your workflow using https://app.stepsecurity.io/secureworkflow/ludwigm/infrastructure-graph/build_test_python.yml/master?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/build_test_python.yml:21: update your workflow using https://app.stepsecurity.io/secureworkflow/ludwigm/infrastructure-graph/build_test_python.yml/master?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/bump_python.yml:24: update your workflow using https://app.stepsecurity.io/secureworkflow/ludwigm/infrastructure-graph/bump_python.yml/master?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/bump_python.yml:29: update your workflow using https://app.stepsecurity.io/secureworkflow/ludwigm/infrastructure-graph/bump_python.yml/master?enable=pin","Warn: third-party GitHubAction not pinned by hash: .github/workflows/bump_python.yml:70: update your workflow using https://app.stepsecurity.io/secureworkflow/ludwigm/infrastructure-graph/bump_python.yml/master?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/release_python_package.yml:17: update your workflow using https://app.stepsecurity.io/secureworkflow/ludwigm/infrastructure-graph/release_python_package.yml/master?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/release_python_package.yml:19: update your workflow using https://app.stepsecurity.io/secureworkflow/ludwigm/infrastructure-graph/release_python_package.yml/master?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/release_python_package.yml:30: update your workflow using https://app.stepsecurity.io/secureworkflow/ludwigm/infrastructure-graph/release_python_package.yml/master?enable=pin","Warn: pipCommand not pinned by hash: .github/workflows/build_test_python.yml:29","Warn: pipCommand not pinned by hash: .github/workflows/build_test_python.yml:30","Warn: pipCommand not pinned by hash: .github/workflows/bump_python.yml:34","Warn: pipCommand not pinned by hash: .github/workflows/bump_python.yml:35","Warn: pipCommand not pinned by hash: .github/workflows/release_python_package.yml:24","Warn: pipCommand not pinned by hash: .github/workflows/release_python_package.yml:25","Warn: pipCommand not pinned by hash: .github/workflows/release_python_package.yml:40","Warn: pipCommand not pinned by hash: .github/workflows/release_python_package.yml:41","Info:   0 out of   7 GitHub-owned GitHubAction dependencies pinned","Info:   0 out of   1 third-party GitHubAction dependencies pinned","Info:   0 out of   8 pipCommand dependencies pinned"],"documentation":{"short":"Determines if the project has declared and pinned the dependencies of its build process.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#pinned-dependencies"}},{"name":"Security-Policy","score":0,"reason":"security policy file not detected","details":["Warn: no security policy file detected","Warn: no security file to analyze","Warn: no security file to analyze","Warn: no security file to analyze"],"documentation":{"short":"Determines if the project has published a security policy.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#security-policy"}},{"name":"License","score":0,"reason":"license file not detected","details":["Warn: project does not have a license file"],"documentation":{"short":"Determines if the project has defined a license.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#license"}},{"name":"Fuzzing","score":0,"reason":"project is not fuzzed","details":["Warn: no fuzzer integrations found"],"documentation":{"short":"Determines if the project uses fuzzing.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#fuzzing"}},{"name":"Signed-Releases","score":-1,"reason":"no releases found","details":null,"documentation":{"short":"Determines if the project cryptographically signs release artifacts.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#signed-releases"}},{"name":"Branch-Protection","score":0,"reason":"branch protection not enabled on development/release branches","details":["Warn: branch protection not enabled for branch 'master'"],"documentation":{"short":"Determines if the default and release branches are protected with GitHub's branch protection settings.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#branch-protection"}},{"name":"Vulnerabilities","score":0,"reason":"11 existing vulnerabilities detected","details":["Warn: Project is vulnerable to: PYSEC-2024-48 / GHSA-fj7x-q9j7-g6q6","Warn: Project is vulnerable to: PYSEC-2020-92 / GHSA-hj5v-574p-mj7c","Warn: Project is vulnerable to: PYSEC-2022-42969","Warn: Project is vulnerable to: PYSEC-2021-47 / GHSA-5jqp-qgf6-3pvh","Warn: Project is vulnerable to: GHSA-mr82-8j83-vxmv","Warn: Project is vulnerable to: GHSA-34jh-p97f-mpxf","Warn: Project is vulnerable to: PYSEC-2023-212 / GHSA-g4mx-q9vg-27p4","Warn: Project is vulnerable to: GHSA-pq67-6m6q-mj2v","Warn: Project is vulnerable to: PYSEC-2021-108 / GHSA-q2q7-5pp4-w6pg","Warn: Project is vulnerable to: PYSEC-2023-192 / GHSA-v845-jxx5-vc9f","Warn: Project is vulnerable to: PYSEC-2024-187 / GHSA-rqc4-2hc7-8c8v"],"documentation":{"short":"Determines if the project has open, known unfixed vulnerabilities.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#vulnerabilities"}},{"name":"SAST","score":0,"reason":"SAST tool is not run on all commits -- score normalized to 0","details":["Warn: 0 commits out of 18 are checked with a SAST tool"],"documentation":{"short":"Determines if the project uses static code analysis.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#sast"}}]},"last_synced_at":"2025-08-21T00:56:11.049Z","repository_id":57413267,"created_at":"2025-08-21T00:56:11.049Z","updated_at":"2025-08-21T00:56:11.049Z"},"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28413527,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-14T05:26:33.345Z","status":"ssl_error","status_checked_at":"2026-01-14T05:21:57.251Z","response_time":107,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["aws","cloudformation","graphs","graphviz","python"],"created_at":"2026-01-14T08:03:33.796Z","updated_at":"2026-01-14T08:03:34.445Z","avatar_url":"https://github.com/ludwigm.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"## Infrastructure Dependency visualization\n\n![Python package](https://github.com/ludwigm/infrastructure-graph/workflows/Build%20and%20Test%20Python%20package/badge.svg)\n\nThis tool is looking at CloudFormation Export/Imports and visualizes them. It can additionally abstract and group dependencies at a higher level based on Tags attached on the involved CloudFormation tags.\n\nIn its default configuration it is looking for the tags `ServiceName/Service` , `ComponentName/Component`and expects a stack naming scheme like the following:\n\n```\nreco-dev-storeloader-task-rfystorage\n\u003cproject\u003e-\u003cenv\u003e-\u003ccomponent_name\u003e\n```\n\nThis things can be changed and need to be changed if you want to apply it in other accounts.\n\nThis tool additionally looks for upstream external dependencies which are not in the targeted AWS account. It does that by looking for CloudFormation parameter descriptions with metadata embedded. The following is one example:\n```\nParameters:\n  ...\n  SnowflakeAccount:\n    Type: String\n    Description: \"The snowflake account name which is used to connect to. | team=Data,service=Snowflake\"\n```\n\nIt generates GraphViz output in the `output` folder. Other additionally interesting information about the stacks is displayed in the stdout and also exported as JSON.\n\n# Installation\n\nIf you don't want to clone the repo it is also possible to install this tool via Pypi. I recommend pipx instead of pip to not clutter your local python environment:\n\n```\npip install aws-infra-graph\npipx install aws-infra-graph\n```\n\n\n# Configuration\n\nRename the `config.hocon.template` to `config.hocon` and adapt if you have external downstream dependencies depending on your services.\nNames need to match up with discovered service names.\nAdditionally it is also possible to specify internal manual dependencies like manully create infrastructure components.\nIn the configuration it is also possible to configure for which CloudFormation tags the higher level grouping is done.\nInstead of having a config in your current folder you can also use `infra-graph init` which creates a config in `~/.config/aws-infra-graph/config.hocon`\n\n# How to execute\n\nIn case you cloned the source the following is needed:\n\n```\nbrew install graphviz # depends on the availability of the dot tool\npoetry install\npoetry shell\n```\n\nThe following commands work now either in your poetry venv or if you installed the software before via pip/pipx.\n```\ninfra-graph --help\ninfra-graph init\ninfra-graph export\nopen output/\n```\n\nHeavy operations like gathering data from AWS are cached to disk. In case you want to re-gather the data add the `--refresh` flag.\n\n# Usage\n\n```\nUsage: infra-graph [OPTIONS] COMMAND [ARGS]...\n\nOptions:\n  --help  Show this message and exit.\n\nCommands:\n  export  Gather data about the infra and visualize them\n  init    Initialize config after installation\n```\n\n```\nUsage: infra-graph export [OPTIONS]\n\n  Gather data about the infra and visualize them\n\nOptions:\n  -e, --env TEXT             On which environment to run this task. e.g. dev,\n                             stg, prd  [default: dev]\n\n  -t, --project-name TEXT    Project/Team name is expected of part of the\n                             resource name and need to be specified here or\n                             taken from config\n\n  -r, --refresh              In case of disc cached result clear them\n                             beforehand\n\n  -c, --cluster-stack-graph  Should the results of the stack graph be\n                             clustered by service?\n\n  -o, --output-folder TEXT   To which folder to export the generated files\n  --help                     Show this message and exit.\n```\n\n# Sample infra stacks\n\nThe folder `infra-sample` contains a sample infrastructure you can spin up if you want something to test visualizing.\n\nYou find more detail in the [Readme](infra-sample/README.md)\n\nThe outputs which are generated by this are the following:\n\n![Clustered Stacks](docs/clustered-export-stacks.gv.png)\n\n![Stacks](docs/export-stacks.gv.png)\n\n![Services](docs/export-services.gv.png)\n\nKeep in mind that this is a very simple output and it is only fun with a very big infrastructure :)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fludwigm%2Finfrastructure-graph","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fludwigm%2Finfrastructure-graph","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fludwigm%2Finfrastructure-graph/lists"}