{"id":18485897,"url":"https://github.com/biomapas/b.awscdkparallel","last_synced_at":"2025-04-08T19:32:59.419Z","repository":{"id":40410294,"uuid":"352156200","full_name":"Biomapas/B.AwsCdkParallel","owner":"Biomapas","description":"Enables parallel stack deployments for AWS CDK tool.","archived":false,"fork":false,"pushed_at":"2022-12-02T11:54:43.000Z","size":82,"stargazers_count":16,"open_issues_count":0,"forks_count":2,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-03-23T17:45:51.297Z","etag":null,"topics":["aws","aws-cdk","aws-cdk-python","cloudformation","python3"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Biomapas.png","metadata":{"files":{"readme":"README.md","changelog":"HISTORY.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2021-03-27T19:12:28.000Z","updated_at":"2024-12-30T07:10:29.000Z","dependencies_parsed_at":"2023-01-22T22:15:53.896Z","dependency_job_id":null,"html_url":"https://github.com/Biomapas/B.AwsCdkParallel","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Biomapas%2FB.AwsCdkParallel","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Biomapas%2FB.AwsCdkParallel/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Biomapas%2FB.AwsCdkParallel/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Biomapas%2FB.AwsCdkParallel/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Biomapas","download_url":"https://codeload.github.com/Biomapas/B.AwsCdkParallel/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247912789,"owners_count":21017045,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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","aws-cdk","aws-cdk-python","cloudformation","python3"],"created_at":"2024-11-06T12:47:04.570Z","updated_at":"2025-04-08T19:32:59.156Z","avatar_url":"https://github.com/Biomapas.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# B.AwsCdkParallel\n\nA python based package that enables AWS CDK parallel stack deployments.\n\n### Description\n\nOne of the biggest downsides of AWS CDK IaC tool is the sequential deployments.\nIf you have many stacks within your project - it can take hours and hours till\neverything gets deployed. Wouldn't it be cool to parallelize them? According to \nAWS CDK tool maintainers - they are not even thinking right now to include such \nfunctionality. Hence, this project was built. This project allows you to run \ntraditional `cdk deploy *` and `cdk destroy * -f`. But the main trick is that it \ncan do it in parallel - massively increasing the speed of your deployments.\n\n### Remarks\n\n[Biomapas](https://biomapas.com) aims to modernise life-science \nindustry by sharing its IT knowledge with other companies and \nthe community. This is an open source library intended to be used \nby anyone. Improvements and pull requests are welcome.\n\nSome techniques and inspirations were taken from this blog post:\u003cbr\u003e\nhttps://taimos.de/blog/deploying-your-cdk-app-to-different-stages-and-environments\n\nGeneral issue is being discussed on github:\u003cbr\u003e\nhttps://github.com/aws/aws-cdk/issues/1973\n\n### Related technology\n\n- Python 3\n- AWS CDK\n- AWS CloudFormation\n\n### Assumptions\n\nThe project assumes the following:\n\n- You have basic-good knowledge in python programming.\n- You have basic-good knowledge in AWS.\n- You have very good knowledge in AWS CDK.\n\n### Useful sources\n\n- Read more AWS CDK:\u003cbr\u003e\nhttps://github.com/aws/aws-cdk\n  \n- Read more about parallel AWS CDK deployments:\u003cbr\u003e\nhttps://taimos.de/blog/deploying-your-cdk-app-to-different-stages-and-environments\n\n### Install\n\nThe project is built and uploaded to PyPi. Install it by using pip.\n\n```\npip install b_aws_cdk_parallel\n```\n\nOr directly install it through source.\n\n```\npip install .\n```\n\n### Usage \u0026 Examples\n\n#### Programmatic usage\n\nThe quickest and easiest example:\n\n```python\nfrom b_aws_cdk_parallel.deployment_executor import DeploymentExecutor\nfrom b_aws_cdk_parallel.deployment_type import DeploymentType\n\nexecutor = DeploymentExecutor(type=DeploymentType.DEPLOY)\nexecutor.run()\n\nexecutor = DeploymentExecutor(type=DeploymentType.DESTROY)\nexecutor.run()\n```\n\nThe more advanced example to deploy/destroy:\n\n```python\nfrom b_aws_cdk_parallel.deployment_executor import DeploymentExecutor\nfrom b_aws_cdk_parallel.deployment_type import DeploymentType\nfrom b_aws_cdk_parallel.cdk_arguments import CdkArguments\n\nexecutor = DeploymentExecutor(\n    type=DeploymentType.DEPLOY, # Or DESTROY\n    # You can specify a full path to your CDK app.\n    path='/optional/path/to/cdk/app',\n    # You can specify OS-level global parameters.\n    env={\n        'optional': 'os-level environment variables'\n    },\n    # You can specify AWS-CDK-specific arguments.\n    cdk_arguments=CdkArguments(\n        aws_cdk_app_stacks_to_deploy=['MyCoolStack'],\n        aws_cdk_app_parameters=['Test1=Test1'],\n        aws_cdk_app_context=['Context1=Context1']\n    )\n)\n\nexecutor.run()\n```\n\nThe library generates beautiful stack dependency outputs for easier debugging:\n\n```\n----- Stack dependency graph: -----\n» Stack1: []\n× Stack2: [Stack1]\n× Stack3: [Stack1]\n× Stack4: [Stack1, Stack2, Stack3]\n× Stack5: [Stack1, Stack4]\n» Stack8: []\n× Stack7: [Stack1, Stack2, Stack3, Stack4, Stack5]\n× Stack6: [Stack1, Stack7]\n× Stack10: [Stack1, Stack6, Stack7]\n× Stack9: [Stack1, Stack8]\n» B-Aws-Cdk-Parallel-MainStack-3: []\n\n\n[Stack2]  Doing stuff...\n[Stack2]  Doing stuff...\n[Stack4]  Doing stuff...\n[Stack3]  Doing stuff...\n```\n\n#### CLI usage\n\nThe library also exposes CLI access. \n\nTo get usage help, simply run:\n\n```\nacdk -h\n```\n\nTo deploy infrastructure, run:\n\n```\nacdk deploy --path /project/app/\n```\n\nTo destroy infrastructure, run:\n\n```\nacdk destroy --path /project/app/\n```\n\n### Testing\n\nThis project has integration tests based on pytest. To run tests, simply run:\n\n```\npytest b_aws_cdk_parallel_test/integration/tests\n```\n\n### Contribution\n\nFound a bug? Want to add or suggest a new feature?\u003cbr\u003e\nContributions of any kind are gladly welcome. You may contact us \ndirectly, create a pull-request or an issue in github platform.\nLets modernize the world together.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbiomapas%2Fb.awscdkparallel","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbiomapas%2Fb.awscdkparallel","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbiomapas%2Fb.awscdkparallel/lists"}