Create a Value Stream and add UrbanCode Deploy Applications to a Pipeline

Update UrbanCode Velocity (UCV) Team-Based Security

Before you try to add your IBM UrbanCode Deploy (now IBM DevOps Deploy) applications to a pipeline in UrbanCode Velocity (now DevOps Velocity), you will need to check your team-based security in UrbanCode Velocity (UCV).   If the email address for your “admin” users in UrbanCode Deploy (UCD) and UCV do not share the same email address, you will need to add the email address associated with your UCV admin user to the “teams” in UCD that you have setup for your applications.   If you do not do this, you will not be able to add your applications.   Follow these steps to check this:

1. Click on the gear icon at the top right to navigate to Settings page
2. Click the “Authorization” pulldown in the left pane (as shown above) and then select "Teams".
3. You will see the teams in both UCV and UCD as shown below (e.g. WebSphere Team comes from my personal UCD Server):
4. Add your UCV admin user to each of your IBM UrbanCode Deploy teams as shown in this example.   I started with the team "GitLab" and then clicked the "Add member" button to add the UCV admin user email address (e.g. admin@admin.com) to the team as shown below:
5. You do not have to give the admin@admin.com member any of the roles as shown below.   Click Save.
6. Please repeat these steps for all of your "teams" in IBM UrbanCode Deploy.   In my case, I added the admin@admin.com user to the "WebSphere Team", "Mulesoft" and "System Team".

Create a Value Stream and Pipeline

Use the following steps to create a value stream and setup a pipeline that integrates with UrbanCode Deploy:

1. Click on the Value Streams tab at the top of the page.
2. Click the "Add new value stream" button at the top right.
3. Enter the name of the stream, a description, and the Team to associate the value stream with.
4. Click Save
5. Click on the "Pipeline" sub-tab at the top right of the page as shown below:
6. Click the "Add application" button as shown below:
7. In the "Add app - Choose the app" dialog that appears, select "UrbanCode Deploy" from the "Managed by" pulldown list as shown below:
8. You can see the list of UrbanCode Deploy applications in the list to choose from as shown above
9. Select your application.  In my case, I selected "PlantsByWebSphere" as shown below:
10. Click the Next button
11. In the "Add app - Choose the processes" dialog, select one or more processes that you want to leverage in your pipeline as shown below:
12. Click Save
13. You will then see your application in the pipeline view as shown below:
14. Repeat this process to add additional applications

Mapping UCD Environments to your Pipeline
When you are finished adding your applications to the pipeline, you will then need to map the target environments (e.g. DEV, QA, and PROD) to the corresponding target environments.   To do this, follow these example steps:

     1. Click the "+" icon as shown below for a given application

     2. In the "Map app environments to logical environment" dialog, select your corresponding UCD environment as shown below:

    
     3.  Click Save
     4.  The pipeline will update as shown below:

     5.  Repeat this process for all your target environments as shown below:

I hope you found this blog helpful to assist with the initial setup of a pipeline using IBM UrbanCode Deploy applications.   Look out for future blog posts with more tips and tricks.

#UrbanCodeDeploy