docs: azure content migration to v2 information architecture (#457)

Co-authored-by: Brian Rinaldi <brian.rinaldi@gmail.com>

Author: quetzalliwrites

astro.config.mjs

@@ -215,7 +215,7 @@ export default defineConfig({
         }),
         starlightLinksValidator({
           errorOnRelativeLinks: true,
-          errorOnLocalLinks: false,  // Allow localhost links in tutorials (they're instructional)
+          errorOnLocalLinks: false, // Allow localhost links in tutorials (they're instructional)
           errorOnInvalidHashes: true,
         }),
         starlightUtils({
@@ -562,20 +562,16 @@ export default defineConfig({
             },
             {
               label: 'Getting Started',
-              autogenerate: { directory: '/azure/getting-started' },
+              autogenerate: { directory: 'azure/getting-started' },
               collapsed: true,
             },
             {
               label: 'Local Azure Services',
               slug: 'azure/services',
             },
-            {
-              label: 'Sample Apps',
-              slug: 'azure/sample-apps',
-            },
             {
               label: 'Integrations',
-              autogenerate: { directory: '/azure/integrations' },
+              autogenerate: { directory: 'azure/integrations' },
               collapsed: true,
             },
             {

src/content/docs/azure/changelog.mdx

@@ -2,11 +2,20 @@
 title: Changelog
 description: Changelog for LocalStack for Azure.
 template: doc
-editUrl: false
 ---
 
-This changelog will track updates to LocalStack's Azure support, including new services, enhancements, and compatibility fixes.
+This changelog tracks updates to LocalStack for Azure support, including new services, enhancements, and compatibility fixes.
 
-### Upcoming
+LocalStack for Azure 0.1.0 supports the following services:
 
-- Initial Azure documentation navigation and service discovery pages.
+- [Azure API Management](https://azure.microsoft.com/en-us/products/api-management/)
+- [Azure App Service](https://azure.microsoft.com/en-us/products/app-service/)
+- [Azure RBAC](https://learn.microsoft.com/en-us/azure/role-based-access-control/)
+- [Azure Container Registry](https://azure.microsoft.com/en-us/products/container-registry/)
+- [Azure Kubernetes Service](https://azure.microsoft.com/en-us/products/kubernetes-service/)
+- [Azure Database for PostgreSQL](https://azure.microsoft.com/en-us/products/postgresql/)
+- [Azure Key Vault](https://azure.microsoft.com/en-us/products/key-vault/)
+- [Azure Resource Manager](https://azure.microsoft.com/en-us/get-started/azure-portal/resource-manager/)
+- [Azure Blob Storage](https://azure.microsoft.com/en-us/products/storage/blobs/)
+- [Azure Storage](https://azure.microsoft.com/en-us/products/category/storage/)
+- [Azure SQL](https://azure.microsoft.com/en-us/products/azure-sql/database/)

src/content/docs/azure/getting-started/index.mdx

@@ -5,3 +5,76 @@ template: doc
 sidebar:
     order: 0
 ---
+
+
+## Introduction
+
+You can set up the Azure emulator by utilizing LocalStack for Azure Docker image.
+Before starting, ensure you have a valid `LOCALSTACK_AUTH_TOKEN` to access the Azure emulator.
+Refer to the [Auth Token guide](/aws/getting-started/auth-token/) to obtain your Auth Token and specify it in the `LOCALSTACK_AUTH_TOKEN` environment variable.
+
+The Azure Docker image is available on the [LocalStack Docker Hub](https://hub.docker.com/r/localstack/localstack-azure-alpha).
+To pull the Azure Docker image, execute the following command:
+
+```
+$ docker pull localstack/localstack-azure-alpha
+```
+
+You can start the Azure emulator using the following methods:
+
+1. [`localstack` CLI](/aws/getting-started/installation/#localstack-cli)
+2. [`docker` CLI](https://docs.docker.com/get-docker/)
+3. [Docker Compose](https://docs.docker.com/compose/install/)
+
+### `localstack` CLI
+
+To start the Azure emulator using the `localstack` CLI, execute the following command:
+
+```
+$ export LOCALSTACK_AUTH_TOKEN=<your_auth_token>
+$ IMAGE_NAME=localstack/localstack-azure-alpha localstack start
+```
+
+### `docker` CLI
+
+To start the Azure emulator using the `docker` CLI, execute the following command:
+
+```
+$ docker run \
+    --rm -it \
+    -p 4566:4566 \
+    -v /var/run/docker.sock:/var/run/docker.sock \
+    -v ~/.localstack/volume:/var/lib/localstack \
+    -e LOCALSTACK_AUTH_TOKEN=${LOCALSTACK_AUTH_TOKEN:?} \
+    localstack/localstack-azure-alpha
+```
+
+### Docker Compose
+
+Create a `docker-compose.yml` file with the specified content:
+
+```yaml
+version: "3.8"
+
+services:
+  localstack:
+    container_name: "localstack-main"
+    image: localstack/localstack-azure-alpha
+    ports:
+      - "127.0.0.1:4566:4566"
+    environment:
+      - LOCALSTACK_AUTH_TOKEN=${LOCALSTACK_AUTH_TOKEN:?}
+    volumes:
+      - "./volume:/var/lib/localstack"
+```
+
+Start the Azure emulator with the following command:
+
+```
+$ docker-compose up
+```
+
+### Updating
+
+To update the Azure Docker container, pull the latest image and restart the container.
+The `latest` tag is the nightly build of the Azure Docker image.

src/content/docs/azure/getting-started/quickstart.md

@@ -0,0 +1,88 @@
+---
+title: Quickstart
+description: Get started with LocalStack for Azure in a few simple steps.
+template: doc
+sidebar:
+    order: 1
+---
+
+## Introduction
+
+This guide explains how to set up the Azure emulator and interact with it using the [`az` CLI](https://learn.microsoft.com/en-us/cli/azure/).
+In this guide, you will run some basic Azure CLI commands to manage resource groups in an local Azure development environment without connecting to the real cloud services.
+
+## Prerequisites
+
+- [`localstack`  CLI](/aws/getting-started/installation/#localstack-cli)
+- [`azlocal` CLI](https://pypi.org/project/azlocal/)
+- [LocalStack for Azure](/azure/getting-started/)
+
+## Instructions
+
+Before you begin, make sure that the Emulator is running, see the [installation instructions](/azure/getting-started/).
+
+### Setup the `azlocal` tool
+
+To instruct the regular `az` CLI tool to communicate with the Azure emulator, run the following command:
+
+```
+$ azlocal start_interception
+```
+
+You may see some warnings about experimental commands, you can safely ignore these.
+
+### Create a resource group
+
+To create a resource group, you can now the same `az` command as you would normally:
+
+```
+$ az group create --name MyResourceGroup --location westeurope
+```
+
+The following output would be displayed:
+
+```bash
+{
+  "id": "/subscriptions/some-generated-id/resourceGroups/MyResourceGroup",
+  "location": "westeurope",
+  "managedBy": null,
+  "name": "MyResourceGroup",
+  "properties": {
+    "provisioningState": "Succeeded"
+  },
+  "tags": null,
+  "type": "Microsoft.Resources/resourceGroups"
+}
+```
+
+### Check & list resource groups
+
+To check the resource group details, run the following command:
+
+```
+$ az group show --name MyResourceGroup
+```
+
+To list all the resource groups, run the following command:
+
+```
+$ azlocal group list
+```
+
+### Delete the resource group
+
+To delete the resource group, run the following command:
+
+```
+$ az group delete --name MyResourceGroup --yes
+```
+
+### Teardown
+
+When you're done using the Azure Emulator, you can run the following command:
+
+```
+$ azlocal stop_interception
+```
+
+All invocations of the `az` CLI tool will now talk to the real Azure Cloud again.

src/content/docs/azure/integrations/az.md

@@ -0,0 +1,74 @@
+---
+title: az
+description: Get started with the az tool on LocalStack for Azure.
+template: doc
+sidebar:
+    order: 1
+---
+
+## Introduction
+
+The Azure CLI tool (`az`) is a tool that allows you to manually create and mange Azure resources.
+This guide will show you how to use it to interact with LocalStack.
+
+## Getting started
+
+This guide is designed for users who are new to LocalStack for Azure emulator and assumes basic knowledge of how the Azure CLI works.
+We will demonstrate how to create, show and delete an Azure resource group.
+
+### Install the packages
+
+Run the following command to install the required packages:
+
+```
+$ pip install azlocal
+```
+
+You now have access to the following LocalStack tools:
+
+| CLI tool  | LocalStack tool | Purpose                       |
+|-----------|-----------------|-------------------------------|
+| az        | azlocal         | Interact with Azure resources |
+| azd       | azdlocal        | Deploy ARM/Bicep templates    |
+| func      | funclocal       | Deploy Azure Functions        |
+
+The LocalStack variants are wrappers around the existing tools, so you keep the full  functionality of the original tool. It will just redirect all commands to the running LocalStack Emulator.
+
+### Setup the az CLI
+
+To make sure the `az` tool sends requests to the Azure Emulator REST API, run the following command:
+
+```
+$ azlocal start_interception
+```
+
+### Create and manage the Resource Group
+
+Run the following command to create a resource group in the Emulator:
+
+```
+$ az group create --name MyResourceGroup --location westeurope
+```
+
+To check the resource group details, run the following command:
+
+```
+$ az group show --name MyResourceGroup
+```
+
+To delete the resource group, run the following command:
+
+```
+$ az group delete --name MyResourceGroup --yes
+```
+
+### Teardown
+
+When you're done using the Azure Emulator, you can run the following command:
+
+```
+$ azlocal stop_interception
+```
+
+The `az` CLI tool will now communicate with the Azure REST API on future invocations.
+