Managing API-driven pipelines#

API driven pipeline applications

On the Pipeline page, you need to create a pipeline to incorporate API driven applications.

API driven pipeline applications enable you to effectively populate the pipeline and move dots through the system solely through build and deployment uploads. The create build and upload deployment API commands are displayed in the UI and can be executed in a command terminal. Advantages of using these build and deployment APIs are for providing simplified endpoints for loading data and allowing you to integrate the pipeline with unsupported tools. The relationship between the APIs and the pipeline phases that are populated are detailed in the following table.

API	Pipeline phases
`builds/apiDriven`	Input
`deployments/apiDriven`	DEV, QA, PROD

To map an application environment to the pipeline on the Pipeline page, complete the following steps:
1. For the environment where you want to add the application, click Add app.
2. On the Add apps - Choose the apps window, in the Managed by list, select API Driven Application.
3. Click Save and a new Add apps - Choose the apps window is displayed for the API Driven Application.
4. In the Application name field, enter the name for the application.
  
  Note: The Managed by and Description fields are already populated with API Driven Application.
5. Click Save.
  
  The application is added to the stage.
To upload a build that will create a new version for that application, complete the following steps:
1. Click under the Input stage of the pipeline for the TEST API Driven Application application, used as an example and shown in the figure below.
  
  The Create a build through the API modal window will display a curl command, shown in the figure below, to interact with the TEST API Driven Application REST API.
  
  Note: The TEST API Driven Application is used as an example and shown above the Create a build through the API modal window.
2. Click to copy the curl command.
3. Paste the curl command in a text editor.
4. Edit the following user provided fields: <enter a user access key>, <enter a unique identifier>, <enter a version name>, and <enter a build URL>, and <enter a commit SHA>.
5. Copy the curl command.
6. Paste the curl command into a terminal or CI/CD automation scripts having network access to the <Velocity/Accelerate> server.
7. Execute the curl command.
  
  Note: Running these commands manually in a terminal are typically performed for several initial test runs. This method is not recommended for production use. For best practice, add the create build and upload deployment curl commands directly in the CI/CDs for automatic triggering.
Notify the pipeline of an Input version's deployment by completing the following steps:
1. Click under the DEV stage of the pipeline for the TEST API Driven Application application, used as an example and shown in the figure of the previous step.
  
  The Create a deployment through the API (DEV) modal window will display a curl command, shown in the figure below, to interact with the TEST API Driven Application REST API to upload a deployment to the aforementioned application.
  
  Note: The TEST API Driven Application is used as an example and shown in the figure of the previous step.
2. Click to copy the curl command.
3. Paste the curl command in a text editor.
4. Edit the following user provided fields: <enter a user access key>, <enter a unique identifier>, <enter a version name>, and <enter a deployment URL>.
5. Copy the curl command.
6. Paste the curl command into a terminal or CI/CD automation scripts having network access to the <Velocity/Accelerate> server.
7. Execute the curl command.
  
  Note: Running these commands manually in a terminal are typically performed for several initial test runs. This method is not recommended for production use. For best practice, add the create build and upload deployment curl commands directly in the CI/CDs for automatic triggering.