DROPS Integration

This extension provides Import and Deploy tasks to integrate with DROPS Release.

DROPS is a single solution to orchestrate the deployment of your applications across data center, hybrid, and multi-cloud infrastructures.

DROPS orchestrates a continuous value stream from business owner to end-user, with release visibility and control across all teams, technologies, and tools.

Unlike other solutions on the market, DROPS manages releases at the ‘application’ level, deploying functions, rather than just technical components. This makes DROPS intuitive and easy to use, allowing development and operations teams to work closely together to increase deployment frequency and respond smoothly to the demands of the business while guaranteeing service continuity in production.

Thanks to a powerful ‘platform abstraction’ layer, DROPS manages releases across multiple platforms such as Windows, UNIX, Linux, IBM i and also private, public, hybrid and multi-cloud environments.

The DROPS for Azure DevOps guide provides all the required documentation for usiing these tasks.

Available tasks

This Azure DevOps Extension provides the following tasks

• DROPS Import Task
• DROPS Deploy Task

How to use these tasks

After installing the extension, you can add one (or more) of the tasks to a new or existing release definition

Add a DROPS service connection

Before using any Impot or Deploy tasks, yau have to configure a DROPS Server Connection in the Project Settings, section Service Connection.

Be aware that you will need the target DROPS Server public key to be able the use a secured connection.

Field Description

Server URL (required)

• Enter the DROPS server URL including the port number
• Note that the server must be the one used in the certificate

Server Key

• The DROPS Server Certificate in .pem format

Accept untrusted SSL Certificates

• Cheks this box if you want to allow the DROPS clients to accept self-signed SSL server certificates without installing them into the Azure DevOps service role and/or Build Agent computers.

Username (required)

• The name of the user used to connect the DROPS Server

Password (required)

• The password of the user used to connect the DROPS Server

DROPS Import Task

The DROPS Import task is used to import heterogeneous applications artifacts into the DROPS Release Artifacts Repository.

Input Parameters

Commons Input Parameters

DROPS Server (required)

• The name of the DROPS Server Connection

Application Code (required)

• The code of the application that owns the target version.

Create Release

• Indicates if a new version should be created if it does not exist

Release Number

• Available only if Create Release is false. The Number of the release in which the artifacts must be imported

Increment Part

• The Release Number part that will be incremented while the release creation|

Release Description

• The release description. If you use an exiting release, its dscription will be updated

Reset Release

• Indicates if the target release should be resetted before import

Display Execution Log

• Indicates if the execution log entries should be displayed

Component Options Section

Component Filters

• The type of filter you want to appply. There are 4 available values:

1. No Filter: will execute the Import using the default definition of the application
2. File: will execute the Import filtering the component/strategy/external version based on the content on the file passed as parameter
3. Filtered: will execute the Import filtering the component/strategy/external version based on the content of the *** Filter Component field
4. Azure DevOps: will execute the Import using only the strategy of components that has been defined uising the AZURE-PIPELINES Strategy.

File Path

• Only if the filter type is File. The absolute name of the file name that contains the component filters

Filtered Component

• Only if the filter type is Filtered

• A YAML description of the component filter that needs to be applied

components:
- code: <The Component Code #1>
  strategy: <The strategy code of the component #i>
  externalVersion: <The source external version>
  ...
- code: <The Component Code #n>
  strategy: <The strategy code of the component #j>
  externalVersion: <The source external version>

Execution Process Description

1. Prepare the DROPS server Connection
2. Search for an Application with the defined code
   • IF no application found THEN Abort the task
3. Manage the release
   • IF the release creation has been requested THEN
     • Request for a release creation using the defined Increment part
     • IF the creation failed THEN
       • Abort the task
     • ELSE
       • Use this newly created release as the target release
     • ENDIF
   • ELSE
     • Retrieve the release of the application based on its Release Number
     • IF a release has been found THEN
       • Update its description
     • ELSE
       • Abort the task
     • ENDIF
   • ENDIF
4. Create the Import Process Instance
   • IF the creation failed THEN Abort the task
5. Manage the Component Options
   • IF option == "Filtered" THEN
     • parse the YAML Definition
     • IF the YAML Definition is correct THEN FOR EACH different filter entries *Add a component filter to the import process for each entry found ENDFOR
     • ELSE
       • Abort the task
     • ENDIF
   • ELSE IF option == "Azure DevOps" THEN
     • Search for components with a AZURE-PIPELINES Strategy
     • IF no component found THEN
       • • Abort the task
     • ELSE
       • FOR each component
         • Add a component filter to the import process
       • ENDFOR ENDIF
   • ENDIF
6. Execute the Import Process Instance
7. Display the execution Status and Result.
8. Manage the Execution Log Display
   • IF the display Execution Log Option has been set to true THEN
     • Display the execution Log
   • ENDIF

DROPS Deploy Task

The DROPS Deploy task is used to deploy Application's Releases on the organization environments

Input Parameters

DROPS Server (required)

• The name of the DROPS Server Connection

Application Code (required)

• The code of the application that owns the target version.

Release Number

• The Number of the release taht be be deployed

Environment Code

• The code of the environment on which the release must be deployed

Deployment Process

• The code of the process used to deploy the release on the environment

Transaction ID

• The ID of the transaction linked to the Deployment Process Instance

Execution Process Description

1. Prepare the DROPS server Connection
2. Search for an Application with the defined code
   • IF no application found THEN Abort the task
3. Search for a release with the defined release number AND linked to the application
   • IF no release has been found THEN Abort the task
4. Search for an environment the defined code
   • IF no Environment found THEN Abort the task
5. Search for Deployment Process with the defined code AND linked with the Application AND with the Environment
   • IF no Deployment Process found THEN Abort the task
6. Create the Deployment Process Instance
   • IF the creation failed THEN Abort the task
7. Execute the Deployment Process Instance
8. Display the execution Status and Result.
9. Manage the Execution Log Display
   • IF the display Execution Log Option has been set to true THEN
     • Display the execution Log
   • ENDIF