custom shape sample

Author: Rahul MR

AIO.md

@@ -1,5 +1,6 @@
 ## All in One reference for samples - In Alphabetical (A to Z) order.
 - A sample to run OCI AI Anomaly detection from OCI Build-pipeline - https://github.com/oracle-devrel/oci-devops-examples/tree/main/oci-build-examples/oci-devops-anomaly-detection
+- A sample to use `Custom Shapes` within OCI Build pipelines - https://github.com/oracle-devrel/oci-devops-examples/tree/main/oci-build-examples/oci-build-custom-shapes
 - A way (workaround) to execute commands on to a Windows machine using OCI Run command agent from OCI Build pipeline. - https://github.com/oracle-devrel/oci-devops-examples/tree/main/oci-build-examples/oci-devops-connect-to-windows-from-buildmachines
 - Access resource with Private IP from OCI Build runner - https://github.com/oracle-devrel/oci-devops-examples/tree/main/oci-build-examples/oci-devops-pa-with-private-oke
 - Build Caching - https://github.com/oracle-devrel/oci-devops-examples/tree/main/oci-build-examples/oci-build-caching

README.md

@@ -11,7 +11,7 @@ The service also provides private Git repositories to store your code and it sup
 
 ## OCI Devops examples (Catogorical view )
 
-- [⚡ CICD with OCI Devops services - samples](./oci-pipeline-examples/README.md)         
+- [⚡ CICD with OCI Devops services - samples](./oci-pipeline-examples/README.md)        
 - [⚡ OCI Devops Build service - samples](./oci-build-examples/README.md) 
 - [⚡ OCI Devops Deployment service - samples](./oci-deployment-examples/README.md) 
 - [⚡ OCI Source Code Management service - sample](./oci-coderepo-examples/README.md)
