Hand-On Lab: CA Release Automation Rapid Development Kit and SDK

Hand-On Lab:
CA Release Automation Rapid
Development Kit and SDK
Walter Guerrero
DevOps: Continuous Delivery
CA technologies
CA Release Automation Rapid Development Kit & SDK
DO4X210L

2 © 2015 CA. ALL RIGHTS RESERVED.@CAWORLD #CAWORLD
© 2015 CA. All rights reserved. All trademarks referenced herein belong to their respective companies.
The content provided in this CA World 2015 presentation is intended for informational purposes only and does not form any type of
warranty. The information provided by a CA partner and/or CA customer has not been reviewed for accuracy by CA.
For Informational Purposes Only
Terms of this Presentation

Abstract
A key component of CA Release Automation's power is its ability
to orchestrate your tool chain. What do you do if there isn't an
existing action pack or plugin for one of your tools? Learn how
to quickly build the integrations you need to get you where you
want to go. This is both a presentation and hands-on session
where you will learn how to create action packs for use with
CA Release Automation. During this session, you will receive an
introduction to the RDK/SDK, then perform a hands-on exercise
where you will use the RDK/SDK environment and build an
action pack using scripts, command line and Restful API calls.
Walter
Guerrero
CA technologies
Engineering Svcs
Architect

Agenda
INTRODUCTION TO ACTION PACKS
INTRODUCTION TO THE RDK/SDK
QUESTIONS AND ANSWERS
LAB WALK THROUGH
INTRODUCTION TO LAB ENVIRONMENT
HANDS ON LAB
1
2
3
4
5
6

What is an Action Pack?
 A collection of workflow activities that perform an atomic
operation against an external system
 Typically action packs are integrations to 3rd party systems
 Typically CRUD operations
 Existing actions packs – IE – Websphere, WebLogic, Jboss,
Apache SVN
 Over 1500 actions already built

What is the Rapid Development Kit (RDK)?

What is the Rapid Development Kit (RDK)?
 Complementary tool to CA Release Automation
 Enables non-programmers to easily create action packs
 Supports command-line, scripts, and restful APIs
 Generates ready-to-use action packs with support for
Windows and Linux
 Generates action pack documentation template
RDK

Creating an Action Pack
 Identify the actions to create
 Understand the integrations – scripts/rest calls/cmd line
 Determine
– Expected inputs
– Expected outputs
– Expected results and error conditions
RDK

System Requirements and Installation
RDK
 JDK 7 (64bit)
 Tomcat 7 (64bit)
 Windows and Linux
installers available
 2 part installer: Main
installer launches 3rd
party component
installer
 Installer checks for JDK
and prompts for Tomcat
installation folder
 Download from CA
support site

Installer checks for JDK and prompts for Tomcat installation folder
Download from CA support site
Action Types
CLI
 Runs any existing
command or script
that accepts command
line arguments for
which an interpreter
exists.
 Similar to running
command or script
with existing RA Run
Command Line action
SCRIPT
 Runs a cmd.exe,
PowerShell or Bash
script
 Supports inline
script editing and
variable substitution
RESTful
 Performs Get, Post,
Put, etc. operations
against provided URI

Publish
High Level Workflow
Action Pack Properties
Add Action: Select API
Type
Copy action and
repeat n times
Action Properties
Execution Results and
Error Messages
Output Parameters and
Filtering
Execution Payload and
Map Input Parameters
Input Parameters

What is the Software Development Kit
(SDK)?

What is the Software Development Kit (SDK)?
 Creation of custom actions based on customer needs
 Provides support for HTML tags in the action input name
 Provides action and parameter descriptors
 Supports command-line, scripts, restful APIs, 3rd party API, SOAP API calls
 Generates ready-to-use action packs with support for Windows and Linux
 JAVA based and an Eclipse plug-in
SDK

Creating an Action Pack
 Identify the actions to create
 Extract SDK components to Eclipse
 Create custom action in Eclipse
 Determine
– Expected inputs
– Expected outputs
– Expected results and error conditions
SDK

System Requirements and Installation
SDK
 JDK 7 (64bit)
 Eclipse 3.x/4.x
 RA Eclipse plug-in
 RA Eclipse plug-in JAVA
docs
 The RA 5.5.2 CD image
(Windows/Linux) contains
the CustomActionsSKD
folder
 Expand the
Eclipse_Actions_SDK_5.5.2.
zip to the
%Eclipse_Home%plugins

Action Types
CLI
 Runs any existing
command or script
that accepts command
line arguments for
which an interpreter
exists.
 Similar to running
command or script
with existing RA Run
Command Line action
SCRIPT
 Runs a cmd.exe,
