Skip to content

DOC-361: Migrate localstack CLI refs to lstk in Azure docs#803

Open
quetzalliwrites wants to merge 2 commits into
mainfrom
doc-361-migrate-all-localstack-cli-refs-to-lstk-in-azure-docs
Open

DOC-361: Migrate localstack CLI refs to lstk in Azure docs#803
quetzalliwrites wants to merge 2 commits into
mainfrom
doc-361-migrate-all-localstack-cli-refs-to-lstk-in-azure-docs

Conversation

@quetzalliwrites

Copy link
Copy Markdown
Collaborator

Summary

  • Replace azlocal start-interception/stop-interception with lstk az start-interception/lstk az stop-interception across all 40 Azure service pages that use the interception workflow.
  • Rewrite integrations/az.md to the lstk az pattern (lstk setup azure once, then prefix az commands with lstk az), matching the getting-started quickstart already updated in DOC-360.
  • integrations/python.md: left azlocal's Python SDK (PythonLocalSdk) as-is since lstk has no Python SDK equivalent, but added a note explaining the discrepancy with the az CLI examples elsewhere.
  • integrations/azd.md: left untouched — azdlocal (the azd/Bicep wrapper) isn't something lstk proxies at all.
  • Getting Started docs are out of scope here (handled separately in DOC-360 / DOC-360: Update Azure getting started guide to use lstk #802).

Linear: https://linear.app/localstack/issue/DOC-361/migrate-all-localstack-cli-refs-to-lstk-in-azure-docs

Test plan

  • astro build completes successfully
  • starlight-links-validator reports all internal links valid
  • Confirmed no remaining azlocal/localstack CLI refs outside the two intentionally-excluded files

Replace azlocal's start-interception/stop-interception commands with
lstk az across the Azure service pages and the az integration guide.
azdlocal (azd.md) and azlocal's Python SDK (python.md) are left as-is
since lstk has no equivalent for either.
@cloudflare-workers-and-pages

cloudflare-workers-and-pages Bot commented Jul 20, 2026

Copy link
Copy Markdown

Deploying localstack-docs with  Cloudflare Pages  Cloudflare Pages

Latest commit: 42436ff
Status: ✅  Deploy successful!
Preview URL: https://0696a14f.localstack-docs.pages.dev
Branch Preview URL: https://doc-361-migrate-all-localsta.localstack-docs.pages.dev

View logs

@mmaureenliu mmaureenliu left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Only one real change needed: similar to my comment on the quickstart, the az CLI doc should use the start/stop-interception as preferred mode.

I also notice there's still some lingering azlocal and azdlocal and have asked the team about them.

Comment thread src/content/docs/azure/integrations/az.md
Comment thread src/content/docs/azure/services/blob-storage.mdx Outdated
Comment thread src/content/docs/azure/services/queue-storage.mdx Outdated
Lead with lstk az start-interception/stop-interception as the
recommended default in the az integration guide, with the
lstk setup azure + prefixed lstk az commands as an alternative.
Drop the now-redundant interception notes in blob-storage and
queue-storage that predate this recommendation.
@quetzalliwrites

Copy link
Copy Markdown
Collaborator Author

ready for you again @mmaureenliu 🐈‍⬛

@mmaureenliu mmaureenliu left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM. Made a very minor nit-pick.

$ lstk az stop-interception
```

The `az` CLI tool will now communicate with the Azure REST API on future invocations.

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Though this is technically true, I think it's easier to comprehend if we say now it points to the real Azure cloud

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.

2 participants