Merge pull request #218846 from cebundy/upsize-quickstarts

[Container Apps]: Add Quickstarts using containerapp up command

Author: JamesJBarnett

articles/container-apps/TOC.yml

@@ -9,21 +9,14 @@
 - name: Quickstarts
   expanded: true
   items: 
-  - name: With a sample container image
+  - name: Deploy from an existing container image
     expanded: true
     items:
     - name: Azure portal
       href: quickstart-portal.md
     - name: Command line
       href: get-started.md
-  - name: With an existing container image
-    expanded: true
-    items:
-    - name: Azure portal
-      href: get-started-existing-container-image-portal.md
-    - name: Command line
-      href: get-started-existing-container-image.md
-  - name: With code on your local machine
+  - name: Deploy an app from code
     expanded: true
     items:
     - name: Command line
@@ -157,21 +150,26 @@
     - name: Plan for disaster recovery
       href: disaster-recovery.md
 - name: Tutorials
-  items:
-    - name: Communicate between microservices
-      href: communicate-between-microservices.md
-    - name: Microservices with Dapr using the CLI
-      href: microservices-dapr.md
-    - name: Microservices with Dapr using ARM or Bicep
-      href: microservices-dapr-azure-resource-manager.md
-    - name: Deploy a Dapr application using GitHub Actions
-      href: dapr-github-actions.md
-    - name: Event-driven work using Dapr Bindings
-      href: microservices-dapr-bindings.md
-    - name: Microservices communication using Dapr Publish and Subscribe
-      href: microservices-dapr-pubsub.md
-    - name: Microservices communication using Dapr Service Invocation
-      href: microservices-dapr-service-invoke.md
+  expanded: true
+  items: 
+    - name: Create and deploy a container app using the CLI
+      href: tutorial-deploy-first-app-cli.md
+    - name: Build a multiple app scenario
+      expanded: true
+      items:
+        - name: 1. Deploy a backend microservice app
+          href: tutorial-code-to-cloud.md
+        - name: 2. Deploy a frontend microservice app
+          href: communicate-between-microservices.md
+    - name: Deploy microservices with Dapr
+      expanded: true
+      items:
+      - name: Microservices with Dapr using the CLI
+        href: microservices-dapr.md
+      - name: Microservices with Dapr using ARM or Bicep
+        href: microservices-dapr-azure-resource-manager.md
+      - name: Deploy a Dapr application using GitHub Actions
+        href: dapr-github-actions.md
     - name: Background processing
       href: background-processing.md
     - name: Create an Azure Files storage mount

articles/container-apps/get-started.md

@@ -1,171 +1,173 @@
 ---
-title: 'Quickstart: Deploy your first container app'
-description: Deploy your first application to Azure Container Apps.
+title: 'Quickstart: Deploy your first container app with containerapp up'
+description: Deploy your first application to Azure Container Apps using the Azure CLI containerapp up command.
 services: container-apps
-author: craigshoemaker
+author: cebundy
 ms.service: container-apps
 ms.topic: quickstart
-ms.date: 03/21/2022
-ms.author: cshoe
-ms.custom: ignite-fall-2021, mode-api, devx-track-azurecli, event-tier1-build-2022, devx-track-azurepowershell
+ms.date: 03/29/2023
+ms.author: v-bcatherine
+ms.custom: devx-track-azurecli, event-tier1-build-2022
 ms.devlang: azurecli
 ---
 
-# Quickstart: Deploy your first container app
+# Quickstart: Deploy your first container app with containerapp up
 
 The Azure Container Apps service enables you to run microservices and containerized applications on a serverless platform. With Container Apps, you enjoy the benefits of running containers while you leave behind the concerns of manually configuring cloud infrastructure and complex container orchestrators.
 
-In this quickstart, you create a secure Container Apps environment and deploy your first container app.
+In this quickstart, you create and deploy your first container app using the `az containerapp up` command.
 
 ## Prerequisites
 
 - An Azure account with an active subscription.
   - If you don't have one, you [can create one for free](https://azure.microsoft.com/free/).
 - Install the [Azure CLI](/cli/azure/install-azure-cli).
 
-[!INCLUDE [container-apps-create-cli-steps.md](../../includes/container-apps-create-cli-steps.md)]
+## Setup
 
-# [Bash](#tab/bash)
+To sign in to Azure from the CLI, run the following command and follow the prompts to complete the authentication process.
 
-To create the environment, run the following command:
+# [Bash](#tab/bash)
 
 ```azurecli
-az containerapp env create \
-  --name $CONTAINERAPPS_ENVIRONMENT \
-  --resource-group $RESOURCE_GROUP \
-  --location $LOCATION
+az login
 ```
 
 # [Azure PowerShell](#tab/azure-powershell)
 
-A Log Analytics workspace is required for the Container Apps environment.  The following commands create a Log Analytics workspace and save the workspace ID and primary shared key to  variables.
-
 ```azurepowershell
-$WorkspaceArgs = @{
-    Name = 'myworkspace'
-    ResourceGroupName = $ResourceGroupName
-    Location = $Location
-    PublicNetworkAccessForIngestion = 'Enabled'
-    PublicNetworkAccessForQuery = 'Enabled'
-}
-New-AzOperationalInsightsWorkspace @WorkspaceArgs
-$WorkspaceId = (Get-AzOperationalInsightsWorkspace -ResourceGroupName $ResourceGroupName -Name $WorkspaceArgs.Name).CustomerId
-$WorkspaceSharedKey = (Get-AzOperationalInsightsWorkspaceSharedKey -ResourceGroupName $ResourceGroupName -Name $WorkspaceArgs.Name).PrimarySharedKey
+az login
 ```
 
-To create the environment, run the following command:
+---
+
+Ensure you're running the latest version of the CLI via the upgrade command.
+
+# [Bash](#tab/bash)
+
+```azurecli
+az upgrade
+```
+
+# [Azure PowerShell](#tab/azure-powershell)
 
 ```azurepowershell
-$EnvArgs = @{
-    EnvName = $ContainerAppsEnvironment
-    ResourceGroupName = $ResourceGroupName
-    Location = $Location
-    AppLogConfigurationDestination = 'log-analytics'
-    LogAnalyticConfigurationCustomerId = $WorkspaceId
-    LogAnalyticConfigurationSharedKey = $WorkspaceSharedKey
-}
-
-New-AzContainerAppManagedEnv @EnvArgs
+az upgrade
 ```
 
 ---
 
-## Create a container app
-
-Now that you have an environment created, you can deploy your first container app. With the `containerapp create` command, deploy a container image to Azure Container Apps.
+Next, install or update the Azure Container Apps extension for the CLI.
 
 # [Bash](#tab/bash)
 
 ```azurecli
-az containerapp create \
-  --name my-container-app \
-  --resource-group $RESOURCE_GROUP \
-  --environment $CONTAINERAPPS_ENVIRONMENT \
-  --image mcr.microsoft.com/azuredocs/containerapps-helloworld:latest \
-  --target-port 80 \
-  --ingress 'external' \
-  --query properties.configuration.ingress.fqdn
+az extension add --name containerapp --upgrade
 ```
 
-> [!NOTE]
-> Make sure the value for the `--image` parameter is in lower case.
-
-By setting `--ingress` to `external`, you make the container app available to public requests.
-
 # [Azure PowerShell](#tab/azure-powershell)
 
+
 ```azurepowershell
-$ImageParams = @{
-    Name = 'my-container-app'
-    Image = 'mcr.microsoft.com/azuredocs/containerapps-helloworld:latest'
-}
-$TemplateObj = New-AzContainerAppTemplateObject @ImageParams
-$EnvId = (Get-AzContainerAppManagedEnv -EnvName $ContainerAppsEnvironment -ResourceGroupName $ResourceGroupName).Id
-
-$AppArgs = @{
-    Name = 'my-container-app'
-    Location = $Location
-    ResourceGroupName = $ResourceGroupName
-    ManagedEnvironmentId = $EnvId
-    IdentityType = 'SystemAssigned'
-    TemplateContainer = $TemplateObj
-    IngressTargetPort = 80
-    IngressExternal = $true
-
-}
-New-AzContainerApp @AppArgs
+az extension add --name containerapp --upgrade
 ```
 
