Skip to content

Commit 51d89f7

Browse files
committed
spacing and acrolix fixes
1 parent 729d203 commit 51d89f7

File tree

1 file changed

+74
-68
lines changed

1 file changed

+74
-68
lines changed

articles/spring-apps/quickstart.md

Lines changed: 74 additions & 68 deletions
Original file line numberDiff line numberDiff line change
@@ -17,9 +17,9 @@ ms.custom: devx-track-java, devx-track-azurecli, mode-other, event-tier1-build-2
1717
> [!NOTE]
1818
> Azure Spring Apps is the new name for the Azure Spring Cloud service. Although the service has a new name, you'll see the old name in some places for a while as we work to update assets such as screenshots, videos, and diagrams.
1919
20-
**This article applies to:** ✔️ Basic/Standard tier ✔️ Enterprise tier
20+
**This article applies to:** ✔️ Standard consumption (Preview) ✔️ Basic/Standard ✔️ Enterprise
2121

22-
This quickstart explains how to deploy a small application to run on Azure Spring Apps.
22+
This article explains how to deploy a small application to run on Azure Spring Apps.
2323

2424
The application code used in this tutorial is a simple app. When you've completed this example, the application will be accessible online, and you can manage it through the Azure portal.
2525

@@ -44,23 +44,23 @@ At the end of this quickstart, you'll have a working spring app running on Azure
4444

4545
## Provision an instance of Azure Spring Apps
4646

47-
Use the following steps to provision a service instance.
47+
Use the following steps to create a service instance of Azure Spring Apps.
4848

4949
1. Select **Open Cloudshell** and sign in to your Azure account in [Azure Cloud Shell](../cloud-shell/overview.md).
5050

51-
```azurecli-interactive
52-
az account show
53-
```
51+
```azurecli-interactive
52+
az account show
53+
```
5454
5555
1. Azure Cloud Shell workspaces are temporary. On initial start, the shell prompts you to associate an [Azure Storage](../storage/common/storage-introduction.md) instance with your subscription to persist files across sessions.
5656
57-
:::image type="content" source="media/quickstart/azure-storage-subscription.png" alt-text="Screenshot of Azure Storage subscription." lightbox="media/quickstart/azure-storage-subscription.png":::
57+
:::image type="content" source="media/quickstart/azure-storage-subscription.png" alt-text="Screenshot of Azure Storage subscription." lightbox="media/quickstart/azure-storage-subscription.png":::
5858
5959
1. After you sign in successfully, use the following command to display a list of your subscriptions.
6060
61-
```azurecli-interactive
62-
az account list --output table
63-
```
61+
```azurecli-interactive
62+
az account list --output table
63+
```
6464
6565
1. Use the following command to choose and link to your subscription.
6666
@@ -70,28 +70,29 @@ Use the following steps to provision a service instance.
7070

7171
1. Use the following command to create a resource group.
7272

