Skip to content

Commit b7393cf

Browse files
Merge pull request #256787 from maud-lv/ml-screfresh
Service Connector refresh docs
2 parents 345c9a4 + 15bd671 commit b7393cf

File tree

7 files changed

+51
-62
lines changed

7 files changed

+51
-62
lines changed
Binary file not shown.
14.2 KB
Loading
-45 KB
Loading

articles/service-connector/quickstart-cli-container-apps.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -5,12 +5,12 @@ author: maud-lv
55
ms.author: malev
66
ms.service: service-connector
77
ms.topic: quickstart
8-
ms.date: 04/13/2023
8+
ms.date: 10/31/2023
99
ms.devlang: azurecli
1010
ms.custom: devx-track-azurecli
1111
---
1212

13-
# Quickstart: Create a service connection in Container Apps with the Azure CLI
13+
# Quickstart: Create a service connection in Azure Container Apps with the Azure CLI
1414

1515
This quickstart shows you how to connect Azure Container Apps to other Cloud resources using the Azure CLI and Service Connector. Service Connector lets you quickly connect compute services to cloud services, while managing your connection's authentication and networking settings.
1616

@@ -49,11 +49,11 @@ This quickstart shows you how to connect Azure Container Apps to other Cloud res
4949
5050
## Create a service connection
5151
52-
You can create a connection using an access key or a managed identity.
52+
Create a connection using an access key or a managed identity.
5353
5454
### [Access key](#tab/using-access-key)
5555
56-
1. Run the `az containerapp connection create` command to create a service connection between Container Apps and Azure Blob Storage with an access key.
56+
1. Run the `az containerapp connection create` command to create a service connection between Container Apps and Azure Blob Storage using an access key.
5757
5858
```azurecli
5959
az containerapp connection create storage-blob --secret

articles/service-connector/quickstart-cli-spring-cloud-connection.md

Lines changed: 8 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,7 @@ author: maud-lv
66
ms.author: malev
77
ms.service: service-connector
88
ms.topic: quickstart
9-
ms.date: 04/13/2022
9+
ms.date: 10/31/2022
1010
ms.devlang: azurecli
1111
ms.custom: event-tier1-build-2022, devx-track-azurecli
1212
---
@@ -21,11 +21,11 @@ Service Connector lets you quickly connect compute services to cloud services, w
2121

2222
- An Azure subscription. [!INCLUDE [quickstarts-free-trial-note](../../includes/quickstarts-free-trial-note.md)]
2323

24-
- At least one application hosted by Azure Spring Apps in a [region supported by Service Connector](./concept-region-support.md). If you don't have one, [deploy your first application to Azure Spring Apps](../spring-apps/quickstart.md).
24+
- At least one application hosted by Azure Spring Apps in a [region supported by Service Connector](./concept-region-support.md). If you don't have one, [deploy your first application to Azure Spring Apps](../spring-apps/quickstart.md).
2525

2626
[!INCLUDE [azure-cli-prepare-your-environment-no-header.md](~/articles/reusable-content/azure-cli/azure-cli-prepare-your-environment-no-header.md)]
2727

28-
- Version 2.37.0 or higher of the Azure CLI must be installed. To upgrade to the latest version, run `az upgrade`. If using Azure Cloud Shell, the latest version is already installed.
28+
- Version 2.37.0 or higher of the Azure CLI. To upgrade to the latest version, run `az upgrade`. If using Azure Cloud Shell, the latest version is already installed.
2929

3030
- The Azure Spring Apps extension must be installed in the Azure CLI or the Cloud Shell. To install it, run `az extension add --name spring`.
3131

@@ -40,7 +40,6 @@ Service Connector lets you quickly connect compute services to cloud services, w
4040
> [!TIP]
4141
> You can check if the resource provider has already been registered by running the command `az provider show -n "Microsoft.ServiceLinker" --query registrationState`. If the output is `Registered`, then Service Connector has already been registered.
4242
43-
4443
1. Optionally, run the command [az spring connection list-support-types](/cli/azure/spring/connection#az-spring-connection-list-support-types) to get a list of supported target services for Azure Spring Apps.
4544
4645
```azurecli
@@ -52,11 +51,11 @@ Service Connector lets you quickly connect compute services to cloud services, w
5251
5352
## Create a service connection
5453
55-
You can create a connection from Azure Spring Apps using an access key or a managed identity.
54+
Create a connection from Azure Spring Apps using an access key or a managed identity.
5655
5756
### [Access key](#tab/Using-access-key)
5857
59-
1. Run the `az spring connection create` command to create a service connection between Azure Spring Apps and an Azure Blob Storage with an access key.
58+
1. Run the `az spring connection create` command to create a service connection between Azure Spring Apps and an Azure Blob Storage using an access key.
6059
6160
```azurecli
6261
az spring connection create storage-blob --secret
@@ -75,10 +74,10 @@ You can create a connection from Azure Spring Apps using an access key or a mana
7574
> [!TIP]
7675
> If you don't have a Blob Storage, you can run `az spring connection create storage-blob --new --secret` to provision a new Blob Storage and directly connect it to your application hosted by Azure Spring Apps using a connection string.
7776
78-
### [Managed Identity](#tab/Using-Managed-Identity)
77+
### [Managed identity](#tab/Using-Managed-Identity)
7978
8079
> [!IMPORTANT]
81-
> To use Managed Identity, you must have the permission to modify [role assignments in Microsoft Entra ID](../active-directory/managed-identities-azure-resources/howto-assign-access-portal.md). Without this permission, your connection creation will fail. Ask your subscription owner to grant you a role assignment permission or use an access key to create the connection.
80+
> To use a managed identity, you must have the permission to modify [role assignments in Microsoft Entra ID](../active-directory/managed-identities-azure-resources/howto-assign-access-portal.md). Without this permission, your connection creation will fail. Ask your subscription owner to grant you a role assignment permission or use an access key to create the connection.
8281
8382
1. Run the `az spring connection create` command to create a service connection to a Blob Storage with a system-assigned managed identity
8483
@@ -115,7 +114,7 @@ The output also displays the provisioning state of your connections: failed or s
115114

116115
## Next steps
117116

118-
Check the guides below for more information about Service Connector and Azure Spring Apps:
117+
Check the guides below for more information about Service Connector and Azure Spring Apps.
119118

120119
> [!div class="nextstepaction"]
121120
> [Tutorial: Azure Spring Apps + MySQL](./tutorial-java-spring-mysql.md)

articles/service-connector/quickstart-portal-container-apps.md

Lines changed: 14 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -1,20 +1,23 @@
11
---
22
title: Quickstart - Create a service connection in Container Apps from the Azure portal
3-
description: Quickstart showing how to create a service connection in Azure Container Apps from the Azure portal
3+
description: This quickstart shows how to create a service connection in Azure Container Apps from the Azure portal
44
author: maud-lv
55
ms.author: malev
66
ms.service: service-connector
77
ms.custom: event-tier1-build-2022
88
ms.topic: quickstart
9-
ms.date: 08/09/2022
9+
ms.date: 10/31/2023
1010

11-
#Customer intent: As an app developer, I want to connect a Container App to a storage account in the Azure portal using Service Connector.
11+
#Customer intent: As an app developer, I want to connect Azure Container Apps to a storage account in the Azure portal using Service Connector.
1212
---
1313

1414
# Quickstart: Create a service connection in Azure Container Apps from the Azure portal
1515

1616
This quickstart shows you how to connect Azure Container Apps to other Cloud resources using the Azure portal and Service Connector. Service Connector lets you quickly connect compute services to cloud services, while managing your connection's authentication and networking settings.
1717

18+
> [!NOTE]
19+
> For information on connecting resources using Azure CLI, see [Create a service connection in Container Apps with the Azure CLI](./quickstart-cli-container-apps.md).
20+
1821
> [!IMPORTANT]
1922
> This feature in Container Apps is currently in preview.
2023
> See the [Supplemental Terms of Use for Microsoft Azure Previews](https://azure.microsoft.com/support/legal/preview-supplemental-terms/) for legal terms that apply to Azure features that are in beta, preview, or otherwise not yet released into general availability.
@@ -31,9 +34,9 @@ Sign in to the Azure portal at [https://portal.azure.com/](https://portal.azure.
3134

3235
## Create a new service connection
3336

34-
You'll use Service Connector to create a new service connection in Container Apps.
37+
Use Service Connector to create a new service connection in Container Apps.
3538

36-
1. To create a new service connection in Container Apps, select the **Search resources, services and docs (G +/)** search bar at the top of the Azure portal, type *Container Apps* in the filter and select **Container Apps**.
39+
1. Select the **Search resources, services and docs (G +/)** search bar at the top of the Azure portal, type *Container Apps* in the filter and select **Container Apps**.
3740

3841
:::image type="content" source="./media/container-apps-quickstart/select-container-apps.png" alt-text="Screenshot of the Azure portal, selecting Container Apps.":::
3942

@@ -47,14 +50,12 @@ You'll use Service Connector to create a new service connection in Container App
4750

4851
| Setting | Example | Description |
4952
|---------------------|----------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
50-
| **Container** | *my-container* | The container of your container app. |
53+
| **Container** | *my-container-app* | The container of your container app. |
5154
| **Service type** | *Storage - Blob* | The type of service you're going to connect to your container. |
5255
| **Subscription** | *my-subscription* | The subscription that contains your target service (the service you want to connect to). The default value is the subscription that this container app is in. |
5356
| **Connection name** | *storageblob_700ae* | The connection name that identifies the connection between your container app and target service. Use the connection name provided by Service Connector or choose your own connection name. |
5457
| **Storage account** | *my-storage-account* | The target storage account you want to connect to. If you choose a different service type, select the corresponding target service instance. |
55-
| **Client type** | *.NET* | The application stack that works with the target service you selected. The default value is None, which will generate a list of configurations. If you know about the app stack or the client SDK in the container you selected, select the same app stack for the client type. |
56-
57-
:::image type="content" source="./media/container-apps-quickstart/basics.png" alt-text="Screenshot of the Azure portal, filling out the Basics tab.":::
58+
| **Client type** | *.NET* | The application stack that works with the target service you selected. The default value is None, which generates a list of configurations. If you know about the app stack or the client SDK in the container you selected, select the same app stack for the client type. |
5859

5960
1. Select **Next: Authentication** to choose an authentication method: system-assigned managed identity (SMI), user-assigned managed identity (UMI), connection string, or service principal.
6061

@@ -72,7 +73,7 @@ You'll use Service Connector to create a new service connection in Container App
7273
1. Select **Managed identities** and select **Create**
7374
1. Enter a subscription, resource group, region and instance name
7475
1. Select **Review + create** and the **Create**
75-
1. Once your managed identity has been deployed, go to your Service Connector tab, select **Previous** and then **Next** to refresh the form's data, and under **User-assigned managed identity**, select the identity you've created.
76+
1. Once your managed identity has been deployed, go to your Service Connector tab, select **Previous** and then **Next** to refresh the form's data, and under **User-assigned managed identity**, select the identity you created.
7677

7778
For more information, go to [create a user-assigned managed identity](../active-directory/managed-identities-azure-resources/how-manage-user-assigned-managed-identities.md?pivots=identity-mi-methods-azp).
7879

@@ -99,11 +100,11 @@ You'll use Service Connector to create a new service connection in Container App
99100

100101
## View service connections
101102

102-
1. Container Apps connections are displayed under **Settings > Service Connector**.
103+
1. Container Apps connections are displayed under **Settings > Service Connector (preview)**. Select **>** to expand the list and see the properties required by your application.
103104

104-
1. Select **>** to expand the list and see the environment variables required by your application.
105+
1. Select your connection and then **Validate** to prompt Service Connector to check your connection.
105106

106-
1. Select **Validate** check your connection status, and select **Learn more** to review the connection validation details.
107+
1. Select **Learn more** to review the connection validation details.
107108

108109
:::image type="content" source="./media/container-apps-quickstart/validation-result.png" alt-text="Screenshot of the Azure portal, get connection validation result.":::
109110

0 commit comments

Comments
 (0)