-> [!NOTE]
-> Make sure the value for the `Image` parameter is in lower case.
-
-By setting `IngressExternal` to `$true`, you make the container app available to public requests.
-
 ---
 
-## Verify deployment
+Register the `Microsoft.App` and `Microsoft.OperationalInsights` namespaces if you haven't already registered them in your Azure subscription.
 
 # [Bash](#tab/bash)
 
-The `create` command returns the fully qualified domain name for the container app. Copy this location to a web browser.
+```azurecli
+az provider register --namespace Microsoft.App
+```
 
-# [Azure PowerShell](#tab/azure-powershell)
+```azurecli
+az provider register --namespace Microsoft.OperationalInsights
+```
 
-Get the fully qualified domain name for the container app.
+# [Azure PowerShell](#tab/azure-powershell)
 
 ```azurepowershell
-(Get-AzContainerApp -Name $AppArgs.Name -ResourceGroupName $ResourceGroupName).IngressFqdn
+az provider register --namespace Microsoft.App
 ```
 
-Copy this location to a web browser.
+```azurepowershell
+az provider register --namespace Microsoft.OperationalInsights
+```
 
 ---
 
- The following message is displayed when the container app is deployed:
+Now that your Azure CLI setup is complete, you can define the environment variables that are used throughout this article.
 
-:::image type="content" source="media/get-started/azure-container-apps-quickstart.png" alt-text="Your first Azure Container Apps deployment.":::
 
-## Clean up resources
+## Create and deploy the container app
 
-If you're not going to continue to use this application, run the following command to delete the resource group along with all the resources created in this quickstart.
+Create and deploy your first container app with the `containerapp up` command. This command will:
+
+- Create the resource group
+- Create the Container Apps environment
+- Create the Log Analytics workspace
+- Create and deploy the container app using a public container image
+
+Note that if any of these resources already exist, the command will use them instead of creating new ones.
 
->[!CAUTION]
-> The following command deletes the specified resource group and all resources contained within it. If resources outside the scope of this quickstart exist in the specified resource group, they will also be deleted.
 
 # [Bash](#tab/bash)
 
 ```azurecli
-az group delete --name $RESOURCE_GROUP
+az containerapp up \
+  --name my-container-app \
+  --resource-group my-container-apps \
+  --location centralus \
+  --environment 'my-container-apps' \
+  --image mcr.microsoft.com/azuredocs/containerapps-helloworld:latest \
+  --target-port 80 \
+  --ingress external \
+  --query properties.configuration.ingress.fqdn
 ```
 
 # [Azure PowerShell](#tab/azure-powershell)
 
-```azurepowershell
-Remove-AzResourceGroup -Name $ResourceGroupName -Force
+```powershell
+az containerapp up `
+  --name my-container-app `
+  --resource-group my-container-apps `
+  --location centralus `
+  --environment  my-container-apps `
+  --image mcr.microsoft.com/azuredocs/containerapps-helloworld:latest `
+  --target-port 80 `
+  --ingress external `
+  --query properties.configuration.ingress.fqdn
 ```
 
 ---
 
+> [!NOTE]
+> Make sure the value for the `--image` parameter is in lower case.
+
+By setting `--ingress` to `external`, you make the container app available to public requests.
+
+## Verify deployment
+
+The `up` command returns the fully qualified domain name for the container app. Copy this location to a web browser.
+
+The following message is displayed when the container app is deployed:
+
+:::image type="content" source="media/get-started/azure-container-apps-quickstart.png" alt-text="Screenshot of container app web page.":::
+
+## Clean up resources
+
+If you're not going to continue to use this application, run the following command to delete the resource group along with all the resources created in this quickstart.
+
+>[!CAUTION]
+> The following command deletes the specified resource group and all resources contained within it. If resources outside the scope of this quickstart exist in the specified resource group, they will also be deleted.
+
+
+```azurecli
+az group delete --name my-container-apps
+```
+
 > [!TIP]
 > Having issues? Let us know on GitHub by opening an issue in the [Azure Container Apps repo](https://github.com/microsoft/azure-container-apps).