Skip to content

Commit 3ef2b96

Browse files
doc: Devtron CD Trigger Plugin doc (#5747)
* devtron-cd-trigger plugin doc * minor update * Proofreading done * Update devtron-cd-trigger.md * Removed unwanted phrase * Changed wording * Changed plurality * Updated devtron token --------- Co-authored-by: ashokdevtron <[email protected]>
1 parent f1a50b1 commit 3ef2b96

File tree

2 files changed

+62
-0
lines changed

2 files changed

+62
-0
lines changed

docs/SUMMARY.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -141,6 +141,7 @@
141141
* [Dependency track - Maven & Gradle](user-guide/plugins/dependency-track-maven-gradle.md)
142142
* [Dependency track - NodeJS](user-guide/plugins/dependency-track-nodejs.md)
143143
* [Dependency track - Python](user-guide/plugins/dependency-track-python.md)
144+
* [Devtron CD Trigger](user-guide/plugins/devtron-cd-trigger.md)
144145
* [GoLang-migrate](user-guide/plugins/golang-migrate.md)
145146
* [Jenkins](user-guide/plugins/jenkins.md)
146147
* [K6 Load Testing](user-guide/plugins/k6-load-testing.md)
Lines changed: 61 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,61 @@
1+
# Devtron-CD-Trigger
2+
3+
## Introduction
4+
The **Devtron CD Trigger** plugin allows you to trigger the PRE-CD, CD, or POST-CD stages of target Devtron App from within your current application workflow. This plugin offers flexibility in managing application dependencies and deployment sequences. For example, by incorporating this plugin at the pre-deployment stage of your application workflow, you can deploy another application that contains dependencies required by your current application, ensuring a coordinated deployment process.
5+
6+
### Prerequisites
7+
Before integrating the Devtron CD Trigger plugin, you need to properly configure the target Devtron App to ensure smooth execution.
8+
9+
---
10+
11+
## Steps
12+
1. Go to **Applications****Devtron Apps**.
13+
2. Click your application.
14+
3. Go to **App Configuration****Workflow Editor**.
15+
4. Click **New Workflow** and navigate to the **Build and Deploy from Source Code**.
16+
5. Fill the required fields in the **Create build pipeline** window and navigate to the **Create deployment pipeline**.
17+
6. Fill the required fields in the **Deployment Stage** window and navigate to the **Post-Deployment stage**.
18+
19+
{% hint style="warning" %}
20+
If you have already configured workflow, edit the deployment pipeline, and navigate to **Post-Deployment stage**.
21+
{% endhint %}
22+
23+
6. Under 'TASKS', click the **+ Add task** button.
24+
7. Select the **Devtron CD Trigger** plugin.
25+
8. Enter the following [user inputs](#user-inputs) with appropriate values.
26+
---
27+
28+
## User Inputs
29+
30+
### Task Name
31+
Enter the name of your task
32+
33+
e.g., `Triggers CD Pipeline`
34+
35+
### Description
36+
Add a brief explanation of the task and the reason for choosing the plugin. Include information for someone else to understand the purpose of the task.
37+
38+
e.g., `The Devtron CD Trigger plugin is integrated for triggering the CD stage of another application.`
39+
40+
### Input Variables
41+
42+
| Variable | Format | Description | Sample Value |
43+
| ------------------------ | ------------ | ----------- | ------------ |
44+
| DevtronApiToken | STRING | Enter target Devtron API token. | abc123DEFxyz456token789 |
45+
| DevtronEndpoint | STRING | Enter the target URL of Devtron. | https://devtron.example.com |
46+
| DevtronApp | STRING | Enter the target Devtron Application name/ID | plugin-demo |
47+
| DevtronEnv | STRING | Enter the target Environment name/ID. Required if JobPipeline is not given | preview |
48+
| StatusTimeoutSeconds | STRING | Enter the maximum time (in seconds) a user can wait for the application to deploy. Enter a positive integer value | 120 |
49+
| GitCommitHash | STRING | Enter the git hash from which user wants to deploy its application. By default it takes latest Artifact ID to deploy the application | cf19e4fd348589kjhsdjn092nfse01d2234235sdsg |
50+
| TargetTriggerStage | STRING | Enter the Trigger Stage PRE/DEPLOY/POST. Default value is `Deploy`. | PRE |
51+
52+
### Trigger/Skip Condition
53+
Here you can set conditions to execute or skip the task. You can select `Set trigger conditions` for the execution of a task or `Set skip conditions` to skip the task.
54+
55+
### Output Variables
56+
Devtron CD Trigger will not be generating an output variable.
57+
58+
Click **Update Pipeline**.
59+
60+
61+

0 commit comments

Comments
 (0)