Skip to content

docs(aws/tutorials): migrate /aws/tutorials section to use lstk - #875

Open
peter-smith-phd wants to merge 18 commits into
doc-312-aws-docs-to-use-lstkfrom
devx-1030-migrate-tutorials-to-lstk
Open

docs(aws/tutorials): migrate /aws/tutorials section to use lstk#875
peter-smith-phd wants to merge 18 commits into
doc-312-aws-docs-to-use-lstkfrom
devx-1030-migrate-tutorials-to-lstk

Conversation

@peter-smith-phd

@peter-smith-phd peter-smith-phd commented Aug 18, 2026

Copy link
Copy Markdown
Contributor

Overview

Migrates the /aws/tutorials section to the lstk CLI, continuing the section-by-section migration in #862 / #800 / #815 / #789 / #792. Each of the 17 tutorials is converted from localstack / awslocal / tflocal / cdklocal to the equivalent lstk, lstk aws, and lstk terraform commands, with prerequisites and installation links repointed accordingly.

In some tutorials, a small number of sentences were removed because they illustrated minor features that aren't supported by lstk. This doesn't materially impact the overall tutorial.

In general, this PR does not attempt to fix broken/stale tutorials, but instead focused on migrating to lstk. There were however a few minor changes made, based on asking Claude to "run the tutorial" and report if it works or not.

  • iam-policy-stream — the tutorial claimed that with IAM_SOFT_MODE=1 the SendMessage call is denied and the queue stays empty. However, Soft mode logs the violation but does not block the call, so the message is delivered.

  • reproducible-machine-learning-cloud-pods — corrected the merge strategy names (account-region-merge is the default; overwrite and service-merge are the others — the previously documented "basic merge" and "deep merge" do not exist).

  • schema-evolution-glue-msk — deleted the "Testing the application" section. It was built on commands that do not exist (awslocal kafka-produce, awslocal kafka-consume, awslocal glue register-schema-version), and the example data did not match the rest of the tutorial.

As a follow-up exercise, it's recommended that we perform each of these tutorials end-to-end, to find other things that have drifted over time.

@cloudflare-workers-and-pages

cloudflare-workers-and-pages Bot commented Aug 18, 2026

Copy link
Copy Markdown

Deploying localstack-docs with  Cloudflare Pages  Cloudflare Pages

Latest commit: 0901a29
Status: ✅  Deploy successful!
Preview URL: https://234315fc.localstack-docs.pages.dev
Branch Preview URL: https://devx-1030-migrate-tutorials.localstack-docs.pages.dev

View logs

@peter-smith-phd
peter-smith-phd marked this pull request as ready for review August 18, 2026 22:43
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant