https://github.com/erankitcs/awscdkworkshop
Hands-On Workshop on AWS CDK.
https://github.com/erankitcs/awscdkworkshop
aws aws-cdk cdk python serverless
Last synced: 1 day ago
JSON representation
Hands-On Workshop on AWS CDK.
- Host: GitHub
- URL: https://github.com/erankitcs/awscdkworkshop
- Owner: erankitcs
- Created: 2021-11-25T13:22:37.000Z (over 4 years ago)
- Default Branch: master
- Last Pushed: 2022-01-01T05:04:01.000Z (over 4 years ago)
- Last Synced: 2025-12-29T19:48:55.000Z (4 months ago)
- Topics: aws, aws-cdk, cdk, python, serverless
- Language: Python
- Homepage:
- Size: 187 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Welcome to your CDK Python project!
## Feature
1. Simple API built using AWS CDK Python.
2. Custom Construct feature of AWS CDK.
3. Uses of Pre-Built Construct Libraries.
4. Automated Testing and Validation of AWS CDK based Apps.
5. CDK Pipeline for Deployment of Apps and Validation.
## Architecture-
### Basic App with CDK Construct
### Basic App with Imported CDK Construct
### CI/CD Pipeline for CDK App
You should explore the contents of this project. It demonstrates a CDK app with an instance of a stack (`awscdk_workshop_stack`)
which contains an Amazon SQS queue that is subscribed to an Amazon SNS topic.
The `cdk.json` file tells the CDK Toolkit how to execute your app.
This project is set up like a standard Python project. The initialization process also creates
a virtualenv within this project, stored under the .venv directory. To create the virtualenv
it assumes that there is a `python3` executable in your path with access to the `venv` package.
If for any reason the automatic creation of the virtualenv fails, you can create the virtualenv
manually once the init process completes.
To manually create a virtualenv on MacOS and Linux:
```
$ python -m venv .venv
```
After the init process completes and the virtualenv is created, you can use the following
step to activate your virtualenv.
```
$ source .venv/bin/activate
```
If you are a Windows platform, you would activate the virtualenv like this:
```
% .venv\Scripts\activate.bat
```
Once the virtualenv is activated, you can install the required dependencies.
```
$ pip install -r requirements.txt
```
At this point you can now synthesize the CloudFormation template for this code.
```
$ cdk synth
```
You can now begin exploring the source code, contained in the hello directory.
There is also a very trivial test included that can be run like this:
```
$ pip install -r requirements-dev.txt
$ pytest
```
To add additional dependencies, for example other CDK libraries, just add to
your requirements.txt file and rerun the `pip install -r requirements.txt`
command.
## Tutorial
See [this useful workshop](https://cdkworkshop.com/30-python.html) on working with the AWS CDK for Python projects.
## Useful commands
* `cdk ls` list all stacks in the app
* `cdk synth` emits the synthesized CloudFormation template
* `cdk deploy` deploy this stack to your default AWS account/region
* `cdk diff` compare deployed stack with current state
* `cdk docs` open CDK documentation
Enjoy!