73-
```azurecli-interactive
74-
az group create \
75-
--resource-group <name-of-resource-group> \
76-
--location eastus
77-
```
73+
```azurecli-interactive
74+
az group create \
75+
--resource-group <name-of-resource-group> \
76+
--location eastus
77+
```
7878
7979
1. Use the following command to create an Azure Spring Apps service instance.
8080
81-
```azurecli-interactive
82-
az spring create \
83-
--resource-group <name-of-resource-group> \
84-
--name <service-instance-name>
85-
```
81+
```azurecli-interactive
82+
az spring create \
83+
--resource-group <name-of-resource-group> \
84+
--name <service-instance-name>
85+
```
8686
8787
1. Choose **Y** to install the Azure Spring Apps extension and run it.
8888
8989
## Create an app in your Azure Spring Apps instance
90+
9091
An [**App**](/azure/spring-apps/concept-understand-app-and-deployment) is an abstraction of one business app. Apps run in an Azure Spring Apps Service Instance, or simply service instance, as shown next.
9192
</br>
9293
![Apps and Deployments](./media/spring-cloud-app-and-deployment/app-deployment-rev.png)
9394
</br>
94-
Use the following command to specify the app name on Azure Spring Apps as *hellospring*.
95+
Use the following command to specify the app name on Azure Spring Apps as *hello spring*.
9596
9697
```azurecli-interactive
9798
az spring app create \
@@ -107,21 +108,21 @@ Use the following steps to clone the Spring Boot sample project.
107108

108109
1. Use the following command to clone the [Spring Boot sample project](https://github.com/spring-guides/gs-spring-boot.git) from GitHub.
109110

110-
```azurecli-interactive
111-
git clone -b boot-2.7 https://github.com/spring-guides/gs-spring-boot.git
112-
```
111+
```azurecli-interactive
112+
git clone -b boot-2.7 https://github.com/spring-guides/gs-spring-boot.git
113+
```
113114
114115
1. Use the following command to move to the project folder.
115116
116-
```azurecli-interactive
117-
cd gs-spring-boot/complete
118-
```
117+
```azurecli-interactive
118+
cd gs-spring-boot/complete
119+
```
119120
120121
1. Use the following [Maven](https://maven.apache.org/what-is-maven.html) command to build the project.
121122
122-
```azurecli-interactive
123-
mvn clean package -DskipTests
124-
```
123+
```azurecli-interactive
124+
mvn clean package -DskipTests
125+
```
125126
126127
## Deploy the local app to Azure Spring Apps
127128
@@ -142,23 +143,24 @@ Deploying the application can take a few minutes.
142143
## Prerequisites
143144

144145
- An Azure subscription. If you don't have a subscription, create a [free account](https://azure.microsoft.com/free/) before you begin.
145-
- [Azure CLI](/cli/azure/install-azure-cli). Install the spring extension specifically designed for StandardGen2 Azure Spring Apps.
146+
- [Azure CLI](/cli/azure/install-azure-cli). Install the spring extension for StandardGen2 Azure Spring Apps.
146147

147148
```shell
148149
az extension add --upgrade --name spring
149150
```
150151

151152
- Install the Azure Container Apps extension for the CLI and register these namespaces: `Microsoft.App`, `Microsoft.OperationalInsights` and `Microsoft.AppPlatform`
152-
```shell
153-
az extension add --name containerapp --upgrade
154-
az provider register --namespace Microsoft.App
155-
az provider register --namespace Microsoft.OperationalInsights
156-
az provider register --namespace Microsoft.AppPlatform
153+
154+
```shell
155+
az extension add --name containerapp --upgrade
156+
az provider register --namespace Microsoft.App
157+
az provider register --namespace Microsoft.OperationalInsights
158+
az provider register --namespace Microsoft.AppPlatform
157159
```
158160

159161
## Provision an instance of Azure Spring Apps
160162

161-
Use the following steps to provision a service instance.
163+
Use the following steps to create a service instance of Azure Spring Apps.
162164

163165
1. Select **Open Cloudshell** and sign in to your Azure account in [Azure Cloud Shell](../cloud-shell/overview.md).
164166

@@ -168,7 +170,7 @@ Use the following steps to provision a service instance.
168170

169171
1. Azure Cloud Shell workspaces are temporary. On initial start, the shell prompts you to associate an [Azure Storage](../storage/common/storage-introduction.md) instance with your subscription to persist files across sessions.
170172

171-
:::image type="content" source="media/quickstart/azure-storage-subscription.png" alt-text="Screenshot of Azure Storage subscription." lightbox="media/quickstart/azure-storage-subscription.png":::
173+
:::image type="content" source="media/quickstart/azure-storage-subscription.png" alt-text="Screenshot of Azure Storage subscription." lightbox="media/quickstart/azure-storage-subscription.png":::
172174

173175
1. After you sign in successfully, use the following command to display a list of your subscriptions.
174176

@@ -181,23 +183,26 @@ Use the following steps to provision a service instance.
181183
```azurecli-interactive
182184
az account set --subscription <subscription-id>
183185
```
184-
1. These are the pre-defined parameters used in this quickstart, you can also define your own based on needs:
186+
187+
1. Define variables for this quickstart.
188+
185189
```azurecli-interactive
186-
LOCATION="eastus"
187-
RESOURCE_GROUP="my-resoure-group"
188-
MANAGED_ENVIRONMENT="my-managed-environment"
189-
SERVICE_NAME="my-service-name"
190-
APP_NAME="my-app-name-test"
190+
LOCATION="<location>"
191+
RESOURCE_GROUP="<resource group>"
192+
MANAGED_ENVIRONMENT="<Azure-Container-Apps-environment-name>"
193+
SERVICE_NAME="<Azure-Spring-Apps-instance-name>"
194+
APP_NAME="<Spring-app-name>"
191195
```
192196

193197
1. Use the following command to create a resource group.
194198

