Merge pull request #4 from oracle-devrel/cascaded-pipelines

Cascaded pipeline samples with in the same region

Author: RahulMR42

oci-pipeline-examples/README.md

@@ -7,6 +7,12 @@ All about devops pipelines using OCI Devops.
 
 * [Build and run a OCI devops pipeline with JAVA and Graal VM framework.](./oci-java-graalvm-devops-example/)
 
+</details>
+<details>
+  <summary>Cascaded Pipelines - click to expand</summary>
+  
+* [Cascaded Pipelines - With in the Region](./oci-cascaded-pipelines/same-region/)
+
 </details>
 
 

oci-pipeline-examples/oci-cascaded-pipelines/README.md

@@ -0,0 +1,21 @@
+# OCI DevOps Cascaded Pipelines
+
+## Objective
+* Invocation of new another build or deploy pipeline after the successful execution of build/deploy pipeline.
+
+## Prerequisites & References
+This guide assumes that you already have required pipelines created to invoke them cascadly. You may refer to below links to create and setup pipelines.
+* Reference Architecture - https://github.com/oracle-quickstart/oci-arch-ci-cd-devops
+* Oracle DevOps Documentation - https://docs.oracle.com/en-us/iaas/Content/devops/using/home.htm
+* IAM Policies - https://docs.oracle.com/en-us/iaas/Content/devops/using/devops_iampolicies.htm
+
+## Samples
+
+Sample procedure and code snippets for the cascaded pipelines of the below scenarios.
+
+* [Trigger Build Pipeline from Build Pipeline](same-region/trigger-build-from-build)
+* [Trigger Deploy Pipeline from Build Pipeline](same-region/trigger-deploy-from-build)
+* [Trigger Build Pipeline from Deploy Pipeline](same-region/trigger-build-from-deploy)
+* [Trigger Deploy Pipeline from Deploy Pipeline](same-region/trigger-deploy-from-deploy)
+
+

oci-pipeline-examples/oci-cascaded-pipelines/same-region/README.md

@@ -0,0 +1,21 @@
+# OCI DevOps Cascaded Pipelines - Same Region
+
+## Objective
+* Invocation of another build or deploy pipeline after the successful execution of build/deploy pipeline.
+
+## Prerequisites & References
+This guide assumes that you already have required pipelines created to invoke them cascadly. You may refer to below links to create and setup pipelines.
+* Reference Architecture - https://github.com/oracle-quickstart/oci-arch-ci-cd-devops
+* Oracle DevOps Documentation - https://docs.oracle.com/en-us/iaas/Content/devops/using/home.htm
+* IAM Policies - https://docs.oracle.com/en-us/iaas/Content/devops/using/devops_iampolicies.htm
+
+## Samples
+
+Sample procedure and code snippets for the cascaded pipelines of the below scenarios.
+
+* [Trigger Build Pipeline from Build Pipeline](trigger-build-from-build)
+* [Trigger Deploy Pipeline from Build Pipeline](trigger-deploy-from-build)
+* [Trigger Build Pipeline from Deploy Pipeline](trigger-build-from-deploy)
+* [Trigger Deploy Pipeline from Deploy Pipeline](trigger-deploy-from-deploy)
+
+

oci-pipeline-examples/oci-cascaded-pipelines/same-region/trigger-build-from-build/README.md

@@ -0,0 +1,66 @@
+# OCI DevOps Cascaded Pipelines
+
+## Trigger Build Pipeline from Build Pipeline
+
+### Prerequisites
+* Two build pipelines
+
+#### 1. Deploy Function
+**Step 1:**
+Clone the repository code.
+```
+$ git init cascaded-pipelines
+$ cd cascaded-pipelines
+$ git remote add origin https://github.com/oracle-devrel/oci-devops-examples
+$ git config core.sparsecheckout true
+$ echo "oci-pipeline-examples/oci-cascaded-pipelines/same-region/trigger-build-from-build/*">>.git/info/sparse-checkout
+$ git pull --depth=1 origin main
+```
+
+**Step 2:**
+Change to function directory.
+```
+$ cd node-function
+```
+
+**Step 3:**
+In `func.yaml`, update `build_pipeline_id` and `display_name_prefix_for_new_run` with appropriate values as below.
+
+```
+config:
+  build_pipeline_id: "<BUILD-PIPELINE-OCID>"
+  display_name_prefix_for_new_run: "AutoTriggeredCascade2_"
+```
+
+**Step 4:**
+Deploy the function with below command.
+```
+$ fn -v deploy --app <app-name>
+```
+Note: Refer https://docs.oracle.com/en-us/iaas/Content/Functions/Tasks/functionscreatingapps.htm for creating new application.
+
+#### 2. Configure Service Connector Hub
+**Step 1:**
+
+Open Menu > `Observability & Management` > `Service Connectors`
+
+**Step 2:**
+
+Set Service Connector Source as `Logging` and Target as `Functions`
+
+**Step 3:**
+
+Configure Source as below
+
+![Service Connector Source Config](images/service-connector-source-config.png)
+
+* Choose Compartment, Log Group, Logs of your DevOps Project.
+* set `data.buildPipelineId` to the previous pipeline OCID as above.
+* set `data.message` to the last successful unique log message like `Completed Build stage.`
+
+**Step 4:**
+
+Configure Target with `Function Application` and `Function` as `trigger-build-pipeline-from-build-pipeline` as below
+
+![Service Connector Target Config](images/service-connector-target-config.png)
+

oci-pipeline-examples/oci-cascaded-pipelines/same-region/trigger-build-from-build/images/service-connector-source-config.png

@@ -0,0 +1,34 @@
+const fdk = require('@fnproject/fdk');
+const common = require("oci-common");
+const devops = require("oci-devops");
+
+const buildPipelineId = process.env.build_pipeline_id;
+const displayNamePrefixForNewRun = process.env.display_name_prefix_for_new_run;
+
+fdk.handle(async function(input){
+  const provider = common.ResourcePrincipalAuthenticationDetailsProvider.builder();
+
+  const devopsClient = new devops.DevopsClient({
+    authenticationDetailsProvider: provider
+  })
+  const run = await devopsClient.getBuildRun({buildRunId: input[0].data.buildRunId});
+  console.log("CURRENT BUILD RUN", JSON.stringify(run));
+
+  var items = run.buildRun.buildOutputs.exportedVariables.items;
+
+  // Add new parameters if required
+  // items.push({name: 'PARAM', value: 'Value'});
+
+  const buildRunResponse = await devopsClient.createBuildRun({
+    createBuildRunDetails: {
+      buildPipelineId,
+      displayName: displayNamePrefixForNewRun + new Date().toISOString(),
+      buildRunArguments: {
+        items
+      }
+    }
+  })
+  console.log("CREATE BUILD RUN RESPONSE", JSON.stringify(buildRunResponse));
+
+  return buildRunResponse;
+})

oci-pipeline-examples/oci-cascaded-pipelines/same-region/trigger-build-from-build/images/service-connector-target-config.png

@@ -0,0 +1,10 @@
+schema_version: 20180708
+name: trigger-build-pipeline-from-build-pipeline
+version: 0.0.10
+runtime: node
+build_image: fnproject/node:14-dev
+run_image: fnproject/node:14
+entrypoint: node func.js
+config:
+  build_pipeline_id: "<BUILD-PIPELINE-OCID>"
+  display_name_prefix_for_new_run: "AutoTriggeredCascade2_"