Skip to content

Commit 16fa717

Browse files
authored
Merge pull request #159001 from MicrosoftDocs/master
merge master to live, 4 PM Sunday
2 parents 7f8fd92 + 0c293e1 commit 16fa717

File tree

71 files changed

+543
-598
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

71 files changed

+543
-598
lines changed

articles/connectors/apis-list.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -40,7 +40,7 @@ An *action* is an operation that follows the trigger and performs some kind of t
4040

4141
## Connector categories
4242

43-
In Logic Apps, most triggers and actions are available in either a *built-in* version or *managed connector* version. A small number of triggers and actions are available in both versions. The versions available depend on whether you create a multi-tenant logic app or a single-tenant logic app, which is currently available only in [Logic Apps Preview](../logic-apps/single-tenant-overview-compare.md).
43+
In Logic Apps, most triggers and actions are available in either a *built-in* version or *managed connector* version. A small number of triggers and actions are available in both versions. The versions available depend on whether you create a multi-tenant logic app or a single-tenant logic app, which is currently available only in [single-tenant Azure Logic Apps](../logic-apps/single-tenant-overview-compare.md).
4444

4545
[Built-in triggers and actions](built-in.md) run natively on the Logic Apps runtime, don't require creating connections, and perform these kinds of tasks:
4646

articles/connectors/connectors-create-api-mq.md

Lines changed: 9 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -7,7 +7,7 @@ author: ChristopherHouser
77
ms.author: chrishou
88
ms.reviewer: valthom, estfan, logicappspm
99
ms.topic: article
10-
ms.date: 04/26/2021
10+
ms.date: 05/25/2021
1111
tags: connectors
1212
---
1313

@@ -25,11 +25,9 @@ This connector includes a Microsoft MQ client that communicates with a remote MQ
2525

2626
## Available operations
2727

28-
The IBM MQ connector provides actions but no triggers.
28+
* Multi-tenant Azure Logic Apps: When you create a **Logic App (Consumption)** resource, you can connect to an MQ server only by using the *managed* MQ connector. This connector provides only actions, no triggers.
2929

30-
* Multi-tenant Azure Logic Apps: When you create a consumption-based logic app workflow, you can connect to an MQ server by using the *managed* MQ connector.
31-
32-
* Single-tenant Azure Logic Apps (preview): When you create a preview logic app workflow, you can connect to an MQ server by using either the managed MQ connector or the *built-in* MQ operations (preview).
30+
* Single-tenant Azure Logic Apps: When you create a single-tenant based logic app workflow, you can connect to an MQ server by using either the managed MQ connector, which includes *only* actions, or the *built-in* MQ operations, which includes triggers *and* actions.
3331

