Chapter 2. Adding your application to Jenkins
When you select Jenkins as your CI provider while creating an application, you must add your application to Jenkins. Proper integration ensures that your pipeline aligns with your CI/CD workflows and operates seamlessly.
Prerequisites
- You must have installed and configured Jenkins in your environment.
- You must have the necessary permissions to create and manage Jenkins jobs.
- You must have added correct credentials for the Jenkins pipeline during the post RHTAP install phase.
-
Review the
Jenkinsfileand ensure it aligns with your Jenkins configuration. For example, you may need to update the agent settings to limit where the pipeline can run. -
Ensure that the Jenkins agent has the necessary binaries installed:
git,curl,jq,yq,buildah,syft,cosign,python3, andtree. If the pipeline run fails at the start, it likely indicates that one or more binaries are missing.
Procedure
- Log in to your Jenkins instance.
- From the Jenkins dashboard, select New Item.
Enter a name for your pipeline job and select Pipeline project (for example,
secure-jenkins).NoteThe name of your pipeline job must match the name of the application for which you are adding Jenkins CI. If the names do not match, the pipeline will run on Jenkins but will not be visible on RHDH.
-
(Optional) If you want to use a different pipeline name, update the
jenkins.io/job-full-namefield in thecatalog-info.yamlfile in the source repository with the pipeline name you choose.
-
(Optional) If you want to use a different pipeline name, update the
- Select OK to create the job.
- On the Configure > General page, navigate to the Pipeline section, and from the Definition drop-down list, select Pipeline script from SCM.
- From the SCM drop-down list, select Git.
In the Repository URL field, enter the Jenkins source repository URL.
- On the Red Hat Developer Hub platform, from the Catalog, select an appropriate application.
- Go to the Overview tab and select View Source to open the repository where your application’s source code is housed.
-
In the Branches to build section, enter
*/main. - Select Save. The system displays the live-jenkins (name of your job) page.
Select Build Now. The system starts the build pipeline. Wait until the build is complete.
- In the Stage View section, select Pipeline Overview to visualize the pipeline run.
- Select Pipeline Console to review the live logs of each stage of the pipeline run.
Verification
After integrating your application with Jenkins, review various aspects of the Jenkins pipeline on the Red Hat Developer Hub platform.
From the Catalog, select the appropriate application or component.
- Go to the CI tab to view the Jenkins project. For the appropriate Jenkins job, using the Actions column, you can view, rerun, and view history of the job. The system displays the job overview with the status of latest run.
- Go to the CD tab and select the appropriate card to view deployment details, such as the commit message, author name, and deployment history managed by ArgoCD and GitOps.
- In the Catalog, from the Kind dropdown list, select Resource. The system displays Jenkins GitOps jobs. Select and review the appropriate GitOps resource.
- Go to the Topology tab to visualize your application’s deployment within the development namespace.
Completing these steps ensures seamless integration of your application with Jenkins, enabling efficient and reliable CI/CD workflows.
Revised on 2025-02-06 18:02:18 UTC
