feat: Simplify Lambda deployment with zip files instead of container images #18

RayyanSeliya · 2025-07-09T20:57:54Z

Implements Issue #16 by replacing the complex container image approach with simple Python source code deployment for Lambda functions.

Core Implementation

Created Python Lambda functions (index.py) for simple and canary deployments
Updated function.yaml files to use S3 zip deployment instead of ECR images
Added cross-platform build scripts (build.sh for Linux/Mac, build.bat for Windows)
Created automated setup scripts for easy configuration

Documentation Updates

Updated prerequisites in both English and Japanese tutorials
Created comprehensive README and deployment guides
Updated deployment instructions for new zip-based approach

Technical Improvements

Added proper error handling in build scripts
Cross-platform compatibility testing

Impact

Before: Users needed Docker, ECR repository, container building knowledge
After: Users only need Python 3.9+, S3 bucket, and basic IAM role

This dramatically reduces the barrier to entry for the Lambda tutorial, making it accessible to developers without container expertise.

Testing

Local function execution (both simple and canary)
Build script functionality (Windows/Linux)
Zip package creation and validation
Cross-platform compatibility
AWS integration (ready for testing)

See some screenshots of the implementation

RayyanSeliya · 2025-07-09T21:01:33Z

hey @t-kikuc i have implemented this feature you can have a look and ping me if any changes needed i have also done some basic testing skipped the aws one coz dont have an account yet !

t-kikuc · 2025-07-09T23:08:56Z

content/en/40-deploy/02-pipeline.md

  - Edit `lambda/canary/` as below.
-    - `function.yaml`: Copy from your `/src/deploy/lambda/simple/function.yaml`] and rename `name`.
+    - Build the canary function package: Run `./build.sh` (Linux/Mac) or `build.bat` (Windows)


Please make a procedure without building and pushing to s3. That's troublesome.

Use the zip packing feature of PipeCD Lambda.

Sure will research on this through https://pipecd.dev/docs-v0.52.x/user-guide/managing-application/defining-app-configuration/lambda/ and implement it accordingly

RayyanSeliya · 2025-07-10T07:20:52Z

hey @t-kikuc made necessary changes based on your feedback ! do let me know if any changes

t-kikuc · 2025-07-10T08:33:51Z

src/deploy/lambda/README.md

Users cannot find this file. Move to a better place.
Do you understand the tutorial flow?

Thank you @t-kikuc for your feedback. I initially focused on the Lambda ZIP deployment itself, but after your comments, I reviewed the tutorial structure to ensure my changes fit the main flow. I’ve deleted the standalone Lambda README and moved the instructions into 01-simply.md and 02-pipeline.md for clarity. Thanks again for helping me see the tutorial from the user’s perspective!

t-kikuc · 2025-07-10T08:33:58Z

src/deploy/lambda/README.md

+## 🎯 What's New (Issue #16)
+
+Previously, the Lambda tutorial required:
+- ❌ Building and pushing container images to ECR
+- ❌ Complex Docker setup
+- ❌ ECR repository management
+
+Now it uses:
+- ✅ Simple Python source code
+- ✅ **Automatic packaging by PipeCD**
+- ✅ **No manual zip building or S3 uploads**
+- ✅ Minimal prerequisites (just an IAM role)


unnecessary

…al flow !

t-kikuc · 2025-07-12T05:28:31Z

content/ja/40-deploy/02-pipeline.md

@@ -21,8 +21,9 @@ _手順は[1. シンプルなデプロイ](01-simply.md)とほとんど同じで
    - `servicedef.yaml`: `/src/deploy/ecs/simple/servicedef.yaml`からコピーして、`serviceName`を変更
    - `taskdef.yaml`: `/src/deploy/ecs/simple/taskdef.yaml`からコピーして、`family`を変更
 - **AWS Lambda**向け:
-  - あなたのイメージを利用して関数をCanaryリリースしていきます。
-  - `lambda/canary/`を以下のように編集してください。
+  - Canaryデプロイ戦略を使用してあなた自身のPythonソースコードから関数を作成します。


Suggested change

- Canaryデプロイ戦略を使用してあなた自身のPythonソースコードから関数を作成します。

- Canaryデプロイ戦略を使用してPythonソースコードから関数を作成します。

t-kikuc · 2025-07-12T05:31:26Z

content/en/40-deploy/01-simply.md

-  - You will create a function of your own image.
-  - Edit `lambda/simple/` as below.
-    - `function.yaml`: Edit `role` and `image`.
+  - You will create a function from your own Python source code.


not 'your own code'

t-kikuc · 2025-07-12T05:33:12Z

content/en/40-deploy/02-pipeline.md

-  - Edit `lambda/canary/` as below.
-    - `function.yaml`: Copy from your `/src/deploy/lambda/simple/function.yaml`] and rename `name`.
+  - You will create a function from your own Python source code using a canary deployment strategy.
+  - Edit `lambda/canary/function.yaml`: Copy from your `src/deploy/lambda/simple/function.yaml` and rename the `name`.


are you gonna copy??

t-kikuc · 2025-07-12T05:37:50Z

src/deploy/lambda/simple/function.yaml

+    git: ""  # Empty means same repository
+    ref: ""  # Empty means current commit


