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.
- Agree to the terms and conditions.
- Click the Enable Now button.
- Enter Jenkins Host URL.
- Enter your User ID.
- Enter your API Token. Refer the section below.
- Click the Add Configuration button. The configuration will be complete.
- Click the Configure button to proceed to authorize Zoho Sprints to access Jenkins.
- Click the Accept button to complete integration.
- Login to Jenkins.
- Select the Profile menu in the top section.
- Click the Configure in the dropdown.
- 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.
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.
Example:
Custom Field input:
UDF1_BOOLEAN=123456
UDF1_TEXT=text value
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
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.
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.
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.