195199
```azurecli-interactive
196200
az group create \
197-
--resource-group ${RESOURCE_GROUP} \
198-
--location ${LOCATION}
201+
--resource-group ${RESOURCE_GROUP} \
202+
--location ${LOCATION}
199203
```
200-
1. An Azure Container App environment creates a secure boundary around a group apps. Apps deployed to the same environment are deployed in the same virtual network and write logs to the same [Log Analytics workspace](https://learn.microsoft.com/azure/azure-monitor/logs/log-analytics-workspace-overview). To create the environment, run the following command
204+
205+
1. An Azure Container App environment creates a secure boundary around a group of applications. Apps deployed to the same environment are deployed in the same virtual network and write logs to the same [Log Analytics workspace](https://learn.microsoft.com/azure/azure-monitor/logs/log-analytics-workspace-overview). To create the environment, run the following command
201206

202207
```azurecli-interactive
203208
az containerapp env create \
@@ -206,23 +211,24 @@ Use the following steps to provision a service instance.
206211
--location ${LOCATION}
207212
```
208213

209-
1. Set the environment varable:
214+
1. Set the environment variable:
215+
210216
```azurecli-interactive
211217
MANAGED_ENV_RESOURCE_ID=$(az containerapp env show \
212218
--name ${MANAGED_ENVIRONMENT} \
213219
--resource-group ${RESOURCE_GROUP} \
214220
--query id -o tsv)
215221
```
216222

217-
1. Use the following command to create an Azure Spring Apps service instance.The StandardGen2 Azure Spring Apps instance is built on top of the Container Environment: Create your Azure Spring Apps instance by specifying the resource id of the ACA Environment you just created:
223+
1. Use the following command to create an Azure Spring Apps service instance. The StandardGen2 Azure Spring Apps instance is built on top of the Container Environment: Create your Azure Spring Apps instance by specifying the resource ID of the ACA Environment you created:
218224

219225
```azurecli-interactive
220226
az spring create \
221-
--resource-group ${RESOURCE_GROUP} \
222-
--name ${SERVICE_NAME} \
223-
--managed-environment ${MANAGED_ENV_RESOURCE_ID} \
224-
--sku standardGen2 \
225-
--location ${LOCATION}
227+
--resource-group ${RESOURCE_GROUP} \
228+
--name ${SERVICE_NAME} \
229+
--managed-environment ${MANAGED_ENV_RESOURCE_ID} \
230+
--sku standardGen2 \
231+
--location ${LOCATION}
226232
```
227233

228234
## Create an app in your Azure Spring Apps instance
@@ -233,18 +239,18 @@ An [**App**](/azure/spring-apps/concept-understand-app-and-deployment) is an abs
233239
</br>
234240
Use the following command to specify the app name on Azure Spring Apps and allocate required resources:
235241

236-
```azurecli-interactive
237-
az spring app create \
238-
--resource-group ${RESOURCE_GROUP} \
239-
--service ${SERVICE_NAME} \
240-
--name ${APP_NAME} \
241-
--cpu 1 \
242-
--memory 2Gi \
243-
--instance-count 2 \
244-
--assign-endpoint true
245-
```
242+
```azurecli-interactive
243+
az spring app create \
244+
--resource-group ${RESOURCE_GROUP} \
245+
--service ${SERVICE_NAME} \
246+
--name ${APP_NAME} \
247+
--cpu 1 \
248+
--memory 2Gi \
249+
--instance-count 2 \
250+
--assign-endpoint true
251+
```
246252

247-
Azure Spring Apps will create an empty welcome application, and you can find the appliction url in the field `properties.url`.
253+
Azure Spring Apps creates an empty welcome application, and you can find the application url in the field `properties.url`.
248254

249255
:::image type="content" source="media/quickstart/bannerapp.png" alt-text="Screenshot of the welcome page." lightbox="media/quickstart/bannerapp.png":::
250256

@@ -332,7 +338,7 @@ This example uses Java version 11. To use a different Java version, change the
332338
}
333339
```
334340

335-
## Provision an instance of Azure Spring Apps
341+
## Create an instance of Azure Spring Apps
336342

337343
Use the following steps to create an instance of Azure Spring Apps using the Azure portal.
338344

@@ -433,9 +439,9 @@ echo "Press [ENTER] to continue ..."
433439

434440
## Next steps
435441

436-
In this quickstart, you learned how to generate a basic Spring project, provision a service instance, build and deploy an app with a public endpoint, and clean up the resources.
442+
In this quickstart, you learned how to build and deploy a Spring app in a service instance of Azure Spring Apps. You also learned how to deploy an app with a public endpoint, and how to clean up resources.
437443

438-
You also have access to powerful logs, metrics, and distributed tracing capability from the Azure portal. For more information, see [Quickstart: Monitoring Azure Spring Apps apps with logs, metrics, and tracing](./quickstart-logs-metrics-tracing.md).
444+
You have access to powerful logs, metrics, and distributed tracing capability from the Azure portal. For more information, see [Quickstart: Monitoring Azure Spring Apps apps with logs, metrics, and tracing](./quickstart-logs-metrics-tracing.md).
439445

440446
To learn how to use more Azure Spring capabilities, advance to the quickstart series that deploys a sample application to Azure Spring Apps:
441447

0 commit comments

Comments
 (0)