3432
For more information about the difference between a managed connector and built-in operations, review [key terms in Logic Apps](../logic-apps/logic-apps-overview.md#logic-app-concepts).
3533

@@ -44,11 +42,14 @@ The following list describes only some of the managed operations available for M
4442

4543
For all the managed connector operations and other technical information, such as properties, limits, and so on, review the [MQ connector's reference page](/connectors/mq/).
4644

47-
#### [Built-in (preview)](#tab/built-in)
45+
#### [Built-in](#tab/built-in)
4846

4947
The following list describes only some of the built-in operations available for MQ:
5048

51-
* Receive a single message or an array of messages from the MQ server. For multiple messages, you can specify the maximum number of messages to return per batch and the maximum batch size in KB.
49+
* When a message is available in a queue, take some action.
50+
* When one or more messages are received from a queue (auto-complete), take some action.
51+
* When one or more messages are received from a queue (peek-lock), take some action.
52+
* Receive a single message or an array of messages from a queue. For multiple messages, you can specify the maximum number of messages to return per batch and the maximum batch size in KB.
5253
* Send a single message or an array of messages to the MQ server.
5354

5455
These built-in MQ operations also have the following capabilities plus the benefits from all the other capabilities for logic apps in the [single-tenant Logic Apps service](../logic-apps/single-tenant-overview-compare.md):
@@ -121,7 +122,7 @@ When you add an MQ action for the first time, you're prompted to create a connec
121122

122123
1. When you're done, select **Create**.
123124

124-
#### [Built-in (preview)](#tab/built-in)
125+
#### [Built-in](#tab/built-in)
125126

126127
1. Provide the connection information for your MQ server.
127128

articles/logic-apps/create-single-tenant-workflows-azure-portal.md

Lines changed: 45 additions & 61 deletions
Large diffs are not rendered by default.

articles/logic-apps/create-single-tenant-workflows-visual-studio-code.md

Lines changed: 120 additions & 321 deletions
Large diffs are not rendered by default.

articles/logic-apps/devops-deployment-single-tenant-azure-logic-apps.md

Lines changed: 17 additions & 19 deletions
Original file line numberDiff line numberDiff line change
@@ -1,16 +1,16 @@
11
---
2-
title: DevOps deployment for single-tenant Azure Logic Apps (preview)
3-
description: Learn about DevOps deployment for single-tenant Azure Logic Apps (preview).
2+
title: DevOps deployment for single-tenant Azure Logic Apps
3+
description: Learn about DevOps deployment for single-tenant Azure Logic Apps.
44
services: logic-apps
55
ms.suite: integration
66
ms.reviewer: estfan, azla
77
ms.topic: conceptual
8-
ms.date: 05/10/2021
8+
ms.date: 05/25/2021
99

1010
# As a developer, I want to learn about DevOps deployment support for single-tenant Azure Logic Apps.
1111
---
1212

13-
# DevOps deployment for single-tenant Azure Logic Apps (preview)
13+
# DevOps deployment for single-tenant Azure Logic Apps
1414

1515
With the trend towards distributed and native cloud apps, organizations are dealing with more distributed components across more environments. To maintain control and consistency, you can automate your environments and deploy more components faster and more confidently by using DevOps tools and processes.
1616

@@ -20,9 +20,9 @@ This article provides an introduction and overview about the current continuous
2020

2121
## Single-tenant versus multi-tenant
2222

23-
In the original multi-tenant Azure Logic Apps, resource deployment is based on Azure Resource Manager (ARM) templates, which combine and handle resource provisioning for both logic apps and infrastructure. In single-tenant Azure Logic Apps, deployment becomes easier because you can use separate provisioning between apps and infrastructure.
23+
In the original *multi-tenant* Azure Logic Apps, resource deployment is based on Azure Resource Manager (ARM) templates, which combine and handle resource provisioning for both logic apps and infrastructure. In single-tenant Azure Logic Apps, deployment becomes easier because you can use separate provisioning between apps and infrastructure.
2424

25-
When you create logic apps using the **Logic App (Preview)** resource type, your workflows are powered by the redesigned Azure Logic Apps (Preview) runtime. This runtime uses the [Azure Functions extensibility model](../azure-functions/functions-bindings-register.md) extensibility and is [hosted as an extension on the Azure Functions runtime](https://techcommunity.microsoft.com/t5/integrations-on-azure/azure-logic-apps-running-anywhere-runtime-deep-dive/ba-p/1835564). This design provides portability, flexibility, and more performance for your logic apps plus other capabilities and benefits inherited from the Azure Functions platform and Azure App Service ecosystem.
25+
When you create logic apps using the **Logic App (Standard)** resource type, your workflows are powered by the redesigned single-tenant Azure Logic Apps runtime. This runtime uses the [Azure Functions extensibility model](../azure-functions/functions-bindings-register.md) extensibility and is [hosted as an extension on the Azure Functions runtime](https://techcommunity.microsoft.com/t5/integrations-on-azure/azure-logic-apps-running-anywhere-runtime-deep-dive/ba-p/1835564). This design provides portability, flexibility, and more performance for your logic apps plus other capabilities and benefits inherited from the Azure Functions platform and Azure App Service ecosystem.
2626

2727
For example, you can package the redesigned runtime and workflows together as part of your logic app. You can use generic steps or tasks that build, assemble, and zip your logic app resources into ready-to-deploy artifacts. To deploy your apps, copy the artifacts to the host environment and then start your apps to run your workflows. Or, integrate your artifacts into deployment pipelines using the tools and processes that you already know and use. For example, if your scenario requires containers, you can containerize your logic apps and integrate them into your existing pipelines.
2828

@@ -34,13 +34,13 @@ By using standard build and deploy options, you can focus on app development sep
3434

3535
## DevOps deployment capabilities
3636

37-
single-tenant Azure Logic Apps inherits many capabilities and benefits from the Azure Functions platform and Azure App Service ecosystem. These updates include a whole new deployment model and more ways to use DevOps for your logic app workflows.
37+
Single-tenant Azure Logic Apps inherits many capabilities and benefits from the Azure Functions platform and Azure App Service ecosystem. These updates include a whole new deployment model and more ways to use DevOps for your logic app workflows.
3838

3939
<a name="local-development-testing"></a>
4040

4141
### Local development and testing
4242

43-
When you use Visual Studio Code with the Azure Logic Apps (Preview) extension, you can locally develop, build, and run **Logic App (Preview)** workflows in your development environment without having to deploy to Azure. You can also run your workflows anywhere that Azure Functions can run. For example, if your scenario requires containers, you can containerize your logic apps and deploy as Docker containers.
43+
When you use Visual Studio Code with the Azure Logic Apps (Standard) extension, you can locally develop, build, and run single-tenant based logic app workflows in your development environment without having to deploy to Azure. You can also run your workflows anywhere that Azure Functions can run. For example, if your scenario requires containers, you can containerize your logic apps and deploy as containers.
4444

4545
This capability is a major improvement and provides a substantial benefit compared to the multi-tenant model, which requires you to develop against an existing and running resource in Azure.
4646

@@ -56,7 +56,7 @@ The single-tenant model gives you the capability to separate the concerns betwee
5656

5757
### Resource structure
5858

59-
Single-tenant Azure Logic Apps introduces a new resource structure where your logic app can host multiple workflows. This structure differs from the multi-tenant version where you have a 1:1 mapping between logic app resource and workflow. With this 1-to-many relationship, workflows in the same logic app can share and reuse other resources. Plus, these workflows also benefit from improved performance due to shared tenancy and proximity to each other.
59+
Single-tenant Azure Logic Apps introduces a new resource structure where your logic app can host multiple workflows. This structure differs from the multi-tenant model where you have a 1:1 mapping between logic app resource and workflow. With this 1-to-many relationship, workflows in the same logic app can share and reuse other resources. Plus, these workflows also benefit from improved performance due to shared tenancy and proximity to each other.
6060

6161
This resource structure looks and works similarly to Azure Functions where a function app can host many functions. If you're working in a logic app project within Visual Studio Code, your project folder and file structure looks like the following example:
6262

@@ -79,7 +79,6 @@ MyLogicAppProjectName
7979
| connections.json
8080
| host.json
8181
| local.settings.json
82-
| Dockerfile
8382
```
8483

8584
At your project's root level, you can find the following files and folders, along with other items depending on your project is extension bundle-based (Node.js), which is the default, or is NuGet package-based (.NET).
@@ -93,8 +92,7 @@ At your project's root level, you can find the following files and folders, alon
9392
| .funcignore | File | Review [Work with Azure Functions Core Tools](../azure-functions/functions-run-local.md) |
9493
| connections.json | File | Contains the metadata, endpoints, and keys for any managed connections and Azure functions that your workflows use. <p><p>**Important**: To use different connections and functions for each environment, make sure that you parameterize this **connections.json** file and update the endpoints. |
9594
| host.json | File | Contains runtime-specific configuration settings and values, for example, the default limits for the single-tenant Azure Logic Apps platform, logic apps, workflows, triggers, and actions. |
96-
| local.settings.json | File | Contains the local environment variables that provides the `appSettings` values to use for your logic app when running locally. |
97-
| Dockerfile | Folder | Contains one or more Dockerfiles to use for deploying the logic app as a container. |
95+
| local.settings.json | File | Contains the local environment variables that provide the `appSettings` values to use for your logic app when running locally. |
9896
||||
9997

10098
For example, to create custom built-in operations, you must have a NuGet based project, not an extension bundle-based project. A NuGet-based project includes a .bin folder that contains packages and other library files that your app needs, while a bundle-based project doesn't include this folder and files. For more information about converting your project to use NuGet, review [Enable built-connector authoring](create-stateful-stateless-workflows-visual-studio-code.md#enable-built-in-connector-authoring).
@@ -106,8 +104,8 @@ For more information and best practices about how to best organize workflows in
106104
### Container deployment
107105

108106
Single-tenant Azure Logic Apps supports deployment to containers, which means that you can containerize your logic app workflows and run them anywhere that containers can run. After you containerize your app, deployment works mostly the same as any other container you deploy and manage.
109-
110-
For examples that include Azure DevOps, review [CI/CD for Containers](https://azure.microsoft.com/solutions/architecture/cicd-for-containers/). For more information about containerizing logic apps and deploying to Docker, review [Deploy your logic app to a Docker container from Visual Studio Code](create-stateful-stateless-workflows-visual-studio-code.md#deploy-to-docker).
107+
108+
For examples that include Azure DevOps, review [CI/CD for Containers](https://azure.microsoft.com/solutions/architecture/cicd-for-containers/).
111109

112110
<a name="app-settings-parameters"></a>
113111

@@ -121,7 +119,7 @@ In single-tenant Azure Logic Apps, you can call and reference your environment v
121119

122120
## Managed connectors and built-in operations
123121

124-
The Azure Logic Apps ecosystem provides [hundreds of Microsoft-managed connectors](/connectors/connector-reference/connector-reference-logicapps-connectors) and built-in operations as part of a constantly growing collection that you can use in the single-tenant Azure Logic Apps service. The way that Microsoft maintains these connectors and built-in operations stays mostly the same in single-tenant Azure Logic Apps.
122+
The Azure Logic Apps ecosystem provides [hundreds of Microsoft-managed connectors](/connectors/connector-reference/connector-reference-logicapps-connectors) and built-in operations as part of a constantly growing collection that you can use in single-tenant Azure Logic Apps. The way that Microsoft maintains these connectors and built-in operations stays mostly the same in single-tenant Azure Logic Apps.
125123

126124
The most significant improvement is that the single-tenant service makes more popular managed connectors also available as built-in operations. For example, you can use built-in operations for Azure Service Bus, Azure Event Hubs, SQL, and others. Meanwhile, the managed connector versions are still available and continue to work.
127125

@@ -133,7 +131,7 @@ In Visual Studio Code, when you use the designer to develop or make changes to y
133131

134132
### Service provider connections
135133

136-
When you use a built-in operation for a service such as Azure Service Bus or Azure Event Hubs in the single-tenant Azure Logic Apps service, you create a service provider connection that runs in the same process as your workflow. This connection infrastructure is hosted and managed as part of your logic app, and your app settings store the connection strings for any service provider-based built-in operation that your workflows use.
134+
When you use a built-in operation for a service such as Azure Service Bus or Azure Event Hubs in single-tenant Azure Logic Apps, you create a service provider connection that runs in the same process as your workflow. This connection infrastructure is hosted and managed as part of your logic app, and your app settings store the connection strings for any service provider-based built-in operation that your workflows use.
137135

138136
In your logic app project, each workflow has a workflow.json file that contains the workflow's underlying JSON definition. This workflow definition then references the necessary connection strings in your project's connections.json file.
139137

@@ -210,7 +208,7 @@ To call functions created and hosted in Azure Functions, you use the built-in Az
210208

211209
## Authentication
212210

213-
In the single-tenant Azure Logic Apps service, the hosting model for logic app workflows is a single tenant where your workloads benefit from more isolation than in the multi-tenant version. Plus, the service runtime is portable, which means you can run your workflows anywhere that Azure Functions can run. Still, this design requires a way for logic apps to authenticate their identity so they can access the managed connector ecosystem in Azure. Your apps also need the correct permissions to run operations when using managed connections.
211+
In single-tenant Azure Logic Apps, the hosting model for logic app workflows is a single tenant where your workloads benefit from more isolation than in the multi-tenant model. Plus, the single-tenant Azure Logic Apps runtime is portable, which means you can run your workflows anywhere that Azure Functions can run. Still, this design requires a way for logic apps to authenticate their identity so they can access the managed connector ecosystem in Azure. Your apps also need the correct permissions to run operations when using managed connections.
214212

215213
By default, each single-tenant based logic app has an automatically enabled system-assigned managed identity. This identity differs from the authentication credentials or connection string used for creating a connection. At runtime, your logic app uses this identity to authenticate its connections through Azure access policies. If you disable this identity, connections won't work at runtime.
216214

@@ -240,9 +238,9 @@ For logic apps that run in your local development environment using Visual Studi
240238

241239
## Next steps
242240

243-
* [Set up DevOps deployment for single-tenant Azure Logic Apps (Preview)](set-up-devops-deployment-single-tenant-azure-logic-apps.md)
241+
* [Set up DevOps deployment for single-tenant Azure Logic Apps](set-up-devops-deployment-single-tenant-azure-logic-apps.md)
244242

245-
We'd like to hear about your experiences with the preview logic app resource type and preview single-tenant model!
243+
We'd like to hear about your experiences with the new logic app resource type and single-tenant model!
246244

247245
- For bugs or problems, [create your issues in GitHub](https://github.com/Azure/logicapps/issues).
248246
- For questions, requests, comments, and other feedback, [use this feedback form](https://aka.ms/logicappsdevops).

0 commit comments

Comments
 (0)