Merge pull request #33 from IBM/workshop-cicd-cl-command

workshop cicd cl command

Author: eric-simpson

docs/workshop/05_build.md

@@ -44,7 +44,7 @@ Expand ARCAD view on the left: Compilation result for an Arcad Project creates a
 
 <!-- div:left-panel -->
 
-View logs (bottom view) with compilator warnings
+View `Problems` view with compilation messages
 
 <!-- div:right-panel -->
 

docs/workshop/06/cicd_r.png

@@ -15,6 +15,7 @@ From `Home>Overview` on the Merlin dashboard, launch the `IBM i CI/CD` applicati
 <!-- panels:end -->
 
 ---
+### Define ARCAD Build
 
 <!-- panels:start -->
 
@@ -66,7 +67,7 @@ Uncheck `Upload source code`.  Check `Select build server (template)` and choose
 
 <!-- div:right-panel -->
 
-![](06/cicd_e.png)
+![](06/cicd_g.png)
 
 <!-- panels:end -->
 
@@ -86,20 +87,6 @@ Click `Add Build Actions>Run an ARCAD-Builder build`
 <!-- panels:end -->
 
 
----
-
-<!-- panels:start -->
-
-<!-- div:left-panel -->
-
-Uncheck `Upload source code`.  Check `Select build server (template)` and choose the existing template
-
-<!-- div:right-panel -->
-
-![](06/cicd_g.png)
-
-<!-- panels:end -->
-
 ---
 
 <!-- panels:start -->
@@ -157,6 +144,7 @@ Click `Yes` to save the task
 <!-- panels:end -->
 
 ---
+### Run ARCAD Build
 
 <!-- panels:start -->
 
@@ -228,3 +216,181 @@ The Build results show the final status.  Additional details are provided by che
 
 <!-- panels:end -->
 
+---
+
+### Define CL Command 
+
+<!-- panels:start -->
+
+<!-- div:left-panel -->
+
+From `Task Management>Create New Task` tab, enter a job name, e.g. `User1_job2`.  Click `Next`:
+
+<!-- div:right-panel -->
+
+![](06/cicd_b.png)
+
+<!-- panels:end -->
+
+---
+
+<!-- panels:start -->
+
+<!-- div:left-panel -->
+
+Click `Next` (no git repository needs to be specified)
+
+<!-- div:right-panel -->
+
+![](06/cicd_c.png)
+
+<!-- panels:end -->
+
+---
+
+<!-- panels:start -->
+
+<!-- div:left-panel -->
+
+Click `Add Build Actions>Add Build Server`
+
+<!-- div:right-panel -->
+
+![](06/cicd_d.png)
+
+<!-- panels:end -->
+
+---
+
+<!-- panels:start -->
+
+<!-- div:left-panel -->
+
+Check `Select build server (template)` and choose the existing build server.
+   * Note: to select from multiple IBM i servers, add Inventory and Templates in Merlin under Connections, 
+
+Optionally, specify `Work directory` of `/home/USERxx/cicd` where `USERxx` is your userid on the IBM i. 
+
+
+<!-- div:right-panel -->
+
+![](06/cicd_r.png)
+
+<!-- panels:end -->
+
+
+---
+
+<!-- panels:start -->
+
+<!-- div:left-panel -->
+
+Click `Add Build Actions>Run CL Command`
+
+<!-- div:right-panel -->
+
+![](06/cicd_f.png)
+
+<!-- panels:end -->
+
+---
+
+<!-- panels:start -->
+
+<!-- div:left-panel -->
+
+Configure the CL command.
+
+For `Specify remote IBM i server`, select the build server.
+
+For `CL command`, specify commands to create a save file and save the ARCAD build library into it:
+
+```
+CRTSAVF FILE(QGPL/USER16SAVF) TEXT('user 16 savf')
+SAVLIB LIB(SCODSB0026) DEV(*SAVF) SAVF(QGPL/USER16SAVF)
+```
+
+Then click `Next`.
+
+<!-- div:right-panel -->
+
+![](06/cicd_t.png)
+
+<!-- panels:end -->
+
+---
+
+<!-- panels:start -->
+
+<!-- div:left-panel -->
+
+No Deploy actions are required.  Click `Next`
+
+<!-- div:right-panel -->
+
+![](06/cicd_i.png)
+
+<!-- panels:end -->
+
+---
+
+<!-- panels:start -->
+
+<!-- div:left-panel -->
+
+Review the summary and click `Finish`
+
+<!-- div:right-panel -->
+
+![](06/cicd_u.png)
+
+<!-- panels:end -->
+
+---
+
+<!-- panels:start -->
+
+<!-- div:left-panel -->
+
+Click `Yes` to save the task
+
+<!-- div:right-panel -->
+
+![](06/cicd_k.png)
+
+<!-- panels:end -->
+
+---
+### Run CL Command
+
+<!-- panels:start -->
+
+<!-- div:left-panel -->
+
+Under `Task Management>Task Dashboard`, select `Run Task` from the popup menu on the new task
+
+Click `Next` on eash panel and update any values if desired.
+
+Click `Finish` after reviewing the summary.
+
+Click `Yes` to submit the job.
+
+<!-- div:right-panel -->
+
+![](06/cicd_o.png)
+
+<!-- panels:end -->
+
+---
+
+<!-- panels:start -->
+
+<!-- div:left-panel -->
+
+The Build results show the final status.  Additional details are provided by checking the Jenkins information under `Jenkins Configuration >  Manage Jenkins Jobs`
+
+<!-- div:right-panel -->
+
+![](06/cicd_v.png)
+
+<!-- panels:end -->