PowerShell or Bash
script
 Supports inline
script editing and
variable substitution
API
 RESTful - performs
Get, Post, Put, etc.
operations against
provided URI
 SOAP – create the
SOAP message and
process it
 Interact with other
APIs

Create and publish flow
with custom action
High Level Workflow
Verify pre-requisites
Extract SDK
components
Create custom action
template in Eclipse
Add action to your RA
application
Install custom action Export action to a JAR
Test custom action in
Eclipse

Lab Aims
Create an action pack
using the RDK/SDK
Create one action each
for CLI, Restful and Script
Generate the action pack Test it in Release
Automation

Launch the RDK
 Login to your lab environment
with user and password
Administrator/CAdemo123
 Launch the RDK by clicking on
the RA RDK Shortcut on the
desktop
 Login to the RDK with
superuser/suser

Create a New Action Pack
SELECT “ADD ACTION PACK”
ENTER VALUES
 Name = “CAWorld”
 Primary Cat = “World”
 Author = Your Name
 Version = 1.0
 Desc = CA World RDK/SDK Lab
SAVE

Add an Action
SELECT “ADD ACTION”

Select Action Type
SELECT CLI

Create a Command Line Action
CLICK DETAILS TAB
ENTER VALUES
 Name: Get Current Time
 Description: Use time /t
 Primary Category: Time
CLICK CLI

Enter Command Details
 Expand the
Windows CLI
 Command = time /t
 Select Execute
 Select Output

Set the Output Value
 Add a new Output
Param
– current_time
 Type = String
 Filter Type = Reg Ex
 Source = Standard Out
 RegEx = [sS]*

Create Error Conditions
ADD AN ERROR
CONDITION
PARAMETER =
Exit Code
OPERATOR
Not Equal (!=)
VALUE
0

Save it!
SAVE YOUR NEW
ACTION!

Add an Action

Select Action Type
SELECT SCRIPT

Create Get Memory Action
ENTER VALUES:
 Name: Get Memory
 Description: Get
Server memory
 Primary Category:
Memory

Set the Input Parameters
 Add a new
parameter
– Servername
 Set Type = String
 Set Default to
– Localhost

Add Script
 Click Script
 Shell = PowerShell
 Upload script
– C:Memory.ps1
 Delete <ReplaceServerName>
 Drag blue Servername param
into script after –computer
– Shows up as $(Servername)
 Select “Execute Script”

Execute the Script
SELECT EXECUTE

Select Output Parameters
 Add a new parameter
– Memory
 Type = String
 Filter Type = Reg Ex
 Source = Standard Out
 Regular expression =
([0-9].*)

Save it!
SAVE YOUR NEW ACTION!

Add an Action

Select Action Type
SELECT RESTful

ENTER VALUES:
 Name = Get Jenkins
Job Info
 description = Action to
get details of Jenkins
Job
 category = Jenkins Job
CLICK INPUT
Create an Action to Get Jenkins Job Details

Create Input Parameters
 Enter in “Job Name”
 Type = String
 Description =
Jenkins Job Name
 Default Value
– “CAWorld”

 Enter in “Jenkins
Port”
 Select “Required”
Checkbox
 Type = Integer
 Add in a description.
 Default Value
– “8060”

 Enter in “Jenkins
Server”
 Type = String
 Description=Jenkins
server name
 Default Value
– “localhost”

Create the Rest Call
 Set the URI:
– http://${Jenkins
Server}:${Jenkins
Port}/job/${Job
Name}/lastSuccessfulBuild/a
pi/json
 Set the Method = GET
 Select No
Authentication
 Execute RESTful Call

Execute the Restful Call
SELECT “EXECUTE”

Add Output Parameters
ADD OUTPUT PARAM
userName
TYPE
String
FILTER TYPE
JSONPath
FIND USING JSONPath
$.actions.[0].userName

ADD OUTPUT PARAM
jobUrl
TYPE
String
FILTER TYPE
JSONPath
FIND USING JSONPath
$.url
Save
Add Output Parameters

Export Jar File
 Click Export
 Select Export as
Jar
 Jar created in
downloads dir

Import the Jar File into RA
 Connect to the RA ROC Login
– superuser/suser
 Navigate to Administration |
Action Management
 Select the “Installed Packs” tab
 Navigate to the “Downloads”
folder
 Select the “nolio-caworld-
actions-1.0.jar”

Completion of Action Pack into RA
 The jar file will be imported
 Message that the import
has been successful

Test the Actions
 Go to Designer | Process
Design
 Select WorldDemo App
 Expand RDKTest
 Select Actions

