Add automation pipeline documentation

Author: abeykoon

en/pe-docs/docs/devops/automation-pipelines/inbuilt-templates.md

@@ -0,0 +1,44 @@
+When configuring a pipeline, you can use built-in pipeline templates provided by Choreo. These templates include pre-defined functionality that can simplify and accelerate pipeline creation.
+
+[Choreo’s pipeline specification](./specification.md) supports referencing these templates using the following syntax:
+
+```
+steps:
+  - name: Build
+    template: choreo/<template name>
+```
+
+## Available Built-in Templates
+
+!!! info "Note"
+    The list of built-in templates is continuously growing.
+
+??? "choreo/buildpack-build@v1"
+    Builds applications using supported buildpacks within Choreo. This is used by Choreo’s default build pipeline.
+
+??? "choreo/dockerfile-scan@v1"
+    Scans Dockerfiles for security vulnerabilities and best practices.
+
+??? "choreo/docker-build@v1"
+    Builds Docker images using a provided Dockerfile.
+
+??? "choreo/trivy-scan@v1"
+    Performs vulnerability scanning on container images using Trivy.
+
+??? "choreo/webapp-build@v1"
+    Builds web applications using supported frameworks.
+
+??? "choreo/ballerina-build@v1"
+    Builds Ballerina projects.
+
+??? "choreo/mi-trivy-scan@v1"
+    Performs Trivy-based vulnerability scanning for Micro Integrator images.
+
+??? "choreo/integration-project-build@v1"
+    Builds integration projects.
+
+??? "choreo/test-runner-build@v1"
+    Runs tests using the built-in test runner.
+
+??? "choreo/prism-build@v1"
+    Builds Prism projects.

en/pe-docs/docs/devops/automation-pipelines/introduction.md

@@ -0,0 +1,8 @@
+# What are Automation Pipelines
+
+!!! info "Note"
+    Automation pipeline capabilities are only available in paid plans for private data plane organizations.
+
+Choreo provides the capability to define and run any automated workflow within your IDP infrastructure. You can write your automation pipeline using the [Choreo pipeline syntax](./specification.md) which is a simplified version of [Argo workflows syntax](https://argoproj.github.io/workflows/) syntax.
+
+There are a few variations of automation pipelines - CI pipelines, CD pipelines and Infrastructure provisioning pipelines depending on what you are automating.

en/pe-docs/docs/devops/automation-pipelines/manage-automation-pipeline.md

@@ -0,0 +1,47 @@
+# Create Automation Pipelines
+
+Choreo allows to define automation pipelines at organization level. Follow these steps to create an automation pipeline.
+
+1. Sign in to the [Choreo Console](https://console.choreo.dev/).
+2. In the left navigation menu, click **DevOps** and then click **Automation Pipelines**.
+3. Click **+ Create**.
+4. You can define an inline yaml or import from GitHub
+
+## Define pipeline within Choreo
+
+This option is useful when you are testing a pipeline or if you like to let Choreo to keep your pipeline definitions.
+
+1. Under `Define your Pipeline YAML`, click **Use YAML Editor**
+2. Provide a name by which you can identify the pipeline.
+3. Optionally provide a description
+4. Click **Create**
+
+This pipeline definition is managed within Choreo. You can update it after defining as well.
+
+## Import pipeline from Git
+
+If your organization manages pipelines in Git, you can authorize and let Choreo to refer it. It could be a monolithic repository having multiple pipelines.
+
+1. Under `Import Pipeline from Git` Click on the Git provider to authorize, and proceed with steps to grant access.
+2. You can select **Repository**, **Branch** and Specific **Pipeline Yaml** File within and directory in the repository.
+3. Provide a name by which you can identify the pipeline.
+4. Optionally provide a description
+5. Click **Create**
+
+Created pipelines will be listed in a tabular view.
+
+
+# Edit Automation Pipelines
+
+Editing is only possible for pipelines defined within Choreo. Click **Edit Pipeline YAML** and in the right side panel that opens up you can edit the pipeline definition. You can view the pipeline definition in full screen view as well by maximizing the panel.
+
+!!! info "Note"
+    Once a pipeline is edited, you cannot roll back to a previous version.
+
+When a pipeline is defined in Git, it always uses the latest version from the repository at runtime.
+To update the pipeline, modify it in Git and trigger a new run.
+
+# Delete Automation Pipelines
+
+In the pipeline listing, under the **Actions** column, click the **Delete** icon. A confirmation pop-up will appear. Upon confirmation, the pipeline and all its associated runs will be permanently removed from Choreo.
+

en/pe-docs/docs/devops/automation-pipelines/run-automation-pipeline.md

@@ -0,0 +1,42 @@
+After a pipeline is defined, you can execute it. The pipeline may need some inputs for it to run. Ensure you configure them correctly before triggering the run.
+
+# Add Pipeline Variables and Secrets
+
+The pipelines are defined at the organization level. Thus the variables defined for them are injected at the same level. Learn more on how to define a input variable in your pipeline at [Variables and Secrets - Choreo Pipelines Specification](abc). Follow these steps to define inputs and their values for a given pipeline.
+
+1. Click on **Pipeline Variables & Secrets** at upper right corner of the pipeline page.
+2. A panel will appear on the right side. To add a variable, under **Variables** section, add a new one by providing the Name and Value. The variable name must exactly match the name expected by the pipeline.
+3. If you have a secret to be added as a pipeline input, under **Secrets** section, add a new one by providing the Name and Value. The secret name must exactly match the name expected by the pipeline.
+
+!!! info "Note"
+    Once a secret is added, it is securely uploaded to the environment’s configured vault and injected into the pods running the workflow. You will not be able to view the secret value again after it is added.
+
+## Manage existing Pipeline Variables and Secrets
+
+To update or remove a secret, click the three vertical dots in the upper-right corner of the variable box in the Choreo UI. From the menu, choose the appropriate action.
+
+# Run pipeline
+
+Once the pipeline inputs are configured, click **Start New Run** to trigger a workflow run. The run will use the latest version of the pipeline definition along with the configured inputs.
+
+Under the Runs table, a new row will appear displaying a unique **Run ID** for the triggered run. The following details are shown for each pipeline run:
+
+1. **Version** – The version of the pipeline definition. This version is automatically incremented each time the pipeline definition is updated. It helps determine whether the run was triggered after a definition update.
+2. **Status** – The current status of the run:
+    - **Successful**: All steps in the pipeline completed successfully.
+    - **Failed**: One or more steps in the pipeline failed.
+    - **Stopped**: The pipeline was manually stopped.
+3. **Start Time** – The timestamp when the pipeline run was triggered.
+4. **Duration** – The total time taken to execute the pipeline. If the pipeline runs for more than a predefined threshold (e.g., xx minutes), it will be automatically force-stopped by Choreo.
+
+
+# View pipeline logs
+
+Click **View Logs** for a selected pipeline run in the Runs table. This opens a panel on the right, displaying logs for each step of the pipeline. You can close or maximize the log panel using the icons in the upper-right corner of the panel.
+
+!!! info "Note"
+    Choreo keeps pipeline logs maximum for 30 days. 
+
+# Stop a pipeline run
+
+One a pipeline run is triggered, Click on **View Logs** and then in the log panel that opens to the right, click on **Stop Run**.