how did you know this spec?

how did you know this spec?

hey @t-kikuc I implemented this based on the code comments and the pattern I saw in other PipeCD resources. The Helm chart docs mention that 'Empty means the same repository' (https://pipecd.dev/docs-v0.52.x/user-guide/configuration-reference/#analysis-template-configuration:~:text=Empty%20means%20the%20same%20repository), and I assumed this convention applies to Lambda functions too.

If this approach isn't correct for Lambda functions, I'd appreciate your guidance on what values should be used instead for the tutorial. Should we use explicit git/ref values or is there a better way to reference the current repository?

This is not helm chart.

See https://pipecd.dev/docs-v0.52.x/user-guide/managing-application/defining-app-configuration/lambda/ and https://github.com/pipe-cd/pipecd/blob/0c999367d009c143baa72785d4ad6bd841bdb189/pkg/app/piped/platformprovider/lambda/function.go#L128-L142

This is not helm chart.

See https://pipecd.dev/docs-v0.52.x/user-guide/managing-application/defining-app-configuration/lambda/ and https://github.com/pipe-cd/pipecd/blob/0c999367d009c143baa72785d4ad6bd841bdb189/pkg/app/piped/platformprovider/lambda/function.go#L128-L142

@t-kikuc Thank you for pointing out my mistake with the empty git / ref fields. I've corrected both function.yaml files to align exactly with the documentation at https://pipecd.dev/docs-v0.52.x/user-guide/managing-application/defining-app-configuration/lambda/#:~:text=Deploy%20source%20code,Lambda%20function%20pattern. I've maintained the same comment style as the official example while using HTTPS URLs for GitHub repositories, which is more beginner-friendly for the tutorial. The [EDIT_HERE] markers will guide users to replace these values with their own repository information.

RayyanSeliya · 2025-07-12T07:54:35Z

hey @t-kikuc i see that i have made several mistakes and thanks for pointing out me updated some of the mistakes you can have a look and discuss about this #18 (comment)

feat: implement zip-based Lambda deployment to reduce prerequisite

e61ef22

RayyanSeliya requested a review from t-kikuc as a code owner July 9, 2025 20:57

updated some necessarry changes

c0b5cc3

t-kikuc requested changes Jul 9, 2025

View reviewed changes

made a procedure without building and pushing to s3

76a1c4d

RayyanSeliya requested a review from t-kikuc July 10, 2025 07:21

t-kikuc requested changes Jul 10, 2025

View reviewed changes

removed standalone readme and aligned the instruction with the tutori…

cfd3d2c

…al flow !

RayyanSeliya requested a review from t-kikuc July 10, 2025 10:42

t-kikuc requested changes Jul 12, 2025

View reviewed changes

RayyanSeliya added 2 commits July 12, 2025 13:18

typo fixed in the description and corrected the description

8456252

aligned the text of english version to match with japanese version

918d6a4

RayyanSeliya requested a review from t-kikuc July 12, 2025 07:54

updated the git ref fields and related comments

5c377df

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

feat: Simplify Lambda deployment with zip files instead of container images #18

feat: Simplify Lambda deployment with zip files instead of container images #18

Uh oh!

RayyanSeliya commented Jul 9, 2025 •

edited

Loading

Uh oh!

RayyanSeliya commented Jul 9, 2025

Uh oh!

t-kikuc Jul 9, 2025

Uh oh!

RayyanSeliya Jul 10, 2025

Uh oh!

RayyanSeliya commented Jul 10, 2025

Uh oh!

t-kikuc Jul 10, 2025

Uh oh!

RayyanSeliya Jul 10, 2025 •

edited

Loading

Uh oh!

t-kikuc Jul 10, 2025

Uh oh!

t-kikuc Jul 12, 2025

Uh oh!

t-kikuc Jul 12, 2025

Uh oh!

t-kikuc Jul 12, 2025

Uh oh!

t-kikuc Jul 12, 2025

Uh oh!

RayyanSeliya Jul 12, 2025

Uh oh!

t-kikuc Jul 12, 2025

Uh oh!

RayyanSeliya Jul 13, 2025

Uh oh!

RayyanSeliya commented Jul 12, 2025

Uh oh!

Uh oh!

	- Canaryデプロイ戦略を使用してあなた自身のPythonソースコードから関数を作成します。
	- Canaryデプロイ戦略を使用してPythonソースコードから関数を作成します。

		git: "" # Empty means same repository
		ref: "" # Empty means current commit

feat: Simplify Lambda deployment with zip files instead of container images #18

Are you sure you want to change the base?

feat: Simplify Lambda deployment with zip files instead of container images #18

Uh oh!

Conversation

RayyanSeliya commented Jul 9, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Core Implementation

Documentation Updates

Technical Improvements

Impact

Testing

See some screenshots of the implementation

Uh oh!

RayyanSeliya commented Jul 9, 2025

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

RayyanSeliya commented Jul 10, 2025

Uh oh!

Choose a reason for hiding this comment

Uh oh!

RayyanSeliya Jul 10, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

RayyanSeliya commented Jul 12, 2025

Uh oh!

Uh oh!

RayyanSeliya commented Jul 9, 2025 •

edited

Loading

RayyanSeliya Jul 10, 2025 •

edited

Loading