DOC-428(sept 8 launch hotfix): Update remainder of Snowflake docs to push lstk - #908
Merged
quetzalliwrites merged 5 commits intoSep 7, 2026
Conversation
Follows the same lstk migration already done for AWS/Azure docs and for Snowflake Getting Started (#878). Covers everything else under /snowflake/ that still referenced the legacy `localstack` CLI: - capabilities/configuration.md: rewrite the env var intro and the "CLI" section to match AWS's configuration-options.md pattern (LOCALSTACK_-prefixed env vars, .lstk/config.toml env profiles, cross-link to the lstk config reference). Drop the "Profiles" section entirely (CONFIG_PROFILE/*.env files have no lstk equivalent, same as the AWS docs already did) and fold LOCALSTACK_VOLUME_DIR into the Docker table. - capabilities/init-hooks.mdx: replace the CLI tab with the lstk .lstk/config.toml `volumes` pattern, matching aws/customization/advanced/initialization-hooks.mdx. - capabilities/state-management.mdx: `PERSISTENCE=1 localstack start` -> `lstk start --persist`; `localstack state export/import` -> `lstk snapshot save/load`, matching the AWS persistence and snapshots docs. - tooling/user-interface.md and the three tutorials: swap the `localstack` CLI prerequisite links and `localstack start --stack snowflake` invocations for `lstk`/`lstk start --type snowflake`, and prefix forwarded env vars with LOCALSTACK_ where needed.
quetzalliwrites
requested review from
HarshCasper and
remotesynth
as code owners
September 1, 2026 19:38
Deploying localstack-docs with
|
| Latest commit: |
4c53506
|
| Status: | ✅ Deploy successful! |
| Preview URL: | https://4cb7b995.localstack-docs.pages.dev |
| Branch Preview URL: | https://doc-428-docs-update-remainde.localstack-docs.pages.dev |
mmaureenliu
approved these changes
Sep 1, 2026
mmaureenliu
left a comment
There was a problem hiding this comment.
Lgtm. Some minor comments to address but I'll pre-approve.
|
Actually found a (slightly) bigger problem on Peter's reminder: All should be updated to |
- capabilities/configuration.md: replace the two bash export examples for custom Snowflake hostnames with the .lstk/config.toml env profile pattern Maureen specified in PRO-327, instead of exporting LOCALSTACK_-prefixed env vars inline. - capabilities/init-hooks.mdx: add an inline comment noting DEBUG is optional and only helps diagnose init hook issues, not required. - capabilities/state-management.mdx: note that resuming a persisted session or restarting with persistence on requires passing --persist again (lstk start --persist / lstk restart --persist); rename the <file-name> placeholder to <path-to-snapshot-file> for clarity; link to the lstk snapshot docs for the full list of supported save destinations. - tutorials/credit-scoring-with-localstack-snowpark.md and tutorials/s3-tables-iceberg-integration.md: simplify `lstk start --type snowflake` to plain `lstk start`. - Fix the bigger issue Maureen found: awslocal was still used in eight feature/integration docs this PR's scope missed (snowpipe, glue-catalog, storage-integrations, stages, dynamic-tables, iceberg-tables, polaris-catalog, airflow) plus two tutorials already touched by this PR. Replaced every awslocal invocation and prose reference with lstk aws, matching the pattern already established across the AWS docs (`lstk aws <command>`, prereq links to /aws/developer-tools/running-localstack/lstk/#aws).
Collaborator
Author
|
tyvm @mmaureenliu! Pushed
|
…or-pushing-lstk # Conflicts: # src/content/docs/snowflake/features/glue-catalog.md # src/content/docs/snowflake/tutorials/aws-lambda-localstack-snowpark.md # src/content/docs/snowflake/tutorials/s3-tables-iceberg-integration.md
Two links in configuration.md still pointed at the old /aws/developer-tools/running-localstack/lstk#... single-page anchors, missed by the merge conflict resolution since this file wasn't part of the conflicting set. Point them at the post-split configuration/ subpage, matching the pattern already used in aws/customization/configuration-options.md.
hotfix): Update remainder of Snowflake docs to push lstk
…or-pushing-lstk # Conflicts: # src/content/docs/snowflake/tutorials/aws-lambda-localstack-snowpark.md # src/content/docs/snowflake/tutorials/credit-scoring-with-localstack-snowpark.md # src/content/docs/snowflake/tutorials/s3-tables-iceberg-integration.md
quetzalliwrites
deleted the
doc-428-docs-update-remainder-of-snow-docs-for-pushing-lstk
branch
September 7, 2026 07:52
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
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
Follows the same lstk migration already done for AWS/Azure docs, and for Snowflake Getting Started in #878. This covers everything else under
/snowflake/that still referenced the legacylocalstackCLI (scoped by grepping the whole tree forlocalstack start/--stack snowflake/`localstack` CLIand excludinggetting-started/, which #878 already owns):capabilities/configuration.md: rewrote the env var intro and the "CLI" section to matchaws/customization/configuration-options.md's already-established pattern (LOCALSTACK_-prefixed env vars,.lstk/config.tomlenv profiles, cross-link to the lstk config reference). Dropped the "Profiles" section entirely —CONFIG_PROFILE/*.envfiles have nolstkequivalent, which is exactly why the AWS docs already dropped this section rather than translating it. FoldedLOCALSTACK_VOLUME_DIRinto the Docker table, again matching AWS.capabilities/init-hooks.mdx: replaced the "CLI" tab with thelstk.lstk/config.tomlvolumespattern, matchingaws/customization/advanced/initialization-hooks.mdx.capabilities/state-management.mdx:PERSISTENCE=1 localstack start→lstk start --persist;localstack state export/import→lstk snapshot save/load, matching the AWS persistence and snapshots docs.tooling/user-interface.mdand the three tutorials: swapped the`localstack` CLIprerequisite links andlocalstack start --stack snowflakeinvocations forlstk/lstk start --type snowflake, and prefixed forwarded env vars withLOCALSTACK_where needed (required forlstk startto forward them into the container).awslocalwrapper usage in the tutorials was left untouched — that's a separate, still-supported wrapper script, not the legacylocalstackCLI this ticket targets.Linear ticket
https://linear.app/localstack/issue/DOC-428/docs-update-remainder-of-snow-docs-for-pushing-lstk
Test plan
npx astro buildcompletes successfully (405 pages built)/snowflake/tree afterward for any remaininglocalstack start/--stack snowflake/legacy CLI references outsidegetting-started/— none found