diff --git a/README.md b/README.md index d5ecdb6..72e7ce9 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 94facad..ca16a9f 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 9552f9a..f6fa92e 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 f1d17b7..ced0c6b 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 daac87a..1e0db3c 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 93430f4..115ecfe 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 e64a71d..51456c4 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 7087aa9..944a846 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 1e3aaed..da3e214 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 b2e84dd..0f7c29b 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 a04f219..9dd3d5c 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 ca24326..3faeeff 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 5711cc3..d115814 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 6bb9195..16ebd94 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 5bdbf99..0d3f915 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 f5805b8..efc9bec 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 ad28248..26ec454 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 3f11b52..98597c4 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 219f927..38e8498 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 f9c70da..d3e2c12 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 39f6d99..a7ae5fd 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 a9906a8..2114cd3 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 8ad93d6..b7aee8a 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 5088625..b76b540 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 7d5fee6..3d84851 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 16f0317..2d78939 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 e9c12ce..7e02d93 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 f1d6524..5e18dd5 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 e32c3ee..05d34a4 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 9e61e46..5708123 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 c33ab2a..9b838ca 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 ef0003b..d7800e1 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 e1ad40a..036754b 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 eed9d6f..c6ac641 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 7ceb47c..f049e05 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 8369c88..965d8b7 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 6838e3d..393f558 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 5e9b77c..70d4829 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 2f9a32d..6e12a61 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 6bc7805..d0c7866 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 541809f..1b8a486 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`: >