From bd20c79ba94f5cae0f1569b6f7e60c89e8735ca0 Mon Sep 17 00:00:00 2001 From: Paolo Salvatori Date: Tue, 27 Oct 2026 14:51:19 +0100 Subject: [PATCH] Write every README note as a GitHub alert The READMEs wrote their callouts five ways: GitHub alerts (> [!NOTE]), a bold marker on its own line (> **Note**), an inline bold marker (> **Note:** text), a plain **Note:** paragraph, and one blockquote with no marker. Every callout is now a GitHub alert, with the type that matches what it says: - IMPORTANT: the Mac notes, the SQL Server EULA notes, and the note that the Event Hubs and Event Grid sample needs cdn.functions.azure.com to resolve. - TIP: the lstk az hints, the Azure CLI --verbose and --debug hint, and the storage account key hint. - CAUTION: pinning an emulator image older than localstack-pro#8102 breaks every Function App deployment on arm64. - NOTE: the first-deployment timing notes, the AKS samples pointer, the Terraform differences, the Java app running on the host, and the commented-out Service Bus function. The text stays as it was, except the Core Tools note of function-app-storage-http, which named 4.2.2 and AZURE_FUNCTIONS_CORE_TOOLS_VERSION: the emulator's default is 4.15.1 (4.13.0 on arm64), set through LS_AZURE_FUNCTIONS_CORE_TOOLS_VERSION. Fixes SMF-992 Co-Authored-By: Claude Opus 5.5 Claude-Session: https://claude.ai/code/session_01NGfV8ZhpdZCZfbmfwWd3Sw --- README.md | 5 +++-- samples/aci-blob-storage/python/terraform/README.md | 3 ++- samples/api-management-function-app/python/README.md | 2 +- samples/eventhubs-eventgrid/python/README.md | 3 ++- samples/eventhubs/python/README.md | 4 ++-- samples/function-app-front-door/python/README.md | 2 +- samples/function-app-managed-identity/python/README.md | 6 +++--- .../function-app-managed-identity/python/bicep/README.md | 4 ++-- .../python/scripts/README.md | 2 +- .../python/terraform/README.md | 2 +- samples/function-app-service-bus/dotnet/README.md | 4 ++-- samples/function-app-storage-http/dotnet/METHODS.md | 3 ++- samples/function-app-storage-http/dotnet/README.md | 8 ++++---- samples/servicebus/java/README.md | 4 ++-- samples/url-shortener/python/README.md | 2 +- samples/web-app-app-configuration/dotnet/README.md | 4 ++-- samples/web-app-app-configuration/python/README.md | 4 ++-- samples/web-app-cosmosdb-mongodb-api/dotnet/README.md | 4 ++-- samples/web-app-cosmosdb-mongodb-api/python/README.md | 4 ++-- samples/web-app-cosmosdb-nosql-api/dotnet/README.md | 4 ++-- samples/web-app-cosmosdb-nosql-api/python/README.md | 4 ++-- samples/web-app-custom-image/dotnet/README.md | 2 +- samples/web-app-custom-image/dotnet/terraform/README.md | 2 +- samples/web-app-custom-image/python/README.md | 2 +- samples/web-app-custom-image/python/terraform/README.md | 2 +- samples/web-app-managed-identity/dotnet/README.md | 6 +++--- samples/web-app-managed-identity/dotnet/scripts/README.md | 2 +- samples/web-app-managed-identity/python/README.md | 6 +++--- samples/web-app-managed-identity/python/scripts/README.md | 2 +- samples/web-app-mysql-flexible-server/dotnet/README.md | 4 ++-- samples/web-app-mysql-flexible-server/python/README.md | 4 ++-- .../web-app-postgresql-flexible-server/dotnet/README.md | 4 ++-- .../web-app-postgresql-flexible-server/python/README.md | 4 ++-- samples/web-app-sql-database/dotnet/README.md | 6 +++--- samples/web-app-sql-database/dotnet/bicep/README.md | 2 +- samples/web-app-sql-database/dotnet/scripts/README.md | 2 +- samples/web-app-sql-database/dotnet/terraform/README.md | 2 +- samples/web-app-sql-database/python/README.md | 6 +++--- samples/web-app-sql-database/python/bicep/README.md | 2 +- samples/web-app-sql-database/python/scripts/README.md | 2 +- samples/web-app-sql-database/python/terraform/README.md | 2 +- 41 files changed, 73 insertions(+), 69 deletions(-) diff --git a/README.md b/README.md index d5ecdb65..72e7ce9d 100644 --- a/README.md +++ b/README.md @@ -97,7 +97,7 @@ container images Microsoft publishes for `amd64` alone, so there is no `arm64` i **"emulated" means `amd64` emulation, and how well the samples run depends on the emulator.** The emulator never pins `--platform`, so on an `arm64` host Docker pulls the `amd64` image and runs it under whatever emulation the runtime provides. Where none is registered, such as GitHub's `ubuntu-*-arm` runners, the image cannot start at all, which is why CI schedules only the natively-supported samples on `arm64`. -> [!NOTE] +> [!IMPORTANT] > **Macs with Apple silicon: turn on Rosetta.** Docker Desktop emulates `amd64` with Rosetta only when **Use Rosetta for x86_64/amd64 emulation on Apple Silicon** is on (Settings, **General**, with the **Apple Virtualization framework** as the Virtual Machine Manager; Docker VMM has no Rosetta), and with QEMU otherwise. > Every code deployment, Function Apps included, is built with Microsoft's Oryx build image, which is `amd64`-only ([microsoft/Oryx#2133](https://github.com/microsoft/Oryx/issues/2133) asks for `arm64`) and is a .NET app, and [.NET does not support QEMU](https://github.com/dotnet/core/blob/main/release-notes/8.0/supported-os.md): under QEMU that build can crash ([#143](https://github.com/localstack/localstack-azure-samples/issues/143)). > Microsoft [does not test or support SQL Server under emulation](https://learn.microsoft.com/azure/azure-sql/database/local-dev-experience-dev-containers) either. @@ -108,7 +108,8 @@ them instead. The authoritative list lives in `ARM64_SAMPLE_DIRS` in [run-sample the CI matrix is generated from it, so adding a sample there is all that is needed to have it covered natively on both architectures. -> **Note:** Function Apps on `arm64` were fixed by +> [!CAUTION] +> Function Apps on `arm64` were fixed by > [localstack-pro#8102](https://github.com/localstack/localstack-pro/pull/8102) and work on the > current `localstack/localstack-azure:latest`. If you pin an older emulator image, expect every > Function App deployment to fail with a misleading `500 ... No route to host`: those images diff --git a/samples/aci-blob-storage/python/terraform/README.md b/samples/aci-blob-storage/python/terraform/README.md index 94facade..ca16a9fd 100644 --- a/samples/aci-blob-storage/python/terraform/README.md +++ b/samples/aci-blob-storage/python/terraform/README.md @@ -23,7 +23,8 @@ The [deploy.sh](deploy.sh) script first builds and pushes the Docker image to a 1. [Azure Storage Account](https://learn.microsoft.com/en-us/azure/storage/common/storage-account-overview): Provides blob storage for vacation activity data. 2. [Azure Container Instances](https://learn.microsoft.com/en-us/azure/container-instances/container-instances-overview): Runs the containerized Flask application with public IP and DNS label. -> **Note:** Key Vault is not included in the Terraform deployment as the Azure Terraform provider does not yet support LocalStack's Key Vault URI format. The storage connection string is passed directly to ACI as a secure environment variable. +> [!NOTE] +> Key Vault is not included in the Terraform deployment as the Azure Terraform provider does not yet support LocalStack's Key Vault URI format. The storage connection string is passed directly to ACI as a secure environment variable. For more information on the sample application, see [ACI Blob Storage](../README.md). diff --git a/samples/api-management-function-app/python/README.md b/samples/api-management-function-app/python/README.md index 9552f9a2..f6fa92e9 100644 --- a/samples/api-management-function-app/python/README.md +++ b/samples/api-management-function-app/python/README.md @@ -58,7 +58,7 @@ The life of a request: the client calls `GET /inventory/items` on the gateway wi - [Bicep](https://learn.microsoft.com/en-us/azure/azure-resource-manager/bicep/install) (for the Bicep deployment) - A LocalStack account with a valid `LOCALSTACK_AUTH_TOKEN` (see the [Auth Token guide](https://docs.localstack.cloud/getting-started/auth-token/)) -> [!NOTE] +> [!IMPORTANT] > **Macs with Apple silicon**: the function app runs natively on arm64, but the emulator builds each deployment with Microsoft's Oryx build image, which Microsoft publishes for amd64 only ([microsoft/Oryx#2133](https://github.com/microsoft/Oryx/issues/2133) asks for arm64). > Docker Desktop runs that build under amd64 emulation: in Docker Desktop's settings, under **General**, select the **Apple Virtualization framework** as the Virtual Machine Manager and turn on **Use Rosetta for x86_64/amd64 emulation on Apple Silicon**. > Under QEMU, which Docker Desktop uses otherwise (Rosetta off, or Docker VMM, which has no Rosetta), the build can crash, because Oryx is a .NET app and [.NET does not support QEMU](https://github.com/dotnet/core/blob/main/release-notes/8.0/supported-os.md). diff --git a/samples/eventhubs-eventgrid/python/README.md b/samples/eventhubs-eventgrid/python/README.md index f1d17b7d..ced0c6b7 100644 --- a/samples/eventhubs-eventgrid/python/README.md +++ b/samples/eventhubs-eventgrid/python/README.md @@ -93,13 +93,14 @@ whatever happened to be in the last batch. - Python 3.12+ with `src/producers/requirements.txt` installed. - `jq` and `zip`. +> [!IMPORTANT] > **The emulator must be able to resolve `cdn.functions.azure.com` from the function container.** > The Event Hubs trigger lives in the Functions extension bundle, which the host downloads on > every cold container. If the emulator's DNS server cannot forward external queries, the host > aborts and the trigger silently never fires. Starting the emulator with `DNS_ADDRESS=0` > sidesteps it. -> [!NOTE] +> [!IMPORTANT] > **Macs with Apple silicon**: the function app runs natively on arm64, but the emulator builds each deployment with Microsoft's Oryx build image, which Microsoft publishes for amd64 only ([microsoft/Oryx#2133](https://github.com/microsoft/Oryx/issues/2133) asks for arm64). > Docker Desktop runs that build under amd64 emulation: in Docker Desktop's settings, under **General**, select the **Apple Virtualization framework** as the Virtual Machine Manager and turn on **Use Rosetta for x86_64/amd64 emulation on Apple Silicon**. > Under QEMU, which Docker Desktop uses otherwise (Rosetta off, or Docker VMM, which has no Rosetta), the build can crash, because Oryx is a .NET app and [.NET does not support QEMU](https://github.com/dotnet/core/blob/main/release-notes/8.0/supported-os.md). diff --git a/samples/eventhubs/python/README.md b/samples/eventhubs/python/README.md index daac87ab..1e0db3c6 100644 --- a/samples/eventhubs/python/README.md +++ b/samples/eventhubs/python/README.md @@ -104,7 +104,7 @@ schema registry. - [Terraform](https://developer.hashicorp.com/terraform/downloads) or the Bicep CLI, for the alternative deployments -> [!NOTE] +> [!IMPORTANT] > **Macs with Apple silicon**: this sample's dashboard is a web app deployed from code. The emulator builds it with Microsoft's Oryx build image and runs it on an Oryx runtime image, and Microsoft publishes both for amd64 only ([microsoft/Oryx#2133](https://github.com/microsoft/Oryx/issues/2133) asks for arm64). > On a Mac with Apple silicon they run only under Docker Desktop's amd64 emulation: in Docker Desktop's settings, under **General**, select the **Apple Virtualization framework** as the Virtual Machine Manager and turn on **Use Rosetta for x86_64/amd64 emulation on Apple Silicon**. > Under QEMU, which Docker Desktop uses otherwise (Rosetta off, or Docker VMM, which has no Rosetta), the sample is not expected to work: Oryx is a .NET app, and [.NET does not support QEMU](https://github.com/dotnet/core/blob/main/release-notes/8.0/supported-os.md). @@ -130,7 +130,7 @@ bash scripts/run-pipeline.sh # run the end-to-end demo Then open the dashboard URL printed at the end of the deployment. -> **Note** +> [!NOTE] > The first deployment downloads the Azure Functions build image and core tools inside the > emulator, which can take several minutes. Later runs reuse them. diff --git a/samples/function-app-front-door/python/README.md b/samples/function-app-front-door/python/README.md index 93430f43..115ecfe8 100644 --- a/samples/function-app-front-door/python/README.md +++ b/samples/function-app-front-door/python/README.md @@ -69,7 +69,7 @@ The life of a request: the client calls `GET /catalog/1` on the endpoint → the - [jq](https://jqlang.org/) and `zip` - A LocalStack account with a valid `LOCALSTACK_AUTH_TOKEN` (see the [Auth Token guide](https://docs.localstack.cloud/getting-started/auth-token/)) -> [!NOTE] +> [!IMPORTANT] > **Macs with Apple silicon**: the function app runs natively on arm64, but the emulator builds each deployment with Microsoft's Oryx build image, which Microsoft publishes for amd64 only ([microsoft/Oryx#2133](https://github.com/microsoft/Oryx/issues/2133) asks for arm64). > Docker Desktop runs that build under amd64 emulation: in Docker Desktop's settings, under **General**, select the **Apple Virtualization framework** as the Virtual Machine Manager and turn on **Use Rosetta for x86_64/amd64 emulation on Apple Silicon**. > Under QEMU, which Docker Desktop uses otherwise (Rosetta off, or Docker VMM, which has no Rosetta), the build can crash, because Oryx is a .NET app and [.NET does not support QEMU](https://github.com/dotnet/core/blob/main/release-notes/8.0/supported-os.md). diff --git a/samples/function-app-managed-identity/python/README.md b/samples/function-app-managed-identity/python/README.md index e64a71df..51456c47 100644 --- a/samples/function-app-managed-identity/python/README.md +++ b/samples/function-app-managed-identity/python/README.md @@ -50,7 +50,7 @@ The LocalStack emulator emulates the following services, which are necessary at - [Bicep extension](https://marketplace.visualstudio.com/items?itemName=ms-azuretools.vscode-bicep), if you plan to install the sample via Bicep. - [Terraform](https://developer.hashicorp.com/terraform/downloads), if you plan to install the sample via Terraform. -> [!NOTE] +> [!IMPORTANT] > **Macs with Apple silicon**: the function app runs natively on arm64, but the emulator builds each deployment with Microsoft's Oryx build image, which Microsoft publishes for amd64 only ([microsoft/Oryx#2133](https://github.com/microsoft/Oryx/issues/2133) asks for arm64). > Docker Desktop runs that build under amd64 emulation: in Docker Desktop's settings, under **General**, select the **Apple Virtualization framework** as the Virtual Machine Manager and turn on **Use Rosetta for x86_64/amd64 emulation on Apple Silicon**. > Under QEMU, which Docker Desktop uses otherwise (Rosetta off, or Docker VMM, which has no Rosetta), the build can crash, because Oryx is a .NET app and [.NET does not support QEMU](https://github.com/dotnet/core/blob/main/release-notes/8.0/supported-os.md). @@ -84,7 +84,7 @@ Deploy the application to LocalStack for Azure using one of these methods: All deployment methods have been fully tested with both user-assigned and system-assigned managed identities against Azure and the LocalStack for Azure local emulator. -> **Note** +> [!NOTE] > When you deploy the application to LocalStack for Azure for the first time, the initialization process involves downloading and building Docker images. This is a one-time operation—subsequent deployments will be significantly faster. Depending on your internet connection and system resources, this initial setup may take several minutes. ## Test @@ -232,7 +232,7 @@ You can use [Azure Storage Explorer](https://learn.microsoft.com/en-us/azure/sto ![Azure Storage Explorer](./images/azure-storage-explorer.png) -> **Note** +> [!TIP] > When sending commands to an emulated storage account, make sure to use the primary key generated by the emulator itself. For convenience, if you're connecting to the storage account directly with Azure Storage Explorer, you can use the default Azurite password. For more details, see [Connect to Azurite with SDKs and tools](https://learn.microsoft.com/en-us/azure/storage/common/storage-connect-azurite). ## References diff --git a/samples/function-app-managed-identity/python/bicep/README.md b/samples/function-app-managed-identity/python/bicep/README.md index 7087aa92..944a8466 100644 --- a/samples/function-app-managed-identity/python/bicep/README.md +++ b/samples/function-app-managed-identity/python/bicep/README.md @@ -60,7 +60,7 @@ param runtimeVersion = '3.13' The [deploy.sh](deploy.sh) script automates the deployment of all Azure resources and the sample application in a single step. Before running the script, customize the variable values based on your needs. In particular, use the `MANAGED_IDENTITY_TYPE` variable to specify the type of managed identity to provision: `SystemAssigned` or `UserAssigned`. -> **Note** +> [!TIP] > You can use `lstk az` to proxy Azure CLI commands to the LocalStack for Azure emulator. Alternatively, run `lstk az start-interception` to automatically intercept and redirect all `az` commands to LocalStack. For more information, see the [lstk CLI documentation](https://docs.localstack.cloud/aws/developer-tools/running-localstack/lstk/). The [deploy.sh](deploy.sh) script executes the following steps: @@ -75,7 +75,7 @@ The [deploy.sh](deploy.sh) script executes the following steps: - Creates zip archive in format expected by Function App - Uploads pre-built application package to the newly created Function App -> **Note** +> [!TIP] > Azure CLI commands use `--verbose` argument to print execution details and the `--debug` flag to show low-level REST calls for debugging. For more information, see [Get started with Azure CLI](https://learn.microsoft.com/en-us/cli/azure/get-started-with-azure-cli) ## Deployment diff --git a/samples/function-app-managed-identity/python/scripts/README.md b/samples/function-app-managed-identity/python/scripts/README.md index 1e3aaed8..da3e214d 100644 --- a/samples/function-app-managed-identity/python/scripts/README.md +++ b/samples/function-app-managed-identity/python/scripts/README.md @@ -51,7 +51,7 @@ This sample provides two Bash scripts to streamline the deployment process by au These scripts eliminate manual configuration steps and enable one-command deployment of the entire infrastructure. -> [!NOTE] +> [!TIP] > You can use `lstk az` to proxy Azure CLI commands to the LocalStack for Azure emulator. Alternatively, run `lstk az start-interception` to automatically intercept and redirect all `az` commands to LocalStack. To revert back to the default behavior and send commands to the Azure cloud, run `lstk az stop-interception`. diff --git a/samples/function-app-managed-identity/python/terraform/README.md b/samples/function-app-managed-identity/python/terraform/README.md index b2e84dd1..0f7c29b1 100644 --- a/samples/function-app-managed-identity/python/terraform/README.md +++ b/samples/function-app-managed-identity/python/terraform/README.md @@ -47,7 +47,7 @@ For more information on the sample application, see [Azure Functions App with Ma The [deploy.sh](deploy.sh) script automates the deployment of all Azure resources and the sample application in a single step. Before running the script, customize the variable values based on your needs. In particular, use the `MANAGED_IDENTITY_TYPE` variable to specify the type of managed identity to provision: `SystemAssigned` or `UserAssigned`. -> **Note** +> [!TIP] > You can use `lstk az` to proxy Azure CLI commands to the LocalStack for Azure emulator. Alternatively, run `lstk az start-interception` to automatically intercept and redirect all `az` commands to LocalStack. With interception active, the standard `terraform` CLI also runs against LocalStack's Azure emulation environment, so no separate Terraform wrapper is needed. For more information, see the [lstk CLI documentation](https://docs.localstack.cloud/aws/developer-tools/running-localstack/lstk/). The [deploy.sh](deploy.sh) script executes the following steps: diff --git a/samples/function-app-service-bus/dotnet/README.md b/samples/function-app-service-bus/dotnet/README.md index a04f219d..9dd3d5cb 100644 --- a/samples/function-app-service-bus/dotnet/README.md +++ b/samples/function-app-service-bus/dotnet/README.md @@ -54,7 +54,7 @@ The solution is composed of the following Azure resources: - [Bicep extension](https://marketplace.visualstudio.com/items?itemName=ms-azuretools.vscode-bicep), if you plan to install the sample via Bicep. - [Terraform](https://developer.hashicorp.com/terraform/downloads), if you plan to install the sample via Terraform. -> [!NOTE] +> [!IMPORTANT] > **Macs with Apple silicon**: the function app runs natively on arm64, but the emulator builds each deployment with Microsoft's Oryx build image, which Microsoft publishes for amd64 only ([microsoft/Oryx#2133](https://github.com/microsoft/Oryx/issues/2133) asks for arm64). > Docker Desktop runs that build under amd64 emulation: in Docker Desktop's settings, under **General**, select the **Apple Virtualization framework** as the Virtual Machine Manager and turn on **Use Rosetta for x86_64/amd64 emulation on Apple Silicon**. > Under QEMU, which Docker Desktop uses otherwise (Rosetta off, or Docker VMM, which has no Rosetta), the build can crash, because Oryx is a .NET app and [.NET does not support QEMU](https://github.com/dotnet/core/blob/main/release-notes/8.0/supported-os.md). @@ -88,7 +88,7 @@ Deploy the application to LocalStack for Azure using one of these methods: All deployment methods have been fully tested against Azure and the LocalStack for Azure local emulator. -> **Note** +> [!NOTE] > When you deploy the application to LocalStack for Azure for the first time, the initialization process involves downloading and building Docker images. This is a one-time operation—subsequent deployments will be significantly faster. Depending on your internet connection and system resources, this initial setup may take several minutes. ## Test diff --git a/samples/function-app-storage-http/dotnet/METHODS.md b/samples/function-app-storage-http/dotnet/METHODS.md index ca243260..3faeeff9 100644 --- a/samples/function-app-storage-http/dotnet/METHODS.md +++ b/samples/function-app-storage-http/dotnet/METHODS.md @@ -199,7 +199,8 @@ Automated function that generates new game rounds with random player data and in **Description:** Template function for processing Service Bus messages. When enabled, it would process messages from a Service Bus queue and send responses to an output queue. -**Note:** This function is commented out in the current implementation but serves as a reference for Service Bus integration. +> [!NOTE] +> This function is commented out in the current implementation but serves as a reference for Service Bus integration. --- diff --git a/samples/function-app-storage-http/dotnet/README.md b/samples/function-app-storage-http/dotnet/README.md index 5711cc3b..d1158142 100644 --- a/samples/function-app-storage-http/dotnet/README.md +++ b/samples/function-app-storage-http/dotnet/README.md @@ -134,7 +134,7 @@ The sample uses the following configurable settings in `local.settings.json`: - [jq](https://jqlang.org/) is a JSON processor for scripting. - [Azure Storage Explorer](https://learn.microsoft.com/en-us/azure/storage/storage-explorer/vs-azure-tools-storage-manage-with-storage-explorer) for viewing storage contents. -> [!NOTE] +> [!IMPORTANT] > **Macs with Apple silicon**: the function app runs natively on arm64, but the emulator builds each deployment with Microsoft's Oryx build image, which Microsoft publishes for amd64 only ([microsoft/Oryx#2133](https://github.com/microsoft/Oryx/issues/2133) asks for arm64). > Docker Desktop runs that build under amd64 emulation: in Docker Desktop's settings, under **General**, select the **Apple Virtualization framework** as the Virtual Machine Manager and turn on **Use Rosetta for x86_64/amd64 emulation on Apple Silicon**. > Under QEMU, which Docker Desktop uses otherwise (Rosetta off, or Docker VMM, which has no Rosetta), the build can crash, because Oryx is a .NET app and [.NET does not support QEMU](https://github.com/dotnet/core/blob/main/release-notes/8.0/supported-os.md). @@ -162,8 +162,8 @@ The sample uses the following configurable settings in `local.settings.json`: All deployment methods have been fully tested against Azure and the LocalStack for Azure local emulator. -> **Note** -> The first time you run Azure Functions on LocalStack for Azure, the emulator downloads a ZIP archive of the selected version of the [Azure Functions Core Tools](https://github.com/Azure/azure-functions-core-tools/tags) to build the container image that hosts your functions. By default, version 4.2.2 is used. You can override this by setting the AZURE_FUNCTIONS_CORE_TOOLS_VERSION environment variable. The archive is large (over 500 MB), so the initial download may take several minutes. Subsequent runs will use the cached copy. +> [!NOTE] +> The first time you run Azure Functions on LocalStack for Azure, the emulator downloads a ZIP archive of the selected version of the [Azure Functions Core Tools](https://github.com/Azure/azure-functions-core-tools/tags) to build the container image that hosts your functions. By default, version 4.15.1 is used (4.13.0 on an arm64 host). You can override this by setting the `LS_AZURE_FUNCTIONS_CORE_TOOLS_VERSION` environment variable on the emulator. The archive is large (over 500 MB), so the initial download may take several minutes. Subsequent runs will use the cached copy. ## Test @@ -184,7 +184,7 @@ You can use [Azure Storage Explorer](https://learn.microsoft.com/en-us/azure/sto ![Azure Storage Explorer](./images/azure-storage-explorer.png) -> **Note** +> [!TIP] > When sending commands to an emulated storage account, make sure to use the primary key generated by the emulator itself. For convenience, if you're connecting to the storage account directly with Azure Storage Explorer, you can use the default Azurite password. For more details, see [Connect to Azurite with SDKs and tools](https://learn.microsoft.com/en-us/azure/storage/common/storage-connect-azurite). You can expand the storage account to view the **Blob Containers**, **Queues**, and **Tables** created and used by this sample, as illustrated below: diff --git a/samples/servicebus/java/README.md b/samples/servicebus/java/README.md index 6bb9195c..16ebd94b 100644 --- a/samples/servicebus/java/README.md +++ b/samples/servicebus/java/README.md @@ -33,7 +33,7 @@ The solution is composed of the following Azure resources: 2. [Azure Service Bus Namespace](https://learn.microsoft.com/en-us/azure/service-bus-messaging/service-bus-messaging-overview): The messaging namespace that hosts the queue used by the application. 3. [Azure Service Bus Queue](https://learn.microsoft.com/en-us/azure/service-bus-messaging/service-bus-queues-topics-subscriptions#queues): The `myqueue` queue used to send and receive messages. -> **Note** +> [!NOTE] > The Java application currently runs on the host machine. In a future iteration, it will be deployed to an emulator-hosted web app. ## Prerequisites @@ -75,7 +75,7 @@ Deploy the application to LocalStack for Azure using one of these methods: All deployment methods have been fully tested against Azure and the LocalStack for Azure local emulator. -> **Note** +> [!NOTE] > When you deploy the application to LocalStack for Azure for the first time, the initialization process involves downloading and building Docker images. This is a one-time operation—subsequent deployments will be significantly faster. Depending on your internet connection and system resources, this initial setup may take several minutes. ## How It Works diff --git a/samples/url-shortener/python/README.md b/samples/url-shortener/python/README.md index 5bdbf996..0d3f9156 100644 --- a/samples/url-shortener/python/README.md +++ b/samples/url-shortener/python/README.md @@ -85,7 +85,7 @@ The flow of a single link: `POST /shorten` → Table Storage + Key Vault + Servi - [Bicep](https://learn.microsoft.com/en-us/azure/azure-resource-manager/bicep/install) (for the Bicep deployment) - A LocalStack account with a valid `LOCALSTACK_AUTH_TOKEN` (see the [Auth Token guide](https://docs.localstack.cloud/getting-started/auth-token/)) -> [!NOTE] +> [!IMPORTANT] > **Macs with Apple silicon**: this sample's web app is deployed from code. The emulator builds it with Microsoft's Oryx build image and runs it on an Oryx runtime image, and Microsoft publishes both for amd64 only ([microsoft/Oryx#2133](https://github.com/microsoft/Oryx/issues/2133) asks for arm64). > On a Mac with Apple silicon they run only under Docker Desktop's amd64 emulation: in Docker Desktop's settings, under **General**, select the **Apple Virtualization framework** as the Virtual Machine Manager and turn on **Use Rosetta for x86_64/amd64 emulation on Apple Silicon**. > Under QEMU, which Docker Desktop uses otherwise (Rosetta off, or Docker VMM, which has no Rosetta), the sample is not expected to work: Oryx is a .NET app, and [.NET does not support QEMU](https://github.com/dotnet/core/blob/main/release-notes/8.0/supported-os.md). diff --git a/samples/web-app-app-configuration/dotnet/README.md b/samples/web-app-app-configuration/dotnet/README.md index f5805b82..efc9bec2 100644 --- a/samples/web-app-app-configuration/dotnet/README.md +++ b/samples/web-app-app-configuration/dotnet/README.md @@ -75,7 +75,7 @@ On Azure the store endpoint is `https://.azconfig.io` and the vault URI i - [Bicep extension](https://marketplace.visualstudio.com/items?itemName=ms-azuretools.vscode-bicep), if you plan to install the sample via Bicep - [Terraform](https://developer.hashicorp.com/terraform/downloads), if you plan to install the sample via Terraform -> [!NOTE] +> [!IMPORTANT] > **Macs with Apple silicon**: this sample deploys a web app from code. The emulator builds it with Microsoft's Oryx build image and runs it on an Oryx runtime image, and Microsoft publishes both for amd64 only ([microsoft/Oryx#2133](https://github.com/microsoft/Oryx/issues/2133) asks for arm64). > On a Mac with Apple silicon they run only under Docker Desktop's amd64 emulation: in Docker Desktop's settings, under **General**, select the **Apple Virtualization framework** as the Virtual Machine Manager and turn on **Use Rosetta for x86_64/amd64 emulation on Apple Silicon**. > Under QEMU, which Docker Desktop uses otherwise (Rosetta off, or Docker VMM, which has no Rosetta), the sample is not expected to work: Oryx is a .NET app, and [.NET does not support QEMU](https://github.com/dotnet/core/blob/main/release-notes/8.0/supported-os.md). @@ -105,7 +105,7 @@ All three variants provision the same topology: a VNet whose *pe-subnet* hosts t The store and the vault have globally unique names: on Azure, export your own `SUFFIX` (or `PREFIX`) before running a variant. When you are done, delete the resource group and purge the soft-deleted store and vault (`az appconfig purge`, `az keyvault purge`) so that their names are released. -> **Note** +> [!NOTE] > When you deploy the application to LocalStack for Azure for the first time, the initialization process pulls and builds Docker images (LocalStack itself plus the `postgres:18` backing container for the flexible-server emulator). This is a one-time operation; subsequent deployments are much faster. ## Test diff --git a/samples/web-app-app-configuration/python/README.md b/samples/web-app-app-configuration/python/README.md index ad282487..26ec454e 100644 --- a/samples/web-app-app-configuration/python/README.md +++ b/samples/web-app-app-configuration/python/README.md @@ -72,7 +72,7 @@ On Azure the store endpoint is `https://.azconfig.io` and the vault URI i - [Bicep extension](https://marketplace.visualstudio.com/items?itemName=ms-azuretools.vscode-bicep), if you plan to install the sample via Bicep - [Terraform](https://developer.hashicorp.com/terraform/downloads), if you plan to install the sample via Terraform -> [!NOTE] +> [!IMPORTANT] > **Macs with Apple silicon**: this sample deploys a web app from code. The emulator builds it with Microsoft's Oryx build image and runs it on an Oryx runtime image, and Microsoft publishes both for amd64 only ([microsoft/Oryx#2133](https://github.com/microsoft/Oryx/issues/2133) asks for arm64). > On a Mac with Apple silicon they run only under Docker Desktop's amd64 emulation: in Docker Desktop's settings, under **General**, select the **Apple Virtualization framework** as the Virtual Machine Manager and turn on **Use Rosetta for x86_64/amd64 emulation on Apple Silicon**. > Under QEMU, which Docker Desktop uses otherwise (Rosetta off, or Docker VMM, which has no Rosetta), the sample is not expected to work: Oryx is a .NET app, and [.NET does not support QEMU](https://github.com/dotnet/core/blob/main/release-notes/8.0/supported-os.md). @@ -102,7 +102,7 @@ All three variants provision the same topology: a VNet whose *pe-subnet* hosts t The store and the vault have globally unique names: on Azure, export your own `SUFFIX` (or `PREFIX`) before running a variant. When you are done, delete the resource group and purge the soft-deleted store and vault (`az appconfig purge`, `az keyvault purge`) so that their names are released. -> **Note** +> [!NOTE] > When you deploy the application to LocalStack for Azure for the first time, the initialization process pulls and builds Docker images (LocalStack itself plus the `postgres:18` backing container for the flexible-server emulator). This is a one-time operation; subsequent deployments are much faster. ## Test diff --git a/samples/web-app-cosmosdb-mongodb-api/dotnet/README.md b/samples/web-app-cosmosdb-mongodb-api/dotnet/README.md index 3f11b523..98597c4d 100644 --- a/samples/web-app-cosmosdb-mongodb-api/dotnet/README.md +++ b/samples/web-app-cosmosdb-mongodb-api/dotnet/README.md @@ -37,7 +37,7 @@ The web app enables users to plan and manage vacation activities, with all data - [Bicep extension](https://marketplace.visualstudio.com/items?itemName=ms-azuretools.vscode-bicep), if you plan to install the sample via Bicep. - [Terraform](https://developer.hashicorp.com/terraform/downloads), if you plan to install the sample via Terraform. -> [!NOTE] +> [!IMPORTANT] > **Macs with Apple silicon**: this sample deploys a web app from code. The emulator builds it with Microsoft's Oryx build image and runs it on an Oryx runtime image, and Microsoft publishes both for amd64 only ([microsoft/Oryx#2133](https://github.com/microsoft/Oryx/issues/2133) asks for arm64). > On a Mac with Apple silicon they run only under Docker Desktop's amd64 emulation: in Docker Desktop's settings, under **General**, select the **Apple Virtualization framework** as the Virtual Machine Manager and turn on **Use Rosetta for x86_64/amd64 emulation on Apple Silicon**. > Under QEMU, which Docker Desktop uses otherwise (Rosetta off, or Docker VMM, which has no Rosetta), the sample is not expected to work: Oryx is a .NET app, and [.NET does not support QEMU](https://github.com/dotnet/core/blob/main/release-notes/8.0/supported-os.md). @@ -72,7 +72,7 @@ Deploy the application to LocalStack for Azure using one of these methods: All deployment methods have been fully tested against Azure and the LocalStack for Azure local emulator. -> **Note** +> [!NOTE] > When you deploy the application to LocalStack for Azure for the first time, the initialization process involves downloading and building Docker images. This is a one-time operation—subsequent deployments will be significantly faster. Depending on your internet connection and system resources, this initial setup may take several minutes. ## Test diff --git a/samples/web-app-cosmosdb-mongodb-api/python/README.md b/samples/web-app-cosmosdb-mongodb-api/python/README.md index 219f9275..38e84984 100644 --- a/samples/web-app-cosmosdb-mongodb-api/python/README.md +++ b/samples/web-app-cosmosdb-mongodb-api/python/README.md @@ -37,7 +37,7 @@ The web app enables users to plan and manage vacation activities, with all data - [Bicep extension](https://marketplace.visualstudio.com/items?itemName=ms-azuretools.vscode-bicep), if you plan to install the sample via Bicep. - [Terraform](https://developer.hashicorp.com/terraform/downloads), if you plan to install the sample via Terraform. -> [!NOTE] +> [!IMPORTANT] > **Macs with Apple silicon**: this sample deploys a web app from code. The emulator builds it with Microsoft's Oryx build image and runs it on an Oryx runtime image, and Microsoft publishes both for amd64 only ([microsoft/Oryx#2133](https://github.com/microsoft/Oryx/issues/2133) asks for arm64). > On a Mac with Apple silicon they run only under Docker Desktop's amd64 emulation: in Docker Desktop's settings, under **General**, select the **Apple Virtualization framework** as the Virtual Machine Manager and turn on **Use Rosetta for x86_64/amd64 emulation on Apple Silicon**. > Under QEMU, which Docker Desktop uses otherwise (Rosetta off, or Docker VMM, which has no Rosetta), the sample is not expected to work: Oryx is a .NET app, and [.NET does not support QEMU](https://github.com/dotnet/core/blob/main/release-notes/8.0/supported-os.md). @@ -72,7 +72,7 @@ Deploy the application to LocalStack for Azure using one of these methods: All deployment methods have been fully tested against Azure and the LocalStack for Azure local emulator. -> **Note** +> [!NOTE] > When you deploy the application to LocalStack for Azure for the first time, the initialization process involves downloading and building Docker images. This is a one-time operation—subsequent deployments will be significantly faster. Depending on your internet connection and system resources, this initial setup may take several minutes. ## Test diff --git a/samples/web-app-cosmosdb-nosql-api/dotnet/README.md b/samples/web-app-cosmosdb-nosql-api/dotnet/README.md index f9c70daf..d3e2c127 100644 --- a/samples/web-app-cosmosdb-nosql-api/dotnet/README.md +++ b/samples/web-app-cosmosdb-nosql-api/dotnet/README.md @@ -20,7 +20,7 @@ The following diagram illustrates the architecture of the solution: - [.NET SDK 10.0](https://dotnet.microsoft.com/en-us/download/dotnet/10.0) - [ASP.NET Core](https://learn.microsoft.com/en-us/aspnet/core/) -> [!NOTE] +> [!IMPORTANT] > **Macs with Apple silicon**: this sample deploys a web app from code. The emulator builds it with Microsoft's Oryx build image and runs it on an Oryx runtime image, and Microsoft publishes both for amd64 only ([microsoft/Oryx#2133](https://github.com/microsoft/Oryx/issues/2133) asks for arm64). > On a Mac with Apple silicon they run only under Docker Desktop's amd64 emulation: in Docker Desktop's settings, under **General**, select the **Apple Virtualization framework** as the Virtual Machine Manager and turn on **Use Rosetta for x86_64/amd64 emulation on Apple Silicon**. > Under QEMU, which Docker Desktop uses otherwise (Rosetta off, or Docker VMM, which has no Rosetta), the sample is not expected to work: Oryx is a .NET app, and [.NET does not support QEMU](https://github.com/dotnet/core/blob/main/release-notes/8.0/supported-os.md). @@ -51,7 +51,7 @@ Deploy the application to LocalStack for Azure using: - [Azure CLI Deployment](./scripts/README.md) -> **Note** +> [!NOTE] > When you deploy the application to LocalStack for Azure for the first time, the initialization process involves downloading and building Docker images. This is a one-time operation—subsequent deployments will be significantly faster. Depending on your internet connection and system resources, this initial setup may take several minutes. ## Test diff --git a/samples/web-app-cosmosdb-nosql-api/python/README.md b/samples/web-app-cosmosdb-nosql-api/python/README.md index 39f6d994..a7ae5fd7 100644 --- a/samples/web-app-cosmosdb-nosql-api/python/README.md +++ b/samples/web-app-cosmosdb-nosql-api/python/README.md @@ -20,7 +20,7 @@ The following diagram illustrates the architecture of the solution: - [Python 3.11+](https://www.python.org/downloads/) - [Flask](https://flask.palletsprojects.com/) -> [!NOTE] +> [!IMPORTANT] > **Macs with Apple silicon**: this sample deploys a web app from code. The emulator builds it with Microsoft's Oryx build image and runs it on an Oryx runtime image, and Microsoft publishes both for amd64 only ([microsoft/Oryx#2133](https://github.com/microsoft/Oryx/issues/2133) asks for arm64). > On a Mac with Apple silicon they run only under Docker Desktop's amd64 emulation: in Docker Desktop's settings, under **General**, select the **Apple Virtualization framework** as the Virtual Machine Manager and turn on **Use Rosetta for x86_64/amd64 emulation on Apple Silicon**. > Under QEMU, which Docker Desktop uses otherwise (Rosetta off, or Docker VMM, which has no Rosetta), the sample is not expected to work: Oryx is a .NET app, and [.NET does not support QEMU](https://github.com/dotnet/core/blob/main/release-notes/8.0/supported-os.md). @@ -51,7 +51,7 @@ Deploy the application to LocalStack for Azure using: - [Azure CLI Deployment](./scripts/README.md) -> **Note** +> [!NOTE] > When you deploy the application to LocalStack for Azure for the first time, the initialization process involves downloading and building Docker images. This is a one-time operation—subsequent deployments will be significantly faster. Depending on your internet connection and system resources, this initial setup may take several minutes. ## Test diff --git a/samples/web-app-custom-image/dotnet/README.md b/samples/web-app-custom-image/dotnet/README.md index a9906a8a..2114cd30 100644 --- a/samples/web-app-custom-image/dotnet/README.md +++ b/samples/web-app-custom-image/dotnet/README.md @@ -65,7 +65,7 @@ Deploy the application to LocalStack for Azure using one of these methods: All deployment methods have been fully tested against Azure and the LocalStack for Azure local emulator. -> **Note** +> [!NOTE] > When you deploy the application to LocalStack for Azure for the first time, the initialization process involves downloading and building Docker images. This is a one-time operation—subsequent deployments will be significantly faster. Depending on your internet connection and system resources, this initial setup may take several minutes. ## Test diff --git a/samples/web-app-custom-image/dotnet/terraform/README.md b/samples/web-app-custom-image/dotnet/terraform/README.md index 8ad93d62..b7aee8a4 100644 --- a/samples/web-app-custom-image/dotnet/terraform/README.md +++ b/samples/web-app-custom-image/dotnet/terraform/README.md @@ -49,7 +49,7 @@ The Terraform modules create the following Azure resources: 10. [Azure App Service Plan](https://learn.microsoft.com/en-us/azure/app-service/overview-hosting-plans): The underlying compute tier that hosts the web application. 11. [Azure Web App](https://learn.microsoft.com/en-us/azure/app-service/overview): Runs the ASP.NET Core application from the custom container image stored in the Azure Container Registry. -> **Note** +> [!NOTE] > The Terraform [azurerm_linux_web_app](https://registry.terraform.io/providers/hashicorp/azurerm/latest/docs/resources/linux_web_app) resource does not support using a managed identity for container image pull from Azure Container Registry. The Terraform deployment uses ACR admin username and password instead of a managed identity. ## Provisioning Scripts diff --git a/samples/web-app-custom-image/python/README.md b/samples/web-app-custom-image/python/README.md index 50886256..b76b540a 100644 --- a/samples/web-app-custom-image/python/README.md +++ b/samples/web-app-custom-image/python/README.md @@ -64,7 +64,7 @@ Deploy the application to LocalStack for Azure using one of these methods: All deployment methods have been fully tested against Azure and the LocalStack for Azure local emulator. -> **Note** +> [!NOTE] > When you deploy the application to LocalStack for Azure for the first time, the initialization process involves downloading and building Docker images. This is a one-time operation—subsequent deployments will be significantly faster. Depending on your internet connection and system resources, this initial setup may take several minutes. ## Test diff --git a/samples/web-app-custom-image/python/terraform/README.md b/samples/web-app-custom-image/python/terraform/README.md index 7d5fee66..3d84851d 100644 --- a/samples/web-app-custom-image/python/terraform/README.md +++ b/samples/web-app-custom-image/python/terraform/README.md @@ -49,7 +49,7 @@ The Terraform modules create the following Azure resources: 10. [Azure App Service Plan](https://learn.microsoft.com/en-us/azure/app-service/overview-hosting-plans): The underlying compute tier that hosts the web application. 11. [Azure Web App](https://learn.microsoft.com/en-us/azure/app-service/overview): Runs the Python Flask application from the custom container image stored in the Azure Container Registry. -> **Note** +> [!NOTE] > The Terraform [azurerm_linux_web_app](https://registry.terraform.io/providers/hashicorp/azurerm/latest/docs/resources/linux_web_app) resource does not support using a managed identity for container image pull from Azure Container Registry. The Terraform deployment uses ACR admin username and password instead of a managed identity. ## Provisioning Scripts diff --git a/samples/web-app-managed-identity/dotnet/README.md b/samples/web-app-managed-identity/dotnet/README.md index 16f03172..2d789395 100644 --- a/samples/web-app-managed-identity/dotnet/README.md +++ b/samples/web-app-managed-identity/dotnet/README.md @@ -48,7 +48,7 @@ The LocalStack emulator emulates the following services, which are necessary at - [Bicep extension](https://marketplace.visualstudio.com/items?itemName=ms-azuretools.vscode-bicep), if you plan to install the sample via Bicep. - [Terraform](https://developer.hashicorp.com/terraform/downloads), if you plan to install the sample via Terraform. -> [!NOTE] +> [!IMPORTANT] > **Macs with Apple silicon**: this sample deploys a web app from code. The emulator builds it with Microsoft's Oryx build image and runs it on an Oryx runtime image, and Microsoft publishes both for amd64 only ([microsoft/Oryx#2133](https://github.com/microsoft/Oryx/issues/2133) asks for arm64). > On a Mac with Apple silicon they run only under Docker Desktop's amd64 emulation: in Docker Desktop's settings, under **General**, select the **Apple Virtualization framework** as the Virtual Machine Manager and turn on **Use Rosetta for x86_64/amd64 emulation on Apple Silicon**. > Under QEMU, which Docker Desktop uses otherwise (Rosetta off, or Docker VMM, which has no Rosetta), the sample is not expected to work: Oryx is a .NET app, and [.NET does not support QEMU](https://github.com/dotnet/core/blob/main/release-notes/8.0/supported-os.md). @@ -83,7 +83,7 @@ Deploy the application to LocalStack for Azure using one of these methods: All deployment methods have been fully tested with both user-assigned and system-assigned managed identities against Azure and the LocalStack for Azure local emulator. -> **Note** +> [!NOTE] > When you deploy the application to LocalStack for Azure for the first time, the initialization process involves downloading and building Docker images. This is a one-time operation—subsequent deployments will be significantly faster. Depending on your internet connection and system resources, this initial setup may take several minutes. ## Test @@ -112,7 +112,7 @@ You can use [Azure Storage Explorer](https://learn.microsoft.com/en-us/azure/sto ![Azure Storage Explorer](./images/azure-storage-explorer.png) -> **Note** +> [!TIP] > When sending commands to an emulated storage account, make sure to use the primary key generated by the emulator itself. For convenience, if you're connecting to the storage account directly with Azure Storage Explorer, you can use the default Azurite password. For more details, see [Connect to Azurite with SDKs and tools](https://learn.microsoft.com/en-us/azure/storage/common/storage-connect-azurite). ## References diff --git a/samples/web-app-managed-identity/dotnet/scripts/README.md b/samples/web-app-managed-identity/dotnet/scripts/README.md index e9c12ce8..7e02d938 100644 --- a/samples/web-app-managed-identity/dotnet/scripts/README.md +++ b/samples/web-app-managed-identity/dotnet/scripts/README.md @@ -71,7 +71,7 @@ See the script files for complete implementation. The scripts perform the follow These scripts eliminate manual configuration steps and enable one-command deployment of the entire infrastructure. -> [!NOTE] +> [!TIP] > You can use `lstk az` to proxy Azure CLI commands to the LocalStack for Azure emulator. Alternatively, run `lstk az start-interception` to automatically intercept and redirect all `az` commands to LocalStack. To revert back to the default behavior and send commands to the Azure cloud, run `lstk az stop-interception`. ## Deployment diff --git a/samples/web-app-managed-identity/python/README.md b/samples/web-app-managed-identity/python/README.md index f1d6524e..5e18dd5b 100644 --- a/samples/web-app-managed-identity/python/README.md +++ b/samples/web-app-managed-identity/python/README.md @@ -48,7 +48,7 @@ The LocalStack emulator emulates the following services, which are necessary at - [Bicep extension](https://marketplace.visualstudio.com/items?itemName=ms-azuretools.vscode-bicep), if you plan to install the sample via Bicep. - [Terraform](https://developer.hashicorp.com/terraform/downloads), if you plan to install the sample via Terraform. -> [!NOTE] +> [!IMPORTANT] > **Macs with Apple silicon**: this sample deploys a web app from code. The emulator builds it with Microsoft's Oryx build image and runs it on an Oryx runtime image, and Microsoft publishes both for amd64 only ([microsoft/Oryx#2133](https://github.com/microsoft/Oryx/issues/2133) asks for arm64). > On a Mac with Apple silicon they run only under Docker Desktop's amd64 emulation: in Docker Desktop's settings, under **General**, select the **Apple Virtualization framework** as the Virtual Machine Manager and turn on **Use Rosetta for x86_64/amd64 emulation on Apple Silicon**. > Under QEMU, which Docker Desktop uses otherwise (Rosetta off, or Docker VMM, which has no Rosetta), the sample is not expected to work: Oryx is a .NET app, and [.NET does not support QEMU](https://github.com/dotnet/core/blob/main/release-notes/8.0/supported-os.md). @@ -83,7 +83,7 @@ Deploy the application to LocalStack for Azure using one of these methods: All deployment methods have been fully tested with both user-assigned and system-assigned managed identities against Azure and the LocalStack for Azure local emulator. -> **Note** +> [!NOTE] > When you deploy the application to LocalStack for Azure for the first time, the initialization process involves downloading and building Docker images. This is a one-time operation—subsequent deployments will be significantly faster. Depending on your internet connection and system resources, this initial setup may take several minutes. ## Test @@ -112,7 +112,7 @@ You can use [Azure Storage Explorer](https://learn.microsoft.com/en-us/azure/sto ![Azure Storage Explorer](./images/azure-storage-explorer.png) -> **Note** +> [!TIP] > When sending commands to an emulated storage account, make sure to use the primary key generated by the emulator itself. For convenience, if you're connecting to the storage account directly with Azure Storage Explorer, you can use the default Azurite password. For more details, see [Connect to Azurite with SDKs and tools](https://learn.microsoft.com/en-us/azure/storage/common/storage-connect-azurite). ## References diff --git a/samples/web-app-managed-identity/python/scripts/README.md b/samples/web-app-managed-identity/python/scripts/README.md index e32c3eeb..05d34a4e 100644 --- a/samples/web-app-managed-identity/python/scripts/README.md +++ b/samples/web-app-managed-identity/python/scripts/README.md @@ -71,7 +71,7 @@ See the script files for complete implementation. The scripts perform the follow These scripts eliminate manual configuration steps and enable one-command deployment of the entire infrastructure. -> [!NOTE] +> [!TIP] > You can use `lstk az` to proxy Azure CLI commands to the LocalStack for Azure emulator. Alternatively, run `lstk az start-interception` to automatically intercept and redirect all `az` commands to LocalStack. To revert back to the default behavior and send commands to the Azure cloud, run `lstk az stop-interception`. ## Deployment diff --git a/samples/web-app-mysql-flexible-server/dotnet/README.md b/samples/web-app-mysql-flexible-server/dotnet/README.md index 9e61e46e..5708123e 100644 --- a/samples/web-app-mysql-flexible-server/dotnet/README.md +++ b/samples/web-app-mysql-flexible-server/dotnet/README.md @@ -37,7 +37,7 @@ The deploy scripts follow the same pattern as the sibling [`web-app-postgresql-f - [Bicep extension](https://marketplace.visualstudio.com/items?itemName=ms-azuretools.vscode-bicep), if you plan to install the sample via Bicep - [Terraform](https://developer.hashicorp.com/terraform/downloads), if you plan to install the sample via Terraform -> [!NOTE] +> [!IMPORTANT] > **Macs with Apple silicon**: this sample deploys a web app from code. The emulator builds it with Microsoft's Oryx build image and runs it on an Oryx runtime image, and Microsoft publishes both for amd64 only ([microsoft/Oryx#2133](https://github.com/microsoft/Oryx/issues/2133) asks for arm64). > On a Mac with Apple silicon they run only under Docker Desktop's amd64 emulation: in Docker Desktop's settings, under **General**, select the **Apple Virtualization framework** as the Virtual Machine Manager and turn on **Use Rosetta for x86_64/amd64 emulation on Apple Silicon**. > Under QEMU, which Docker Desktop uses otherwise (Rosetta off, or Docker VMM, which has no Rosetta), the sample is not expected to work: Oryx is a .NET app, and [.NET does not support QEMU](https://github.com/dotnet/core/blob/main/release-notes/8.0/supported-os.md). @@ -65,7 +65,7 @@ Deploy the application using one of these methods: All three variants provision the same topology: VNet + pe-subnet hosting a Private Endpoint targeting a public-access MySQL flexible server, with a Private DNS Zone linked to the VNet. -> **Note** +> [!NOTE] > When you deploy the application to LocalStack for Azure for the first time, the initialization process pulls and builds Docker images (LocalStack itself plus the `mysql:8` backing container for the flexible-server emulator). This is a one-time operation — subsequent deployments are much faster. ## Test diff --git a/samples/web-app-mysql-flexible-server/python/README.md b/samples/web-app-mysql-flexible-server/python/README.md index c33ab2aa..9b838cad 100644 --- a/samples/web-app-mysql-flexible-server/python/README.md +++ b/samples/web-app-mysql-flexible-server/python/README.md @@ -37,7 +37,7 @@ The deploy scripts follow the same pattern as the sibling [`web-app-postgresql-f - [Bicep extension](https://marketplace.visualstudio.com/items?itemName=ms-azuretools.vscode-bicep), if you plan to install the sample via Bicep - [Terraform](https://developer.hashicorp.com/terraform/downloads), if you plan to install the sample via Terraform -> [!NOTE] +> [!IMPORTANT] > **Macs with Apple silicon**: this sample deploys a web app from code. The emulator builds it with Microsoft's Oryx build image and runs it on an Oryx runtime image, and Microsoft publishes both for amd64 only ([microsoft/Oryx#2133](https://github.com/microsoft/Oryx/issues/2133) asks for arm64). > On a Mac with Apple silicon they run only under Docker Desktop's amd64 emulation: in Docker Desktop's settings, under **General**, select the **Apple Virtualization framework** as the Virtual Machine Manager and turn on **Use Rosetta for x86_64/amd64 emulation on Apple Silicon**. > Under QEMU, which Docker Desktop uses otherwise (Rosetta off, or Docker VMM, which has no Rosetta), the sample is not expected to work: Oryx is a .NET app, and [.NET does not support QEMU](https://github.com/dotnet/core/blob/main/release-notes/8.0/supported-os.md). @@ -65,7 +65,7 @@ Deploy the application using one of these methods: All three variants provision the same topology: VNet + pe-subnet hosting a Private Endpoint targeting a public-access MySQL flexible server, with a Private DNS Zone linked to the VNet. -> **Note** +> [!NOTE] > When you deploy the application to LocalStack for Azure for the first time, the initialization process pulls and builds Docker images (LocalStack itself plus the `mysql:8` backing container for the flexible-server emulator). This is a one-time operation — subsequent deployments are much faster. ## Test diff --git a/samples/web-app-postgresql-flexible-server/dotnet/README.md b/samples/web-app-postgresql-flexible-server/dotnet/README.md index ef0003b0..d7800e11 100644 --- a/samples/web-app-postgresql-flexible-server/dotnet/README.md +++ b/samples/web-app-postgresql-flexible-server/dotnet/README.md @@ -37,7 +37,7 @@ The deploy scripts follow the same pattern as the sibling [`web-app-sql-database - [Bicep extension](https://marketplace.visualstudio.com/items?itemName=ms-azuretools.vscode-bicep), if you plan to install the sample via Bicep - [Terraform](https://developer.hashicorp.com/terraform/downloads), if you plan to install the sample via Terraform -> [!NOTE] +> [!IMPORTANT] > **Macs with Apple silicon**: this sample deploys a web app from code. The emulator builds it with Microsoft's Oryx build image and runs it on an Oryx runtime image, and Microsoft publishes both for amd64 only ([microsoft/Oryx#2133](https://github.com/microsoft/Oryx/issues/2133) asks for arm64). > On a Mac with Apple silicon they run only under Docker Desktop's amd64 emulation: in Docker Desktop's settings, under **General**, select the **Apple Virtualization framework** as the Virtual Machine Manager and turn on **Use Rosetta for x86_64/amd64 emulation on Apple Silicon**. > Under QEMU, which Docker Desktop uses otherwise (Rosetta off, or Docker VMM, which has no Rosetta), the sample is not expected to work: Oryx is a .NET app, and [.NET does not support QEMU](https://github.com/dotnet/core/blob/main/release-notes/8.0/supported-os.md). @@ -65,7 +65,7 @@ Deploy the application using one of these methods: All three variants provision the same topology: VNet + pe-subnet hosting a Private Endpoint targeting a public-access PostgreSQL flexible server, with a Private DNS Zone linked to the VNet. -> **Note** +> [!NOTE] > When you deploy the application to LocalStack for Azure for the first time, the initialization process pulls and builds Docker images (LocalStack itself plus the `postgres:18` backing container for the flexible-server emulator). This is a one-time operation — subsequent deployments are much faster. ## Test diff --git a/samples/web-app-postgresql-flexible-server/python/README.md b/samples/web-app-postgresql-flexible-server/python/README.md index e1ad40a3..036754ba 100644 --- a/samples/web-app-postgresql-flexible-server/python/README.md +++ b/samples/web-app-postgresql-flexible-server/python/README.md @@ -37,7 +37,7 @@ The deploy scripts follow the same pattern as the sibling [`web-app-sql-database - [Bicep extension](https://marketplace.visualstudio.com/items?itemName=ms-azuretools.vscode-bicep), if you plan to install the sample via Bicep - [Terraform](https://developer.hashicorp.com/terraform/downloads), if you plan to install the sample via Terraform -> [!NOTE] +> [!IMPORTANT] > **Macs with Apple silicon**: this sample deploys a web app from code. The emulator builds it with Microsoft's Oryx build image and runs it on an Oryx runtime image, and Microsoft publishes both for amd64 only ([microsoft/Oryx#2133](https://github.com/microsoft/Oryx/issues/2133) asks for arm64). > On a Mac with Apple silicon they run only under Docker Desktop's amd64 emulation: in Docker Desktop's settings, under **General**, select the **Apple Virtualization framework** as the Virtual Machine Manager and turn on **Use Rosetta for x86_64/amd64 emulation on Apple Silicon**. > Under QEMU, which Docker Desktop uses otherwise (Rosetta off, or Docker VMM, which has no Rosetta), the sample is not expected to work: Oryx is a .NET app, and [.NET does not support QEMU](https://github.com/dotnet/core/blob/main/release-notes/8.0/supported-os.md). @@ -65,7 +65,7 @@ Deploy the application using one of these methods: All three variants provision the same topology: VNet + pe-subnet hosting a Private Endpoint targeting a public-access PostgreSQL flexible server, with a Private DNS Zone linked to the VNet. -> **Note** +> [!NOTE] > When you deploy the application to LocalStack for Azure for the first time, the initialization process pulls and builds Docker images (LocalStack itself plus the `postgres:18` backing container for the flexible-server emulator). This is a one-time operation — subsequent deployments are much faster. ## Test diff --git a/samples/web-app-sql-database/dotnet/README.md b/samples/web-app-sql-database/dotnet/README.md index eed9d6f4..c6ac6418 100644 --- a/samples/web-app-sql-database/dotnet/README.md +++ b/samples/web-app-sql-database/dotnet/README.md @@ -26,7 +26,7 @@ The following diagram illustrates the architecture of the solution: - [Bicep extension](https://marketplace.visualstudio.com/items?itemName=ms-azuretools.vscode-bicep), if you plan to install the sample via Bicep. - [Terraform](https://developer.hashicorp.com/terraform/downloads), if you plan to install the sample via Terraform. -> [!NOTE] +> [!IMPORTANT] > **Macs with Apple silicon**: this sample deploys a web app from code. The emulator builds it with Microsoft's Oryx build image and runs it on an Oryx runtime image, and Microsoft publishes both for amd64 only ([microsoft/Oryx#2133](https://github.com/microsoft/Oryx/issues/2133) asks for arm64). > On a Mac with Apple silicon they run only under Docker Desktop's amd64 emulation: in Docker Desktop's settings, under **General**, select the **Apple Virtualization framework** as the Virtual Machine Manager and turn on **Use Rosetta for x86_64/amd64 emulation on Apple Silicon**. > Under QEMU, which Docker Desktop uses otherwise (Rosetta off, or Docker VMM, which has no Rosetta), the sample is not expected to work: Oryx is a .NET app, and [.NET does not support QEMU](https://github.com/dotnet/core/blob/main/release-notes/8.0/supported-os.md). @@ -71,7 +71,7 @@ Set up the Azure emulator using the LocalStack for Azure Docker image. Before st docker pull localstack/localstack-azure ``` -> [!NOTE] +> [!IMPORTANT] > Each logical server you create runs a Microsoft SQL Server container, so you must accept the [SQL Server End-User Licensing Agreement](https://go.microsoft.com/fwlink/?LinkId=746388) before the emulator provisions one. > Start the emulator with `MSSQL_ACCEPT_EULA` set to `Y`: > @@ -122,7 +122,7 @@ Deploy the application to LocalStack for Azure using one of these methods: All deployment methods have been fully tested against Azure and the LocalStack for Azure local emulator. -> **Note** +> [!NOTE] > When you deploy the application to LocalStack for Azure for the first time, the initialization process involves downloading and building Docker images. This is a one-time operation—subsequent deployments will be significantly faster. Depending on your internet connection and system resources, this initial setup may take several minutes. ## Test diff --git a/samples/web-app-sql-database/dotnet/bicep/README.md b/samples/web-app-sql-database/dotnet/bicep/README.md index 7ceb47cd..f049e056 100644 --- a/samples/web-app-sql-database/dotnet/bicep/README.md +++ b/samples/web-app-sql-database/dotnet/bicep/README.md @@ -55,7 +55,7 @@ You can set up the Azure emulator by utilizing LocalStack for Azure Docker image docker pull localstack/localstack-azure ``` -> [!NOTE] +> [!IMPORTANT] > Each logical server you create runs a Microsoft SQL Server container, so you must accept the [SQL Server End-User Licensing Agreement](https://go.microsoft.com/fwlink/?LinkId=746388) before the emulator provisions one. > Start the emulator with `MSSQL_ACCEPT_EULA` set to `Y`: > diff --git a/samples/web-app-sql-database/dotnet/scripts/README.md b/samples/web-app-sql-database/dotnet/scripts/README.md index 8369c886..965d8b74 100644 --- a/samples/web-app-sql-database/dotnet/scripts/README.md +++ b/samples/web-app-sql-database/dotnet/scripts/README.md @@ -53,7 +53,7 @@ You can set up the Azure emulator by utilizing LocalStack for Azure Docker image docker pull localstack/localstack-azure ``` -> [!NOTE] +> [!IMPORTANT] > Each logical server you create runs a Microsoft SQL Server container, so you must accept the [SQL Server End-User Licensing Agreement](https://go.microsoft.com/fwlink/?LinkId=746388) before the emulator provisions one. > Start the emulator with `MSSQL_ACCEPT_EULA` set to `Y`: > diff --git a/samples/web-app-sql-database/dotnet/terraform/README.md b/samples/web-app-sql-database/dotnet/terraform/README.md index 6838e3d0..393f558d 100644 --- a/samples/web-app-sql-database/dotnet/terraform/README.md +++ b/samples/web-app-sql-database/dotnet/terraform/README.md @@ -77,7 +77,7 @@ You can set up the Azure emulator by utilizing LocalStack for Azure Docker image docker pull localstack/localstack-azure ``` -> [!NOTE] +> [!IMPORTANT] > Each logical server you create runs a Microsoft SQL Server container, so you must accept the [SQL Server End-User Licensing Agreement](https://go.microsoft.com/fwlink/?LinkId=746388) before the emulator provisions one. > Start the emulator with `MSSQL_ACCEPT_EULA` set to `Y`: > diff --git a/samples/web-app-sql-database/python/README.md b/samples/web-app-sql-database/python/README.md index 5e9b77c6..70d48298 100644 --- a/samples/web-app-sql-database/python/README.md +++ b/samples/web-app-sql-database/python/README.md @@ -26,7 +26,7 @@ The following diagram illustrates the architecture of the solution: - [Bicep extension](https://marketplace.visualstudio.com/items?itemName=ms-azuretools.vscode-bicep), if you plan to install the sample via Bicep. - [Terraform](https://developer.hashicorp.com/terraform/downloads), if you plan to install the sample via Terraform. -> [!NOTE] +> [!IMPORTANT] > **Macs with Apple silicon**: this sample deploys a web app from code. The emulator builds it with Microsoft's Oryx build image and runs it on an Oryx runtime image, and Microsoft publishes both for amd64 only ([microsoft/Oryx#2133](https://github.com/microsoft/Oryx/issues/2133) asks for arm64). > On a Mac with Apple silicon they run only under Docker Desktop's amd64 emulation: in Docker Desktop's settings, under **General**, select the **Apple Virtualization framework** as the Virtual Machine Manager and turn on **Use Rosetta for x86_64/amd64 emulation on Apple Silicon**. > Under QEMU, which Docker Desktop uses otherwise (Rosetta off, or Docker VMM, which has no Rosetta), the sample is not expected to work: Oryx is a .NET app, and [.NET does not support QEMU](https://github.com/dotnet/core/blob/main/release-notes/8.0/supported-os.md). @@ -71,7 +71,7 @@ Set up the Azure emulator using the LocalStack for Azure Docker image. Before st docker pull localstack/localstack-azure ``` -> [!NOTE] +> [!IMPORTANT] > Each logical server you create runs a Microsoft SQL Server container, so you must accept the [SQL Server End-User Licensing Agreement](https://go.microsoft.com/fwlink/?LinkId=746388) before the emulator provisions one. > Start the emulator with `MSSQL_ACCEPT_EULA` set to `Y`: > @@ -122,7 +122,7 @@ Deploy the application to LocalStack for Azure using one of these methods: All deployment methods have been fully tested against Azure and the LocalStack for Azure local emulator. -> **Note** +> [!NOTE] > When you deploy the application to LocalStack for Azure for the first time, the initialization process involves downloading and building Docker images. This is a one-time operation—subsequent deployments will be significantly faster. Depending on your internet connection and system resources, this initial setup may take several minutes. ## Test diff --git a/samples/web-app-sql-database/python/bicep/README.md b/samples/web-app-sql-database/python/bicep/README.md index 2f9a32da..6e12a617 100644 --- a/samples/web-app-sql-database/python/bicep/README.md +++ b/samples/web-app-sql-database/python/bicep/README.md @@ -55,7 +55,7 @@ You can set up the Azure emulator by utilizing LocalStack for Azure Docker image docker pull localstack/localstack-azure ``` -> [!NOTE] +> [!IMPORTANT] > Each logical server you create runs a Microsoft SQL Server container, so you must accept the [SQL Server End-User Licensing Agreement](https://go.microsoft.com/fwlink/?LinkId=746388) before the emulator provisions one. > Start the emulator with `MSSQL_ACCEPT_EULA` set to `Y`: > diff --git a/samples/web-app-sql-database/python/scripts/README.md b/samples/web-app-sql-database/python/scripts/README.md index 6bc7805c..d0c7866b 100644 --- a/samples/web-app-sql-database/python/scripts/README.md +++ b/samples/web-app-sql-database/python/scripts/README.md @@ -53,7 +53,7 @@ You can set up the Azure emulator by utilizing LocalStack for Azure Docker image docker pull localstack/localstack-azure ``` -> [!NOTE] +> [!IMPORTANT] > Each logical server you create runs a Microsoft SQL Server container, so you must accept the [SQL Server End-User Licensing Agreement](https://go.microsoft.com/fwlink/?LinkId=746388) before the emulator provisions one. > Start the emulator with `MSSQL_ACCEPT_EULA` set to `Y`: > diff --git a/samples/web-app-sql-database/python/terraform/README.md b/samples/web-app-sql-database/python/terraform/README.md index 541809ff..1b8a4865 100644 --- a/samples/web-app-sql-database/python/terraform/README.md +++ b/samples/web-app-sql-database/python/terraform/README.md @@ -77,7 +77,7 @@ You can set up the Azure emulator by utilizing LocalStack for Azure Docker image docker pull localstack/localstack-azure ``` -> [!NOTE] +> [!IMPORTANT] > Each logical server you create runs a Microsoft SQL Server container, so you must accept the [SQL Server End-User Licensing Agreement](https://go.microsoft.com/fwlink/?LinkId=746388) before the emulator provisions one. > Start the emulator with `MSSQL_ACCEPT_EULA` set to `Y`: >