Difference between revisions of "Jenkins Projects (aka Jobs) for GitHub"
From Gcube Wiki
Manuele.simi (Talk | contribs) (Created page with "= gCube GitHUb Template Project = The easiest way to create a new project is to clone the ''gCubeGitHubProjectTemplate'' project.") |
Manuele.simi (Talk | contribs) (→Source Code Management and Poll Triggers) |
||
(6 intermediate revisions by the same user not shown) | |||
Line 1: | Line 1: | ||
− | = gCube | + | = gCube GitHub Project Template = |
The easiest way to create a new project is to clone the ''gCubeGitHubProjectTemplate'' project. | The easiest way to create a new project is to clone the ''gCubeGitHubProjectTemplate'' project. | ||
+ | |||
+ | 1. In the Jenkins interface (Jenkins interface is available at [https://jenkins.d4science.org/ https://jenkins.d4science.org/]), select New Item from the options on the left panel: | ||
+ | |||
+ | [[File:Jenkins_newItem.png|200px]] | ||
+ | |||
+ | 2. In the new item page, assign a name to the project | ||
+ | |||
+ | 3. Scroll down until the bottom of the page and use the last option to create the new item from other existing. Insert ''gCubeGitHubProjectTemplate'' as input (it should auto-complete). | ||
+ | |||
+ | [[File:Jenkins_newItemFromGitHubTemplate.png|600px]] | ||
+ | |||
+ | and confirm with OK. | ||
+ | |||
+ | 4. In the new project page, you need to: | ||
+ | * uncheck the "Disable this project" checkbox | ||
+ | * provide the URL to the GitHub repo to build | ||
+ | |||
+ | [[File:Jenkins_newItemRequiredChanges.png|600px]] | ||
+ | |||
+ | That should be enough to try to build the project with a Jenkins job. | ||
+ | |||
+ | = Examples = | ||
+ | |||
+ | == Source Code Management and Poll Triggers == | ||
+ | |||
+ | * set option to "Git", | ||
+ | * provide the URL to your repo (e.g. https://code-repo.d4science.org/gCubeSystem/gxRest.git), | ||
+ | * set the credentials to ''git.gcube'', | ||
+ | * specify ''*/master'' as branch to build, | ||
+ | |||
+ | [[File:JenkinsGitHubSourceCodeManagement.png|1000px]] | ||
+ | |||
+ | In "Build triggers" section: | ||
+ | * check "GitHub hook trigger for GITScm polling" | ||
+ | * check "Poll SCM" option with no schedule defined. This setup basically tells Jenkins to poll your GitHub repo only when requested via the [[GitHub/Jenkins:_Setting_up_Webhooks#Webhook_on_the_GitHub_repository|webhook]]. | ||
+ | |||
+ | [[File:JenkinsGitHubBuildTriggers.png|1000px]] | ||
+ | |||
+ | ''Back to the [[Continuous_Integration_procedure_(2019) | CI guide]].'' | ||
+ | |||
+ | [[Category:Continuous_Integration]] |
Latest revision as of 00:29, 1 December 2019
gCube GitHub Project Template
The easiest way to create a new project is to clone the gCubeGitHubProjectTemplate project.
1. In the Jenkins interface (Jenkins interface is available at https://jenkins.d4science.org/), select New Item from the options on the left panel:
2. In the new item page, assign a name to the project
3. Scroll down until the bottom of the page and use the last option to create the new item from other existing. Insert gCubeGitHubProjectTemplate as input (it should auto-complete).
and confirm with OK.
4. In the new project page, you need to:
- uncheck the "Disable this project" checkbox
- provide the URL to the GitHub repo to build
That should be enough to try to build the project with a Jenkins job.
Examples
Source Code Management and Poll Triggers
- set option to "Git",
- provide the URL to your repo (e.g. https://code-repo.d4science.org/gCubeSystem/gxRest.git),
- set the credentials to git.gcube,
- specify */master as branch to build,
In "Build triggers" section:
- check "GitHub hook trigger for GITScm polling"
- check "Poll SCM" option with no schedule defined. This setup basically tells Jenkins to poll your GitHub repo only when requested via the webhook.
Back to the CI guide.