Test the Actions
 Search for “World”
 Create 3 actions
 Get Memory
 Get Current Time
 Get Jenkins Job Info
 Click the action name
 Enter the parameter info
 Click Save

Test the Actions
 Highlight the CAWorld Flow
 Right Click and Select Add
Action
 Add all 3 actions
 Click Save
 Click Test

Test the Actions
 Click the “Test” icon
 The test agent will be
selected by default
 Press the “Start Test”
button
 Some of the Actions will
turn green when they are
complete

Check the Results
Double Click each action and select “Show additional information”
to see the results

Create an Action via SDK

Eclipse Project
Start up Eclipse
Create a new project by selecting
FileNewJava Project
Enter the following values:
Project Name: CAWorld
Location: c:caworld-Proj
Click “Finish” to create the Java
project

Change the Java Project Properties
Change the project
properties by
highlighting
“CAWorld” and right-
click
Select Properties
Select Java Compiler
Set the values as you
in the screen capture

Add RA Action
Highlight the “src” folder,
do a right-click
Select NewOther
Search for the Nolio
Action, and select it, then
click Next

Add RA Action Name
Add the name of
“worldaction”
Click on the “Finish” button

RA Action Created
The RA Action has now been created

Building JAR file
Highlight “CAWorld”
and right-click
Select Export
Select JAR File and click
Next

Location of JAR file
Enter the desired
location, in this case
that will be
“c:tempcaworld-
1.0.jar
Click “Next” twice
Click “Finish” to create
the JAR file

Building JAR file
Highlight “CAWorld”
and right-click
Select Export
Select JAR File and click
Next

Load Custom Action Into RA
Login into the ROC
Select Administration|Action
Management
Select the “Installed Packs” tab
Select the Import button
Navigate to the c:tempcaworld-
1.0.jar
Start the import

Add Action To RA Application
Go to the WorldDemo
application
Click “+” in the Actions
Search for Greeting
Add the “Hello Action”

Add Flow to RA Application
Highlight the Flows
Click the “+” to add a flow
Call the flow “CAWorld”
Highlight the “CAWorld” flow
Drag the “Hello Action” into
the flow

Test RA Application Flow
Click the “Test” button
Take the default
options
Start the test

Verify Custom Action Results
Once the test run has
completed
Double-click on the
“Hello Action”
Expand the Run-Time
Information

Once the test run has
completed
Double-click on the
“Hello Action”
Expand the Run-Time
Information
Developer Community
1) TOOLS
1) REST API
2) SDK – Eclipse plug-in
3) RDK – Easy-Peasy. Patents pending
2) REPOSITORY
1) GitHub – CA contributions, source and binaries, Eclipse licensing
1) https://ww.github.com/ca-releaseautomation
3) COLLABORATION
1) Developer sub-community
1) https://comunities.ca.com/community/ca-release-automation/developer

Experiences
Add inputs
Outputs
Error conditions
Create default JAVA classes
Create New
Action Packs
Easy to build
3rd party integrations
Non developers can use
More sophisticated methods
available via SDK
Build them via
RESTful
CLI
Script actions
SOAP
JAVA classes
Summary
RDK/SDK

Recommended Sessions
SESSION # TITLE DATE/TIME
DO4X211L
Hands-On Lab: Take CA Release Automation for a Test
Drive
11/18/2015 at 1:00 pm
DO4X213L
Hands-On Lab: Complement CA Release Automation with
a New Continuous Delivery Solution Offering a visual
approach for complex application releases
11/18/2015 at 4:30 pm

Must See Demos
CA RA
Release Automation
Theater 4
Integrations
Docker,
CloudFoundery,
Jenkins, etc
Theater 4
CA RPM
Release Pipeline
Manager
Theater 4
RDK/SDK
RA Rapid Dev
Kit/SDK
Theater 4

Follow On Conversations At…
Smart Bar
CA Release
Automation
Theater 4
Tech Talks
Reducing Risk with
Canary
Deployments
Theater 4

Q & A

For More Information
To learn more, please visit:
http://cainc.to/Nv2VOe
CA World ’15

Hand-On Lab: CA Release Automation Rapid Development Kit and SDK

Empfohlen

Empfohlen

Weitere ähnliche Inhalte

Was ist angesagt?

Was ist angesagt? (20)

Andere mochten auch

Andere mochten auch (11)

Ähnlich wie Hand-On Lab: CA Release Automation Rapid Development Kit and SDK

Ähnlich wie Hand-On Lab: CA Release Automation Rapid Development Kit and SDK (20)

Mehr von CA Technologies

Mehr von CA Technologies (20)

Kürzlich hochgeladen

Kürzlich hochgeladen (20)

Hand-On Lab: CA Release Automation Rapid Development Kit and SDK