> 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/deployment-request.md).

# Deployment request

The [Options](/navigation/options.md#deployment-request) feature in Spark allows users to submit a deployment request that will initiate a Continuous Integration / Continuous Deployment process ([CI/CD](https://www.redhat.com/en/topics/devops/what-is-ci-cd)). The request triggers a downstream application to initiate the process.

In order to make use of this capability, the following functionalities are required:

* Webhooks must be enabled, see [Webhooks: Connect Spark with external systems to automate workflows](/integrations/webhooks-connect-spark-with-external-systems-to-automate-workflows.md).
* Downstream web application that is capable of accepting [`POST`](https://developer.mozilla.org/en-US/docs/Web/HTTP/Methods/POST) method requests.
* We recommend the use of the [ImpEx APIs](/spark-apis/impex-apis.md) that facilitate moving Spark services between environments and tenants.

## Implement a deployment to production

The diagram and steps below describe how the [Options](/navigation/options.md#deployment-request) feature can be used with the required functionalities as part of a [CI/CD](https://www.redhat.com/en/topics/devops/what-is-ci-cd) process to deploy a Spark service from the `UAT` to `PROD` environment.

<figure><img src="/files/zW8RoFjjQvLuaLjMXwP4" alt=""><figcaption></figcaption></figure>

1. User permissions to make a deployment request can be managed in [Options](/navigation/options.md#tenant-configuration).
2. In the UAT environment, a user submits an [Options](/navigation/options.md#deployment-request) by selecting the *Folder*, *Service*, and *Service version*.
3. Spark sends a notification to the downstream application via a `POST` method using a webhook.
4. The downstream application receives the notification and conducts the following processing on the `UAT` environment:
   1. Check that the notification relates to a deployment request by checking the request body for `"UserAction": "DeploymentRequest“`.
   2. Acquire an access token via the [Client Credentials](/identity-and-access-management/client-credentials.md) grant.
   3. Generate the export package using the [Export](/spark-apis/impex-apis/export.md) API, download and store it.
5. The downstream application then performs the remaining actions on the `PROD` environment.
   1. Acquire an access token via the [Client Credentials](/identity-and-access-management/client-credentials.md) grant.
   2. Publish the previously exported package using the [Import](/spark-apis/impex-apis/import.md) API.

## Demo video

This short video demonstrates the use of a Deployment request to copy a service version between environments.

{% file src="/files/Pe53cubNtcmVWH1HrxXE" %}