Merge pull request #220613 from schaffererin/freshness-pass-prepare-application-aks

AKS freshness pass: Prepare an application for AKS

Author: prmerger-automator[bot]

articles/aks/tutorial-kubernetes-prepare-app.md

@@ -3,18 +3,18 @@ title: Kubernetes on Azure tutorial  - Prepare an application
 description: In this Azure Kubernetes Service (AKS) tutorial, you learn how to prepare and build a multi-container app with Docker Compose that you can then deploy to AKS.
 services: container-service
 ms.topic: tutorial
-ms.date: 01/12/2021
-
+ms.date: 12/06/2022
 ms.custom: mvc
 
 #Customer intent: As a developer, I want to learn how to build a container-based application so that I can deploy the app to Azure Kubernetes Service.
 ---
 
 # Tutorial: Prepare an application for Azure Kubernetes Service (AKS)
 
-In this tutorial, part one of seven, a multi-container application is prepared for use in Kubernetes. Existing development tools such as Docker Compose are used to locally build and test an application. You learn how to:
+In this tutorial, part one of seven, you prepare a multi-container application to use in Kubernetes. You use existing development tools like Docker Compose to locally build and test the application. You learn how to:
 
 > [!div class="checklist"]
+>
 > * Clone a sample application source from GitHub
 > * Create a container image from the sample application source
 > * Test the multi-container application in a local Docker environment
@@ -23,7 +23,7 @@ Once completed, the following application runs in your local development environ
 
 :::image type="content" source="./media/container-service-kubernetes-tutorials/azure-vote-local.png" alt-text="Screenshot showing the container image Azure Voting App running locally opened in a local web browser" lightbox="./media/container-service-kubernetes-tutorials/azure-vote-local.png":::
 
-In later tutorials, the container image is uploaded to an Azure Container Registry, and then deployed into an AKS cluster.
+In later tutorials, you upload the container image to an Azure Container Registry (ACR), and then deploy it into an AKS cluster.
 
 ## Before you begin
 
@@ -38,7 +38,7 @@ To complete this tutorial, you need a local Docker development environment runni
 
 The [sample application][sample-application] used in this tutorial is a basic voting app consisting of a front-end web component and a back-end Redis instance. The web component is packaged into a custom container image. The Redis instance uses an unmodified image from Docker Hub.
 
-Use [git][] to clone the sample application to your development environment:
+Use [git][] to clone the sample application to your development environment.
 
 ```console
 git clone https://github.com/Azure-Samples/azure-voting-app-redis.git
@@ -50,7 +50,7 @@ Change into the cloned directory.
 cd azure-voting-app-redis
 ```
 
-Inside the directory is the application source code, a pre-created Docker compose file, and a Kubernetes manifest file. These files are used throughout the tutorial set. The contents and structure of the directory are as follows:
+The directory contains the application source code, a pre-created Docker compose file, and a Kubernetes manifest file. These files are used throughout the tutorial set. The contents and structure of the directory are as follows:
 
 ```output
 azure-voting-app-redis
@@ -84,13 +84,13 @@ azure-voting-app-redis
 
 [Docker Compose][docker-compose] can be used to automate building container images and the deployment of multi-container applications.
 
-Use the sample `docker-compose.yaml` file to create the container image, download the Redis image, and start the application:
+The following command uses the sample `docker-compose.yaml` file to create the container image, download the Redis image, and start the application.
 
 ```console
 docker-compose up -d
 ```
 
-When completed, use the [docker images][docker-images] command to see the created images. Three images have been downloaded or created. The *azure-vote-front* image contains the front-end application and uses the *nginx-flask* image as a base. The *redis* image is used to start a Redis instance.
+When completed, use the [`docker images`][docker-images] command to see the created images. Three images are downloaded or created. The *azure-vote-front* image contains the front-end application and uses the *nginx-flask* image as a base. The *redis* image is used to start a Redis instance.
 
 ```
 $ docker images
@@ -101,7 +101,7 @@ mcr.microsoft.com/oss/bitnami/redis            6.0.8               3a54a920bb6c
 tiangolo/uwsgi-nginx-flask                     python3.6           a16ce562e863        6 weeks ago         944MB
 ```
 
-Run the [docker ps][docker-ps] command to see the running containers:
+Run the [`docker ps`][docker-ps] command to see the running containers.
 
 ```
 $ docker ps
@@ -113,32 +113,33 @@ d10e5244f237        mcr.microsoft.com/azuredocs/azure-vote-front:v1   "/entrypoi
 
 ## Test application locally
 
-To see the running application, enter `http://localhost:8080` in a local web browser. The sample application loads, as shown in the following example:
+To see your running application, navigate to `http://localhost:8080` in a local web browser. The sample application loads, as shown in the following example:
 
 :::image type="content" source="./media/container-service-kubernetes-tutorials/azure-vote-local.png" alt-text="Screenshot showing the container image Azure Voting App running locally opened in a local web browser" lightbox="./media/container-service-kubernetes-tutorials/azure-vote-local.png":::
 
 ## Clean up resources
 
-Now that the application's functionality has been validated, the running containers can be stopped and removed. ***Do not delete the container images*** - in the next tutorial, the *azure-vote-front* image is uploaded to an Azure Container Registry instance.
+Now that the application's functionality has been validated, the running containers can be stopped and removed. ***Do not delete the container images*** - in the next tutorial, you'll upload the *azure-vote-front* image to an ACR instance.
 
-Stop and remove the container instances and resources with the [docker-compose down][docker-compose-down] command:
+To stop and remove the container instances and resources, use the [`docker-compose down`][docker-compose-down] command.
 
 ```console
 docker-compose down
 ```
 
-When the local application has been removed, you have a Docker image that contains the Azure Vote application, *azure-vote-front*, for use with the next tutorial.
+When the local application has been removed, you have a Docker image that contains the Azure Vote application, *azure-vote-front*, to use in the next tutorial.
 
 ## Next steps
 
-In this tutorial, an application was tested and container images created for the application. You learned how to:
+In this tutorial, you created a sample application, created container images for the application, and then tested the application. You learned how to:
 
 > [!div class="checklist"]
+
 > * Clone a sample application source from GitHub
 > * Create a container image from the sample application source
 > * Test the multi-container application in a local Docker environment
 
-Advance to the next tutorial to learn how to store container images in Azure Container Registry.
+In the next tutorial, you'll learn how to store container images in an ACR.
 
 > [!div class="nextstepaction"]
 > [Push images to Azure Container Registry][aks-tutorial-prepare-acr]