DOC-360: Update Azure getting started guide to use lstk#802
Open
quetzalliwrites wants to merge 2 commits into
Open
DOC-360: Update Azure getting started guide to use lstk#802quetzalliwrites wants to merge 2 commits into
quetzalliwrites wants to merge 2 commits into
Conversation
Replace the localstack CLI and azlocal wrapper across the Azure Getting Started docs with lstk, mirroring the AWS Getting Started guide.
quetzalliwrites
requested review from
HarshCasper and
remotesynth
as code owners
July 20, 2026 23:00
Deploying localstack-docs with
|
| Latest commit: |
f3bc634
|
| Status: | ✅ Deploy successful! |
| Preview URL: | https://53a64ba8.localstack-docs.pages.dev |
| Branch Preview URL: | https://doc-360-update-azure-getting.localstack-docs.pages.dev |
3 tasks
mmaureenliu
requested changes
Jul 21, 2026
mmaureenliu
left a comment
mmaureenliu
left a comment
There was a problem hiding this comment.
Thanks! I've left some comments mostly highlighting where things are done differently for the Azure emulator.
| ### Configure lstk for Azure | ||
|
|
||
| You can start the Azure emulator using the following methods: | ||
| `lstk` starts the AWS emulator by default. To target the Azure emulator instead, create a project-local `.lstk/config.toml`: |
There was a problem hiding this comment.
That's no longer true. If user starts lstk for the first time it will ask you to pick an emulator and record your choice in the global config as the default. So I'd move this section below "Update lstk" and frame it as "What to do if you already use lstk and your global config defaults to the AWS emulator"
- Simplify the auth-token lstk section: just run lstk/lstk start, since lstk resolves the token automatically; drop manual env var instructions in favor of lstk login for credential issues. - Reorder the installation intro to lead with the lstk recommendation (mirroring the AWS getting started guide), and move the manual per-project config.toml override below Update lstk, framed as an edge case for users whose global config already defaults elsewhere. Note that the first lstk run also prompts for an emulator choice. - Quickstart: recommend lstk az start-interception/stop-interception as the default flow (plain az commands in between), with lstk setup azure + prefixed lstk az commands as the alternative. Add explicit lstk start/stop steps.
Collaborator
Author
|
ready for you again @mmaureenliu ! |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
localstackCLI andazlocalwrapper across the Azure Getting Started docs (installation,auth-token,quickstart) withlstk, mirroring the AWS Getting Started guide.installation.mdx: added anlstksection (install/configure-for-azure/start/update) as the recommended install path; removed the oldlocalstackCLI subsection; Docker CLI/Compose kept as secondary options.auth-token.mdx: replaced the "LocalStack CLI" auth subsection and troubleshooting mention withlstk's auth flow (LOCALSTACK_AUTH_TOKENenv var orlstk login).quickstart.md: replacedazlocal start-interception/stop-interceptionwithlstk setup azure+lstk az <command>prefixing. NativeazCLI commands and theazCLI prerequisite are unchanged.Linear: https://linear.app/localstack/issue/DOC-360/update-azure-getting-started-guide-to-use-lstk
Test plan
astro buildcompletes successfullystarlight-links-validatorreports all internal links and anchors valid