awslabs / aws-lambda-rust-runtime

A Rust runtime for AWS Lambda
Apache License 2.0
3.29k stars 335 forks source link

Added Build and Deploy section for vanilla bash approach #902

Closed rimutaka closed 1 month ago

rimutaka commented 1 month ago

Our build and deploy instructions are focused on cargo lambda which hides a lot of complexity, but I feel like we should provide an explanation of the fundamentals needed to build and deploy Rust lambdas.

This change should help with understanding the basics and reduce issues like #878 and a bunch of others related to AL2/GLIBC.

I added an overview section and made a few tweaks in other parts to remove repetition. There is still some duplication with the existing content. I'd like to address that in a separate PR.

Feel free to shoot this down. No hard feelings at all. I can always write a blog post explaining it if you think it does not belong in the README.

Changes:

🔏 By submitting this pull request

rimutaka commented 1 month ago

@calavera , David, sorry, I'm not sure what change you requested. Shall I move the pure bash part to the back somewhere?

calavera commented 1 month ago

This change should help with understanding the basics and reduce issues like #878 and a bunch of others related to AL2/GLIBC.

What are the other related AL2/GLIBC issues? so far, the only problem I've seen people bumping into is trying to run their code against an older GLIBC version. If the goal is helping people troubleshoot those issues, I don't think these changes will help, as they don't explain the problem or the solution. It might be more useful to have a "troubleshooting" section where we explain those kind of issues directly.

I'm ok if you want to compliment some other sections below with more details about creating things manually, but I don't want it as the first option as it was the largest pain point that people had when I started maintaining this project two years ago.

rimutaka commented 1 month ago

Not sure this is needed.