Jenkins integration
DevOps tools are built to facilitate collaboration, leverage automation, and enhance the ability to track and monitor process and progress. As the customer requirements pile up, the development and operations need to deliver outcomes in rapid phases. In particular, it is highly recommended for agile teams to adopt DevOps tool to organize their work and deliver on time.
Jenkins is a well-approved tool that can interact with Zoho Sprints in a secure manner and provide all the necessary support for your development teams.
Benefits of Jenkins integration
When it comes to CI/CD (continuous integration/continuous deployment), Jenkins is the top-notch automation tool that befriends developers and makes the build updates clutter-free. Implementing your agile team's work through a steady integration with Jenkins helps perform the following operations right while you work with different cases in your pipeline.
- Add work items, sprints, and releases without navigating to Zoho Sprints.
- Update work items, sprints, and releases.
- Start and complete sprints directly via Jenkins.
- Add the item, sprint, and release comments directly from Jenkins.
- Add feed status for every build update from Jenkins.
Your development related work items can be run directly from Jenkins and you can track them in Zoho Sprints.
Note: Users must install the latest version of Zoho Sprints plugin to enable Jenkins integration. Those with the previous version must update to the new version to continue using the integration.
Install Sprints-Jenkins Plugin
- Install the latest Sprints plugin for your Jenkins instance.
- Restart the Jenkins instance following installation.
Note: Portal Owner Auth details will be shared automatically when the Configure Jenkins from Zoho Sprints process is done.
Configure from Zoho Sprints
- Click the settings icon in the top-right corner. The Settings page will appear.
- Select to Others under Marketplace. The apps for integration will appear.
- Go to Jenkins app.
- Click the Configure button.
- Enter Jenkins Host URL.
- Enter your User ID.
- Enter your API Token.
- Click Configure.
To generate API Token
- Login to Jenkins.
- Select the Profile menu in the top section.
- Click the Configure link in the left section
- In the API token section, click the Add New Token button.
- Provide a name for the token.
- Click the Generate button.
- Copy the generated token since it will be shown only at the time of the creation.
View Build Details in Zoho Sprints
You can track all the build updates made in Jenkins from your Zoho Sprints team.
- Sign in to Zoho Sprints.
- Select the CI/CD option on the left navigation panel.
- Select Jenkins. All the build related logs are listed.
- Hover and click the View Details link to navigate to the build details. The build names and details are available.
- Hover and click the View log link to navigate to Jenkins and view the log.
Note: Click the Job name dropdown to select jobs.
Note:
Log: All the build logs that are triggered in your Jenkins build.
Build stability percentage and the build status information are available.
Item fields in Jenkins
The following fields will be available for you while you create items from your Jenkins account:
- Project Number: Enter the project number. Example: 14. Obtain number from project #P14.
- Sprint Number: Enter the sprint number. Example: 7. Obtain number from sprint SP7.
- Item Number: Enter the item number. Example: 9. Obtain number from item I9.
- Item Name: Enter the name of the item as in the Item title.
- Description: Describe the item.
- Assignees: Provide the email addresses of the item users (separated by commas)
- Type: Enter item type. Example: Task, Bug, or Story.
- Status: Specify item status. Example: To do.
- Priority: Specify priority level. Example: High.
- Start Date: Specify the item start date. Example: 2022-08-13T00:00:00Z
- End Date: Specify the item end date. Example: 2022-08-13T00:00:00Z
- Duration: Mention a tentative duration of the sprint. A sprint duration cannot exceed 8 weeks when strict scrum is enabled. And if strict scrum is disabled, it can last up to 30 weeks. Example: 2hrs 50min
- Custom Fields: Specify the custom field values here. If there are multiple custom fields, they should be mentioned in a new line.
Sprint fields in Jenkins
The following fields will be available for you while you create sprints from your Jenkins account:
- Project Number: Enter the project number. Example: 14. Obtain number from project #P14.
- Sprint Number: Enter the sprint number. Example: 7. Obtain number from sprint SP7.
- Sprint Name: Name of the sprint as in the sprint title.
- Description: Describe the sprint.
- Scrum Master: Mention the email address of the scrum master
- Sprint Users: Provide the email addresses of the sprint users (separated by commas)
- Start Date: Specify the sprint start date. Example: 2022-08-13T00:00:00Z
- End Date: Specify the sprint end date. Example: 2022-08-13T00:00:00Z
- Duration: Mention a tentative duration of the sprint. A sprint duration cannot exceed 8 weeks when strict scrum is enabled. And if strict scrum is disabled, it can last up to 30 weeks. Example: 2hrs 50min
- Custom Fields: Specify the custom field values here. If there are multiple custom fields, they should be mentioned in a new line.
- Example:
- UDF1_BOOLEAN=12345
- UDF1_TEXT=text value
Release fields in Jenkins
The following fields will be available for you while you create releases from your Jenkins account:
- Project Number: Enter the project number. Example: 14. Obtain number from project #P14.
- Release Name: Provide a name to the release. Example: 1. Obtain number from release R1.
- Release Goal: Describe the purpose of the release.
- Start Date: Enter the starting date of the release. Example: 2022-08-13T00:00:00Z
- Release Date: Enter the release date. Example: 2022-10-13T00:00:00Z
- Owners: Mention the email address of the owner separated by commas
- Release Stage: Specify the stage in which the release is currently in. Example: Planning
- Custom Fields: Specify the custom field values here. If there are multiple custom fields, they should be mentioned in a new line.
- Example:
- UDF1_BOOLEAN=12345
- UDF1_TEXT=text value
Build actions in Jenkins
The build actions supported in Jenkins include:
- Create work item
- Create sprint
- Create release
- Update item
- Update sprint
- Update release
- Start sprint
- Complete sprint
- Add item, release, and sprint comment
- Add feed status
- Create item on build failure
Create item from Jenkins
To add a work item from Jenkins:
- Sign in to your Jenkins account.
- Navigate to the Build.
- Click Configure from the left menu.
- Select Add build step under the Build section.
- Click [Zoho Sprints] Create a work item. The item fields will appear.
- Enter the item details. Refer here.
- Save and Apply your changes.
- Click Build Now to trigger the API.
Create sprint from Jenkins
To create sprint from Jenkins:
- Sign in to your Jenkins account.
- Navigate to the Build.
- Click Configure from the left menu.
- Select Add build step under the Build section.
- Click [Zoho Sprints] Create a sprint. The sprint fields will appear.
- Enter the sprint details. Refer here.
- Save and Apply your changes.
- Click Build Now to trigger the API.
Create release from Jenkins
To create release from Jenkins:
- Sign in to your Jenkins account.
- Navigate to the Build.
- Click Configure from the left menu.
- Select Add build step under the Build section.
- Click [Zoho Sprints] Create a release. The release fields will appear.
- Enter the release details. Refer here.
- Save and Apply your changes.
- Click Build Now to trigger the API.
Note:
- The stage should not be 'completed'.
- Release Time should be a minimum of three days.
Update item from Jenkins
To update item status from Jenkins:
- Sign in to your Jenkins account.
- Navigate to the Build.
- Click Configure from the left menu.
- Select Add build step under the Build section.
- Click [Zoho Sprints] Update a work item. The item fields will appear.
- Enter the relevant project, sprint, and item numbers. Refer here.
- Enter the relevant changes. For example, change status or priority.
- Save and Apply your changes.
- Click Build Now to trigger the API.
Note: You can change the status of the work items only in the active sprint.
Update sprint from Jenkins
To update item status from Jenkins:
- Sign in to your Jenkins account.
- Navigate to the Build.
- Click Configure from the left menu.
- Select Add build step under the Build section.
- Click [Zoho Sprints] Update a sprint. The sprint fields will appear.
- Enter the relevant project and sprint numbers. Refer here.
- Enter the relevant changes. For example, start and end dates or the sprint.
- Save and Apply your changes.
- Click Build Now to trigger the API.
Add feed status
You can directly add a status on your project feed right from Jenkins.
- Sign in to your Jenkins account.
- Navigate to the Build.
- Click Configure from the left menu.
- Select Add build step under the Build section.
- Click [Zoho Sprints] Add a feed status.
- Enter the relevant project number.
- Enter the content for your status in status section. Note: All the script related information will be automatically removed.
- Save and Apply your changes.
- Click Build Now to trigger the API.
Add comments to item
You can add a comment to your work item from Jenkins.
- Sign in to your Jenkins account.
- Navigate to the Build.
- Click Configure from the left menu.
- Select Add build step under the Build section.
- Click [Zoho Sprints] Add an item comment.
- Enter the relevant project, sprint, and item numbers.
- Enter the comment.
- Save and Apply your changes.
- Click Build Now to trigger the API.
Add comments to release
You can add a comment to your release from Jenkins.
- Sign in to your Jenkins account.
- Navigate to the Build.
- Click Configure from the left menu.
- Select Add build step under the Build section.
- Click [Zoho Sprints] Add a release comment.
- Enter the relevant project and release numbers.
- Enter the comment.
- Save and Apply your changes.
- Click Build Now to trigger the API.
Add comments to sprint
You can add a comment to your sprint from Jenkins.
- Sign in to your Jenkins account.
- Navigate to the Build.
- Click Configure from the left menu.
- Select Add build step under the Build section.
- Click [Zoho Sprints] Add a sprint comment. The sprint fields will appear.
- Enter the relevant project and sprint numbers.
- Enter the comment.
- Save and Apply your changes.
- Click Build Now to trigger the API.
Update a release
To update release:
- Sign in to your Jenkins account.
- Navigate to the Build.
- Click Configure from the left menu.
- Select Add build step under the Build section.
- Click [Zoho Sprints] Update a release. The release fields will appear.
- Enter the relevant project and release numbers.
- Enter the stage to which you'd like to update the release. Refer here.
- Save and Apply your changes.
- Click Build Now to trigger the API.
Start a sprint
To start a sprint from Jenkins
- Sign in to your Jenkins account.
- Navigate to the Build.
- Click Configure from the left menu.
- Select Add build step under the Build section.
- Click [Zoho Sprints] Start a sprint.
- Enter the relevant project and sprint numbers.
- Save and Apply your changes.
- Click Build Now to trigger the API.
Complete a sprint
To complete a sprint from Jenkins
- Sign in to your Jenkins account.
- Navigate to the Build.
- Click Configure from the left menu.
- Select Add build step under the Build section.
- Click [Zoho Sprints] Complete a sprint.
- Enter the relevant project and sprint numbers.
- Save and Apply your changes.
- Click Build Now to trigger the API.
Post build actions in Jenkins
You can perform all the above mentioned actions as Post Build actions from your Jenkins account. Additionally, you can create a new item at the event of build failure.
Zoho CRM Training Programs
Learn how to use the best tools for sales force automation and better customer engagement from Zoho's implementation specialists.
Zoho DataPrep Personalized Demo
If you'd like a personalized walk-through of our data preparation tool, please request a demo and we'll be happy to show you how to get the best out of Zoho DataPrep.
- Zoho Workerly Home
- Forums
- Connect With Us:
- Zoho Recruit Home
- Forums
- Connect With Us:
You are currently viewing the help pages of Qntrl’s earlier version. Click here to view our latest version—Qntrl 3.0's help articles.
New to Zoho Survey?
Zoho Sheet Resources
Zoho Forms Resources
New to Zoho Sign?
Zoho Sign Resources
Sign, Paperless!
New to Zoho TeamInbox?
Zoho TeamInbox Resources
New to Zoho ZeptoMail?
Zoho DataPrep Resources
Design. Discuss. Deliver.
New to Zoho Workerly?
New to Zoho Recruit?
New to Zoho CRM?
New to Zoho Projects?
New to Zoho Sprints?
New to Zoho Assist?
New to Bigin?
Related Articles
Bitbucket integration
Track your code changes, manage your repositories, add commits, and pull requests from the work item details page in Zoho Sprints using the Bitbucket integration. Access control: Team Owner Authorize Bitbucket account Click the gear icon in the ...GitHub integration
Track your code changes and improve and revise them using the developer-friendly platform: GitHub. Integrate your Zoho Sprints workspace with GitHub and manage repositories. Access control: Workspace Owner Authorize Github account Click the gear icon ...GitLab integration
Manage your GitLab repositories in Zoho Sprints. Map the repositories to relevant projects, attach commits, and pull requests in the work item details page. Access control: Workspace Owner Authorize GitLab account Click the gear icon in the top-right ...Zoho Analytics integration
One can oversee the course of a business and forecast its future with a wide range of detailed reports. Besides the inbuilt reports, you can now generate customized reports by integrating Zoho Sprints account with Zoho Analytics. Enable the ...Microsoft Office 365 integration
Integrate your Zoho Sprints workspace with your Microsoft Office 365 account and get your work items mapped to Office 365 tasks and calendar. You can also map the meetings to your Office calendar and never miss any meet ups. Access privileges: ...
New to Zoho LandingPage?
Zoho LandingPage Resources