@@ -21,7 +21,7 @@ The service also provides private Git repositories to store your code and it sup
 - 🛎[Sample illustration of deployment on to *OCI Container instance* using OCI DevOps.]( https://github.com/oracle-devrel/oci-devops-examples/blob/main/oci-deployment-examples/oci-devops-deploy-containerinstance
   )
 - 🛎️[Sample illustration of verifying the *integrity of Helm chart* before the deployment](https://github.com/oracle-devrel/oci-devops-examples/blob/main/oci-deployment-examples/oci-deployment-with-helm-attestation)
-- 🛎️[Sample illustration of OCI DevOps deployment pipeline with DevOps Deploy Shell stage.]( https://github.com/oracle-devrel/oci-devops-examples/blob/main/oci-deployment-examples/oci-deployment-shell-stages)
+- 🛎️[A sample to use `Custom Shapes` within OCI Build pipelines]( https://github.com/oracle-devrel/oci-devops-examples/tree/main/oci-build-examples/oci-build-custom-shapes)
 - 🛎️[A sample to run OCI AI Anomaly detection from OCI Build-pipeline.](https://github.com/oracle-devrel/oci-devops-examples/tree/main/oci-build-examples/oci-devops-anomaly-detection)
 
 

oci-build-examples/README.md

@@ -1,5 +1,12 @@
 All about OCI devops build samples ..
 =======
+<details>
+  <summary>Anomaly detections - click to expand</summary>
+
+* [Anomaly detection from buildpipeline](./oci-devops-anomaly-detection/)
+
+</details>
+
 <details>
   <summary>Build Caching - click to expand</summary>
 
@@ -19,6 +26,13 @@ All about OCI devops build samples ..
 * [Run commands on WINDOWS host from build pipeline](./oci-devops-connect-to-windows-from-buildmachines/)
 
 
+</details>
+<details>
+  <summary>Custom shaped Build runner  - click to expand</summary>
+
+* [Use custom shape build runner machine](./oci-build-custom-shapes/)
+
+
 </details>
 
 <details>

oci-build-examples/oci-build-custom-shapes/README.md

@@ -0,0 +1,80 @@
+
+# A sample to use `Custom Shapes` within OCI Build pipelines.
+
+The feature enables developers to select their preferred CPU and memory for their managed build stage.
+
+   ```
+   $ git init oni-build-custom-shapes
+   $ cd ooci-build-custom-shapes
+   $ git remote add origin <url to this git repo>
+   $ git config core. sparse checkout true
+   $ echo "oci-build-examples/oci-build-custom-shapes/*">>.git/info/sparse-checkout
+   $ git pull --depth=1 origin main
+
+   ```
+
+Procedure to use the illustration
+-------
+
+- Create OCI Notifications topic - https://docs.oracle.com/en-us/iaas/Content/Notification/Tasks/create-topic.htm#top
+- Create OCI DevOps projects and associate with the topic - https://docs.oracle.com/en-us/iaas/Content/devops/using/create_project.htm#create_a_project
+- Enables logs for the DevOps project.
+- Create a dynamic group with the below rules.
+```java
+ALL {resource.type = 'devopsbuildpipeline', resource.compartment.id = 'OCID OF YOUR COMPARTMENT'}
+```
+- Create an identity policy with the below statements.
+```java
+Allow dynamic-group <NAME OF THE DYNAMIC GROUP> to manage ons-topics in compartment <NAME OF THE COMPARTMENT>
+```
+- Create an `OCI Code repo`
+- Push the whole contents here to the OCI CODE REPO created.
+- Create a build pipeline.
+  ![](images/oci-build-pipeline.png)
+
+- Use `+` and add a `custom managed build stage`.
+  ![](images/oci-build-stage-1.png)
+
+- Select `custom shape`
+  ![](images/oci-build-stage-2.png)
+
+- Choose runner shapes `OCPUs` and `Memory` using the slide bars.
+  ![](images/oci-build-stage-3.png)
+
+- Associate the code repo as the `primary source code` for the stage.
+
+![](images/oci-build-stage-4.png)
+
+- Click `Add`
+- Click the `Start manual run` option and run a build stage.
+
+![](images/oci-build-run.png)
+
+The custom build shape option will create a build runner with the desired OCPU and Memory and start the build run. The concerned resources are managed by building service internally and are not visible to customer tenancy. Based on the resource using the concerned price will be charged back to the user.
+
+![](images/oci-build-run-2.png)
+
+- The build will continue and display some of the default values from the build runner machine.
+- Along with the custom shape option, the default build runner option will be retained for use cases that can fix within the defined resources.
+
+Read more
+---
+
+- OCI DevOps service - https://docs.oracle.com/en-us/iaas/Content/devops/using/home.htm
+- Details about OCI Anomaly detection and workshop -.
+
+- There are reference samples available within the directory [ai-data-references](ai-data-references) to set up the anomaly detection project /model and run execution using [OCI CLI](https://apexapps.oracle.com/pls/apex/r/dbpm/livelabs/run-workshop?p210_wid=819&p210_wec=&session=107963899615339).
+
+Contributors
+===========
+
+- Author: [Rahul M R](https://github.com/RahulMR42).
+- Collaborators:
+- Last release: March 2023
+
+### Back to examples.
+----
+
+- 🍿 [Back to OCI Devops Build sample](./../README.md)
+- 🏝️ [Back to OCI Devops sample](./../../README.md)
+

oci-build-examples/oci-build-custom-shapes/build_spec.yaml

@@ -0,0 +1,45 @@
+version: 0.1
+component: build
+timeoutInSeconds: 6000
+runAs: root
+shell: bash
+env:
+  # these are local variables to the build config
+  variables:
+
+  # the value of a vaultVariable is the secret-id (in OCI ID format) stored in the OCI Vault service
+  # you can then access the value of that secret in your build_spec.yaml commands
+  vaultVariables:
+  #  EXAMPLE_SECRET: "YOUR-SECRET-OCID"
+  # exportedVariables are made available to use as parameters in sucessor Build Pipeline stages
+  # For this Build to run, the Build Pipeline needs to have a BUILDRUN_HASH parameter set
+  exportedVariables:
+    - BUILDRUN_HASH
+
+steps:
+  - type: Command
+    name: "Fetch Values"
+    timeoutInSeconds: 240
+    command: |
+      echo "OCI_BUILD_RUN_ID => ${OCI_BUILD_RUN_ID}"
+      echo "OCI_TRIGGER_COMMIT_HASH => ${OCI_TRIGGER_COMMIT_HASH}"
+      echo "OCI_STAGE_ID =>${OCI_STAGE_ID}" 
+      echo "OCI_BUILD_RUN_ID=>${OCI_BUILD_RUN_ID}"
+      echo "OCI_TRIGGER_SOURCE_BRANCH_NAME =>${OCI_TRIGGER_SOURCE_BRANCH_NAME} "
+      echo "OCI_TRIGGER_SOURCE_URL =>${OCI_TRIGGER_SOURCE_URL} "
+      echo "OCI_TRIGGER_EVENT_TYPE =>${OCI_TRIGGER_EVENT_TYPE} "
+      echo "OCI_PRIMARY_SOURCE_DIR =>${OCI_PRIMARY_SOURCE_DIR} "
+      echo "OCI_WORKSPACE_DIR	=> ${OCI_WORKSPACE_DIR} "
+      echo "OCI_PRIMARY_SOURCE_NAME => ${OCI_PRIMARY_SOURCE_NAME} "
+      echo "OCI_BUILD_STAGE_NAME => ${OCI_BUILD_STAGE_NAME}"
+      echo "Use a custom value from predefined system variable to expose outside of the current build stage.."
+      export BUILDRUN_HASH =`echo ${OCI_BUILD_RUN_ID} | rev | cut -c 1-7`
+      if [ -z ${OCI_TRIGGER_COMMIT_HASH} ] 
+      then 
+          cd ${OCI_PRIMARY_SOURCE_DIR}
+          export OCI_TRIGGER_COMMIT_HASH=`git log --format="%H" -n 1|cut -c 1-7`
+      fi
+      echo "OCI_TRIGGER_COMMIT_HASH	=>${OCI_TRIGGER_COMMIT_HASH}"
+
+  # Last command is used to get the commit hash using GIT ID ,its a hack while there wont be any default commit hash by manual Run.
+  # Until its fixed we can fetch the same via GIT Command.