From e20ee6eeaa6ef20a2811c22d4f24937a3505fc8a Mon Sep 17 00:00:00 2001 From: Gary Date: Thu, 6 Mar 2025 15:51:53 -0800 Subject: [PATCH 1/2] squash --- ...anypoint-mq-connector-upgrade-migrate.adoc | 14 +- .../ROOT/pages/anypoint-mq-failover.adoc | 7 +- ...t-hubs-connector-studio-configuration.adoc | 253 ------------------ 3 files changed, 14 insertions(+), 260 deletions(-) delete mode 100644 azure-event-hubs/1.0/modules/ROOT/pages/azure-event-hubs-connector-studio-configuration.adoc diff --git a/anypoint-mq/4.x/modules/ROOT/pages/anypoint-mq-connector-upgrade-migrate.adoc b/anypoint-mq/4.x/modules/ROOT/pages/anypoint-mq-connector-upgrade-migrate.adoc index 0aea272f64..d2e6b4bc51 100644 --- a/anypoint-mq/4.x/modules/ROOT/pages/anypoint-mq-connector-upgrade-migrate.adoc +++ b/anypoint-mq/4.x/modules/ROOT/pages/anypoint-mq-connector-upgrade-migrate.adoc @@ -18,15 +18,19 @@ Anypoint MQ Connector 4.x includes support for these features: * Cross-Region Failover + -Anypoint MQ Connector for Mule 4 version 4.0.7 and later provides failover capability for standard queues. -+ +-- +Anypoint MQ Connector for Mule 4: + +** Version 4.0.7 and later provides failover capability for standard queues. +** Version 4.0.10 and later supports configuring custom fallback regions. + When enabled, if a Mule app can’t reach an Anypoint MQ server in a region, the connector switches to the fallback queue in the fallback region to publish and consume messages. -+ + For information, see: -+ + ** xref:mq::mq-failover.adoc[] ** xref:anypoint-mq-failover.adoc[] - +-- * Connected Apps + Anypoint MQ Connector for Mule 4 version 4.0.1 and later includes a new format for the *URL* field in the *Global Element Properties* page. diff --git a/anypoint-mq/4.x/modules/ROOT/pages/anypoint-mq-failover.adoc b/anypoint-mq/4.x/modules/ROOT/pages/anypoint-mq-failover.adoc index ac91d5f4e1..ecf5e1bbbc 100644 --- a/anypoint-mq/4.x/modules/ROOT/pages/anypoint-mq-failover.adoc +++ b/anypoint-mq/4.x/modules/ROOT/pages/anypoint-mq-failover.adoc @@ -1,7 +1,10 @@ = Configuring Cross-Region Failover in Your App -Anypoint MQ Connector for Mule 4 version 4.0.7 and later provides failover capability for standard queues. +You can configure failover by specifying a fallback region for standard queues using Anypoint Connector for Anypoint MQ (Anypoint MQ Connector) for Mule version 4.0.7 or later: + +* To use the failover feature with the default region, use connector version 4.0.7 or later. +* To configure a specific failover region, use connector version 4.0.10 or later. This feature is not enabled by default. Before using this feature, review xref:mq::mq-failover.adoc[]. @@ -15,7 +18,7 @@ To use the failover feature, do the following: * In your app: -.. Upgrade Anypoint MQ Connector to version 4.0.7 or later. +.. Upgrade Anypoint MQ Connector to version 4.0.7 or later (default fallback region) or 4.0.10 or later (custom fallback region). .. <> .. (Optional) <>. diff --git a/azure-event-hubs/1.0/modules/ROOT/pages/azure-event-hubs-connector-studio-configuration.adoc b/azure-event-hubs/1.0/modules/ROOT/pages/azure-event-hubs-connector-studio-configuration.adoc deleted file mode 100644 index 6b81cc0b34..0000000000 --- a/azure-event-hubs/1.0/modules/ROOT/pages/azure-event-hubs-connector-studio-configuration.adoc +++ /dev/null @@ -1,253 +0,0 @@ -= Using Anypoint Studio to Configure Azure Event Hubs Connector 1.0 - Mule 4 - -Anypoint Studio (Studio) editors help you design and update your Mule applications, properties, and configuration files. - -To add and configure a connector in Studio: - -. <>. -. <>. -. <>. -. <>. -. <>. -. <>. - -When you run the connector, you can view the app log to check for problems in real time, as described in <>. - -If you are new to configuring connectors in Studio, see xref:connectors::introduction/intro-config-use-studio.adoc[Use Studio to Configure a Connector]. If, after reading this topic, you need additional information about the connector fields, refer to the xref:azure-event-hubs-connector-reference.adoc[Azure Event Hub Connector Reference]. - -[[create-mule-project]] -== Create a Mule Project - -In Studio, create a new Mule project in which to add and configure the connector: - -. In Studio, select *File > New > Mule Project*. -. Enter a name for your Mule project and click *Finish*. - -[[add-connector-to-project]] -== Add the Connector to Your Mule Project - -Add Anypoint Connector for Azure Event Hubs Messaging (Azure Event Hubs Messaging Connector) to your Mule project to automatically populate the XML code with the connector's namespace and schema location and add the required dependencies to the project's `pom.xml` file: - -. In the *Mule Palette* view, click *(X) Search in Exchange*. -. In the *Add Dependencies to Project* window, type `azure event hubs messaging` in the search field. -. Click *Azure Event Hubs Connector* in *Available modules*. -. Click *Add*. -. Click *Finish*. - -Adding a connector to a Mule project in Studio does not make that connector available to other projects in your Studio workspace. - -[[configure-input-source]] -== Configure a Source - -A source initiates a flow when a specified condition is met. -You can configure one of these sources to use with Azure Event Hubs Connector: - -* HTTP Listener + -Initiates a flow each time it receives a request on the configured host and port -* Scheduler + -Initiates a flow when a time-based condition is met - -For example, to configure an HTTP Listener source, follow these steps: - -. In the *Mule Palette* view, select *HTTP > Listener*. -. Drag *Listener* to the Studio canvas. -. On the *Listener* configuration screen, optionally change the value of the *Display Name* field. -. Specify a value for the *Path* field. -. Click the plus sign (*+*) next to the *Connector configuration* field to configure a global element that can be used by all instances of the HTTP Listener source in the app. -. On the *General* tab, specify the connection information for the connector. -. On the *TLS* tab, optionally specify the TLS information for the connector. -. On the *Advanced* tab, optionally specify reconnection information, including a reconnection strategy. -. Click *Test Connection* to confirm that Mule can connect with the specified server. -. Click *OK*. - -[[add-connector-operation]] -== Add a Connector Operation to the Flow - -When you add a connector operation to your flow, you are specifying an action for that connector to perform. - -To add an operation for Azure Event Hubs Messaging Connector, follow these steps: - -. In the *Mule Palette* view, select *Azure Event Hubs* and then select the desired operation. -. Drag the operation onto the Studio canvas to the right of the source. - -[[configure-global-element]] -== Configure a Global Element for the Connector - -When you configure a connector, configure a global element that all instances of that connector in the app can use. Configuring a global element requires you to provide the authentication that the connector requires to access the target Azure Event Hubs system. -Azure Event Hubs Connector supports SAS authentication and Active Directory authentication. - -To configure the global element for Azure Event Hubs Connector, follow these steps: - -. Select the operation in the Studio canvas. -. In the configuration screen for the operation, click the plus sign (*+*) next to the *Connector configuration* field to access the global element configuration fields. -. On the *General* tab, in *Connection*, select the authentication method to configure: - -* <> -* <> - -[start=4] -. On the *Advanced* tab, optionally specify reconnection information, including a reconnection strategy. -. Click *Test Connection* to confirm that Mul runtime can connect with the specified server. -. Click *OK*. - -[[config-sas]] -=== Configure SAS Authentication - -Enter the following information on the *General* tab of the *Global Element Properties* screen to configure SAS authentication: - -[%header%autowidth.spread] -|=== -| Name | Type | Description | Default Value | Required -| Namespace a| String | Azure Event Hubs namespace name. | | x -| Shared Access Key Name a| String | Shared access key provided by Azure. | | x -| Shared Access Key a| String | Shared access key value provided by Azure. | | x -| Event Hub Name a| String | Azure Event Hub name. | | x -| Share Connection a| Boolean | Toggles the builder to use the same connection for producers or consumers. | false | -| Checkpoint Store Type a| One of: - -* <> -* <> | Selects the Azure Blob Storage connection. | | -| Reconnection a| Reconnection | Configures a reconnection strategy to use when the connector operation fails to connect to an external server. | | -|=== - -[[config-active]] -=== Configure Active Directory Authentication - -Enter the following information on the *General* tab of the *Global Element Properties* screen to configure Active Directory authentication. - -Using this authentication type enables you to configure *Token Credential Properties* or *Use default credentials*. - -[%header%autowidth.spread] -|=== -| Name | Type | Description | Default Value | Required -| Token Credential Properties a| <> | Acquires a token via service principal authentication. | | -| Use Azure Default Credential a| Boolean | Use the DefaultAzureCredentials mechanism. | false | -| Namespace a| String | Azure Event Hubs namespace name. | | x -| Authority Host a| String | Specifies the Azure Active Directory host. Defaults to https://login.microsoftonline.com/ | | -| Event Hub Name a| String | Event Hub name. | | x -| Share Connection a| Boolean | Toggles the builder to use the same connection for producers or consumers. | false | -| Checkpoint Store Type a| One of: - -* <> -* <> | Select the checkpointing connection provider. | | -| Reconnection a| Reconnection | Configures a reconnection strategy to use when a connector operation fails to connect to an external server. | | -|=== - -[[AzureBlobStorageSasAuthentication]] -=== Configure Azure Blob Storage SAS Authentication - -The following table shows the fields for configuring *Azure blob storage sas authentication*. - -[%header,cols="20s,25a,30a,15a,10a"] -|=== -| Field | Type | Description | Default Value | Required -| Container Name a| String | Container name. | | x -| Account Name a| String | Account name of the Azure account. | | x -| Account Key a| String | Account key of the Azure account. | | x -|=== - -[[AzureBlobStorageActiveDirectoryAuthentication]] -=== Configure Azure Blob Storage Active Directory Authentication - -The following table shows the fields to configure *Azure blob storage active directory authentication*. - -[%header,cols="20s,25a,30a,15a,10a"] -|=== -| Field | Type | Description | Default Value | Required -| Token Credential Properties a| <> | Acquires a token via service principal authentication. | | -| Use Azure Default Credential a| Boolean | If you set this flag to `true`, DefaultAzureCredential Class(Azure.Identity) is created to get a token to authenticate. | false | -| Container Name a| String | Container name. | | x -| Account Name a| String | Account name of the Azure account. | | x -| Authority Host a| String |Specifies the Azure active directory host. Defaults to https://login.microsoftonline.com/ | | -|=== - -[[TokenCredentialProperties]] -=== Configure Token Credential Properties - -The following table shows the fields for configuring *Token credentials properties*. - -[%header,cols="20s,25a,30a,15a,10a"] -|=== -| Field | Type | Description | Default Value | Required -| Tenant Id a| String | Tenant ID. | | -| Client Id a| String | Client ID. | | -| Client Secret a| String | Client secret. | | -|=== - -=== Configuration Examples - -The following example shows the configuration for *Sas Authentication* with *Azure blob storage sas authentication* in Studio: - -image::aeh-sas.png[Configuring azure blob storage SAS authentication] - -In the *Configuration XML* editor, the `azure-eventhubs:sas-authentication-connection` and `azure-eventhubs:azure-blob-storage-sas-authentication` configurations look like this: - -[source,xml,linenums] ----- - - - - - - - ----- - -The following example shows the configuration for *Active directory authentication* with *Azure blob storage sas authentication* and *Token credentials properties* in Studio: - -image::aeh-active-directory-client.png[Configuring active directory authentication with client credentials] - -In the *Configuration XML* editor, the `azure-eventhubs:active-directory-authentication-connection`, `azure-eventhubs:azure-blob-storage-sas-authentication`, and `azure-eventhubs:token-credential-properties` configurations look like this: - -[source,xml,linenums] ----- - - - - - - - - ----- - -The following example shows the configuration for *Active directory authentication* with *Azure blob storage active directory authentication* and *Use azure default credentials* in Studio: - -image::aeh-active-directory-default-client.png[Configuring active directory authentication with default client credentials] - -In the *Configuration XML* editor, the `azure-eventhubs:active-directory-authentication-connection`, `azure-eventhubs:azure-blob-storage-sas-authentication` , and `useAzureDefaultCredential` configurations look like this: - -[source,xml,linenums] ----- - - - - - - - - - ----- - -[[configure-other-fields]] -== Configure Additional Connector Fields - -After you configure a global element for Azure Event Hubs Connector, configure the other required fields for the connector. The required fields vary depending on which connector operation you use. - -[[view-app-log]] -== View the App Log - -To check for problems, you can view the app log as follows: - -* If you’re running the app from Anypoint Platform, the app log output is visible in the Anypoint Studio console window. -* If you’re running the app using Mule from the command line, the app log output is visible in your OS console. - -Unless the log file path is customized in the app’s log file (`log4j2.xml`), you can also view the app log in the default location `MULE_HOME/logs/.log`. - -== See Also - -* xref:connectors::introduction/introduction-to-anypoint-connectors.adoc[Introduction to Anypoint Connectors] -* xref:connectors::introduction/intro-config-use-studio.adoc[Use Studio to Configure a Connector] -* xref:azure-event-hubs-connector-reference.adoc[Azure Event Hubs Messaging Reference] -* https://help.mulesoft.com[MuleSoft Help Center] \ No newline at end of file From b01e8ef3fd411a1025262fc350d2c1b1d7d26b10 Mon Sep 17 00:00:00 2001 From: Gary Date: Thu, 6 Mar 2025 15:53:02 -0800 Subject: [PATCH 2/2] add back config file --- ...t-hubs-connector-studio-configuration.adoc | 253 ++++++++++++++++++ 1 file changed, 253 insertions(+) create mode 100644 azure-event-hubs/1.0/modules/ROOT/pages/azure-event-hubs-connector-studio-configuration.adoc diff --git a/azure-event-hubs/1.0/modules/ROOT/pages/azure-event-hubs-connector-studio-configuration.adoc b/azure-event-hubs/1.0/modules/ROOT/pages/azure-event-hubs-connector-studio-configuration.adoc new file mode 100644 index 0000000000..6b81cc0b34 --- /dev/null +++ b/azure-event-hubs/1.0/modules/ROOT/pages/azure-event-hubs-connector-studio-configuration.adoc @@ -0,0 +1,253 @@ += Using Anypoint Studio to Configure Azure Event Hubs Connector 1.0 - Mule 4 + +Anypoint Studio (Studio) editors help you design and update your Mule applications, properties, and configuration files. + +To add and configure a connector in Studio: + +. <>. +. <>. +. <>. +. <>. +. <>. +. <>. + +When you run the connector, you can view the app log to check for problems in real time, as described in <>. + +If you are new to configuring connectors in Studio, see xref:connectors::introduction/intro-config-use-studio.adoc[Use Studio to Configure a Connector]. If, after reading this topic, you need additional information about the connector fields, refer to the xref:azure-event-hubs-connector-reference.adoc[Azure Event Hub Connector Reference]. + +[[create-mule-project]] +== Create a Mule Project + +In Studio, create a new Mule project in which to add and configure the connector: + +. In Studio, select *File > New > Mule Project*. +. Enter a name for your Mule project and click *Finish*. + +[[add-connector-to-project]] +== Add the Connector to Your Mule Project + +Add Anypoint Connector for Azure Event Hubs Messaging (Azure Event Hubs Messaging Connector) to your Mule project to automatically populate the XML code with the connector's namespace and schema location and add the required dependencies to the project's `pom.xml` file: + +. In the *Mule Palette* view, click *(X) Search in Exchange*. +. In the *Add Dependencies to Project* window, type `azure event hubs messaging` in the search field. +. Click *Azure Event Hubs Connector* in *Available modules*. +. Click *Add*. +. Click *Finish*. + +Adding a connector to a Mule project in Studio does not make that connector available to other projects in your Studio workspace. + +[[configure-input-source]] +== Configure a Source + +A source initiates a flow when a specified condition is met. +You can configure one of these sources to use with Azure Event Hubs Connector: + +* HTTP Listener + +Initiates a flow each time it receives a request on the configured host and port +* Scheduler + +Initiates a flow when a time-based condition is met + +For example, to configure an HTTP Listener source, follow these steps: + +. In the *Mule Palette* view, select *HTTP > Listener*. +. Drag *Listener* to the Studio canvas. +. On the *Listener* configuration screen, optionally change the value of the *Display Name* field. +. Specify a value for the *Path* field. +. Click the plus sign (*+*) next to the *Connector configuration* field to configure a global element that can be used by all instances of the HTTP Listener source in the app. +. On the *General* tab, specify the connection information for the connector. +. On the *TLS* tab, optionally specify the TLS information for the connector. +. On the *Advanced* tab, optionally specify reconnection information, including a reconnection strategy. +. Click *Test Connection* to confirm that Mule can connect with the specified server. +. Click *OK*. + +[[add-connector-operation]] +== Add a Connector Operation to the Flow + +When you add a connector operation to your flow, you are specifying an action for that connector to perform. + +To add an operation for Azure Event Hubs Messaging Connector, follow these steps: + +. In the *Mule Palette* view, select *Azure Event Hubs* and then select the desired operation. +. Drag the operation onto the Studio canvas to the right of the source. + +[[configure-global-element]] +== Configure a Global Element for the Connector + +When you configure a connector, configure a global element that all instances of that connector in the app can use. Configuring a global element requires you to provide the authentication that the connector requires to access the target Azure Event Hubs system. +Azure Event Hubs Connector supports SAS authentication and Active Directory authentication. + +To configure the global element for Azure Event Hubs Connector, follow these steps: + +. Select the operation in the Studio canvas. +. In the configuration screen for the operation, click the plus sign (*+*) next to the *Connector configuration* field to access the global element configuration fields. +. On the *General* tab, in *Connection*, select the authentication method to configure: + +* <> +* <> + +[start=4] +. On the *Advanced* tab, optionally specify reconnection information, including a reconnection strategy. +. Click *Test Connection* to confirm that Mul runtime can connect with the specified server. +. Click *OK*. + +[[config-sas]] +=== Configure SAS Authentication + +Enter the following information on the *General* tab of the *Global Element Properties* screen to configure SAS authentication: + +[%header%autowidth.spread] +|=== +| Name | Type | Description | Default Value | Required +| Namespace a| String | Azure Event Hubs namespace name. | | x +| Shared Access Key Name a| String | Shared access key provided by Azure. | | x +| Shared Access Key a| String | Shared access key value provided by Azure. | | x +| Event Hub Name a| String | Azure Event Hub name. | | x +| Share Connection a| Boolean | Toggles the builder to use the same connection for producers or consumers. | false | +| Checkpoint Store Type a| One of: + +* <> +* <> | Selects the Azure Blob Storage connection. | | +| Reconnection a| Reconnection | Configures a reconnection strategy to use when the connector operation fails to connect to an external server. | | +|=== + +[[config-active]] +=== Configure Active Directory Authentication + +Enter the following information on the *General* tab of the *Global Element Properties* screen to configure Active Directory authentication. + +Using this authentication type enables you to configure *Token Credential Properties* or *Use default credentials*. + +[%header%autowidth.spread] +|=== +| Name | Type | Description | Default Value | Required +| Token Credential Properties a| <> | Acquires a token via service principal authentication. | | +| Use Azure Default Credential a| Boolean | Use the DefaultAzureCredentials mechanism. | false | +| Namespace a| String | Azure Event Hubs namespace name. | | x +| Authority Host a| String | Specifies the Azure Active Directory host. Defaults to https://login.microsoftonline.com/ | | +| Event Hub Name a| String | Event Hub name. | | x +| Share Connection a| Boolean | Toggles the builder to use the same connection for producers or consumers. | false | +| Checkpoint Store Type a| One of: + +* <> +* <> | Select the checkpointing connection provider. | | +| Reconnection a| Reconnection | Configures a reconnection strategy to use when a connector operation fails to connect to an external server. | | +|=== + +[[AzureBlobStorageSasAuthentication]] +=== Configure Azure Blob Storage SAS Authentication + +The following table shows the fields for configuring *Azure blob storage sas authentication*. + +[%header,cols="20s,25a,30a,15a,10a"] +|=== +| Field | Type | Description | Default Value | Required +| Container Name a| String | Container name. | | x +| Account Name a| String | Account name of the Azure account. | | x +| Account Key a| String | Account key of the Azure account. | | x +|=== + +[[AzureBlobStorageActiveDirectoryAuthentication]] +=== Configure Azure Blob Storage Active Directory Authentication + +The following table shows the fields to configure *Azure blob storage active directory authentication*. + +[%header,cols="20s,25a,30a,15a,10a"] +|=== +| Field | Type | Description | Default Value | Required +| Token Credential Properties a| <> | Acquires a token via service principal authentication. | | +| Use Azure Default Credential a| Boolean | If you set this flag to `true`, DefaultAzureCredential Class(Azure.Identity) is created to get a token to authenticate. | false | +| Container Name a| String | Container name. | | x +| Account Name a| String | Account name of the Azure account. | | x +| Authority Host a| String |Specifies the Azure active directory host. Defaults to https://login.microsoftonline.com/ | | +|=== + +[[TokenCredentialProperties]] +=== Configure Token Credential Properties + +The following table shows the fields for configuring *Token credentials properties*. + +[%header,cols="20s,25a,30a,15a,10a"] +|=== +| Field | Type | Description | Default Value | Required +| Tenant Id a| String | Tenant ID. | | +| Client Id a| String | Client ID. | | +| Client Secret a| String | Client secret. | | +|=== + +=== Configuration Examples + +The following example shows the configuration for *Sas Authentication* with *Azure blob storage sas authentication* in Studio: + +image::aeh-sas.png[Configuring azure blob storage SAS authentication] + +In the *Configuration XML* editor, the `azure-eventhubs:sas-authentication-connection` and `azure-eventhubs:azure-blob-storage-sas-authentication` configurations look like this: + +[source,xml,linenums] +---- + + + + + + + +---- + +The following example shows the configuration for *Active directory authentication* with *Azure blob storage sas authentication* and *Token credentials properties* in Studio: + +image::aeh-active-directory-client.png[Configuring active directory authentication with client credentials] + +In the *Configuration XML* editor, the `azure-eventhubs:active-directory-authentication-connection`, `azure-eventhubs:azure-blob-storage-sas-authentication`, and `azure-eventhubs:token-credential-properties` configurations look like this: + +[source,xml,linenums] +---- + + + + + + + + +---- + +The following example shows the configuration for *Active directory authentication* with *Azure blob storage active directory authentication* and *Use azure default credentials* in Studio: + +image::aeh-active-directory-default-client.png[Configuring active directory authentication with default client credentials] + +In the *Configuration XML* editor, the `azure-eventhubs:active-directory-authentication-connection`, `azure-eventhubs:azure-blob-storage-sas-authentication` , and `useAzureDefaultCredential` configurations look like this: + +[source,xml,linenums] +---- + + + + + + + + + +---- + +[[configure-other-fields]] +== Configure Additional Connector Fields + +After you configure a global element for Azure Event Hubs Connector, configure the other required fields for the connector. The required fields vary depending on which connector operation you use. + +[[view-app-log]] +== View the App Log + +To check for problems, you can view the app log as follows: + +* If you’re running the app from Anypoint Platform, the app log output is visible in the Anypoint Studio console window. +* If you’re running the app using Mule from the command line, the app log output is visible in your OS console. + +Unless the log file path is customized in the app’s log file (`log4j2.xml`), you can also view the app log in the default location `MULE_HOME/logs/.log`. + +== See Also + +* xref:connectors::introduction/introduction-to-anypoint-connectors.adoc[Introduction to Anypoint Connectors] +* xref:connectors::introduction/intro-config-use-studio.adoc[Use Studio to Configure a Connector] +* xref:azure-event-hubs-connector-reference.adoc[Azure Event Hubs Messaging Reference] +* https://help.mulesoft.com[MuleSoft Help Center] \ No newline at end of file