> For the complete documentation index, see [llms.txt](https://docs.coherent.global/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.coherent.global/ci-cd/how-to-deploy-with-azure-devops.md).
# How to: Deploy with Azure DevOps
Promotion of Spark services from one tenant to another using the [ImpEx APIs](/spark-apis/impex-apis.md) can be integrated with [Azure DevOps Pipelines](https://azure.microsoft.com/en-us/products/devops/pipelines) facilitated by [PowerShell](https://learn.microsoft.com/en-us/powershell/) scripting.
## Prerequisites
* [Client Credentials](/identity-and-access-management/client-credentials.md) configured in both the source and destination tenants with access to the source and destination targets.
* All referenced services must have a compiled [Neuron](/build-spark-services/neuron.md) WebAssembly module.
* Any destination folders need to already exist and be accessible with the provided authorization.
## Information flow
1. [Azure DevOps Pipelines](https://azure.microsoft.com/en-us/products/devops/pipelines) is used to execute the attached PowerShell script.
2. The [PowerShell](https://learn.microsoft.com/en-us/powershell/) script performs the following steps:
1. Acquires client access tokens for both the source and destination tenants via using [Client Credentials grant (OAuth 2.0)](/identity-and-access-management/client-credentials/client-credentials-grant-oauth-2.0.md).
2. Initiates the [Export](/spark-apis/impex-apis/export.md) API package generation job in the source tenant.
3. Checks the [Export](/spark-apis/impex-apis/export.md#get-export-status) API for the completed job.
4. Once completed, it downloads the package.
5. The package is then uploaded to the destination tenant and deployed using the [Import](/spark-apis/impex-apis/import.md) API.
{% file src="/files/GYOi3edjpy7ngi4jKkPh" %}
## PowerShell script parameters
The parameters for the PowerShell script are aligned with those from the [Export](/spark-apis/impex-apis/export.md) and [Import](/spark-apis/impex-apis/import.md) APIs. It is recommended to understand the capability there before defining the parameters of the script.
| Key | Value |
| ----------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `exportEndpoint` |
sourceKeycloakMetadataUri and destinationKeycloakMetadataUri
|
Source of the Keycloak OpenID endpoint configuration. environment}.coherent.global/auth/realms/{tenant}/protocol/openid-connect/token
|
|
sourceKeycloakClientId and destinationKeycloakClientId
|
The client ID for the source Keycloak client. Example: client-credentials
|
|
sourceKeycloakClientSecret and destinationKeycloakClientSecret
|
The client secret for the source Keycloak client. Example: 9Oh1nscDtPzMehwA3ejKJFAar3RRktHY
|
## Setup the pipeline in Azure DevOps
1. Read the article [Use a PowerShell script to customize your pipeline](https://learn.microsoft.com/en-us/azure/devops/pipelines/scripts/powershell?view=azure-devops\&tabs=yaml) and follow the appropriate instructions for your Azure instance.
2. Push the PowerShell script `ImpEx.ps1` to the root of the project repository.
3. Add the completed YAML code to the pipeline file.