lstk Cloud & IaC Commands

lstk proxies developer tools so they run directly against LocalStack.

Note

lstk az does not start the emulator, start it first with lstk start. It requires the Azure CLI to be installed and on your PATH. To run it against an emulator lstk did not start, pass --endpoint-url (or set LSTK_ENDPOINT_URL).

az

Run Azure CLI commands against the running LocalStack Azure emulator. lstk az runs az with an isolated AZURE_CONFIG_DIR in which a custom Azure cloud is registered against LocalStack’s endpoints, so your global ~/.azure configuration is left untouched and plain az keeps talking to real Azure.

Run lstk setup azure once before using this mode. Arguments are forwarded to the host az binary, and its exit code and output are passed through unchanged. lstk’s own flags (--non-interactive, --config) are consumed by lstk rather than forwarded, for example lstk az --non-interactive … suppresses the loading spinner instead of passing the flag to az.

lstk az group list
lstk az storage account list

The Azure CLI has no --endpoint-url/--profile equivalent, so the isolation relies entirely on the dedicated config directory prepared by setup azure.

Global interception (optional)

If a script must invoke plain az (not lstk az), you can redirect your global ~/.azure to LocalStack instead:

# Point global 'az' at the LocalStack Azure emulator
lstk az start-interception

# Switch back to real Azure
lstk az stop-interception

start-interception registers and activates the LocalStack cloud in your global Azure configuration so every az invocation targets LocalStack until you stop it. stop-interception switches the active cloud back to AzureCloud (override with --cloud <name>) and re-enables instance discovery, but only when LocalStack is still the active cloud, to avoid clobbering an unrelated selection.

Caution

Interception changes global state that affects every az command in any terminal. Use the isolated lstk az <args> mode unless you specifically need plain az to target LocalStack.

Note

lstk also proxies the AWS CLI (lstk aws), Terraform (lstk terraform), the AWS CDK (lstk cdk), and the AWS SAM CLI (lstk sam), but all four target the AWS emulator specifically; see the AWS docs for those. To use Terraform against the Azure emulator, use the azurerm provider directly, see Terraform.