Skip to content

Commit

Permalink
Added all necessary files and parameters for plugin automated release…
Browse files Browse the repository at this point in the history
… in jenkinsci repo
  • Loading branch information
IBA-mainframe-dev committed Apr 7, 2023
1 parent 6f03355 commit 35ba9e8
Show file tree
Hide file tree
Showing 9 changed files with 82 additions and 23 deletions.
12 changes: 12 additions & 0 deletions .github/dependabot.yml
Original file line number Diff line number Diff line change
@@ -0,0 +1,12 @@
# https://docs.github.com/en/code-security/dependabot/dependabot-version-updates/configuration-options-for-the-dependabot.yml-file
---
version: 2
updates:
- package-ecosystem: "maven"
directory: "/"
schedule:
interval: "weekly"
- package-ecosystem: "github-actions"
directory: "/"
schedule:
interval: "weekly"
3 changes: 3 additions & 0 deletions .github/release-drafter.yml
Original file line number Diff line number Diff line change
@@ -0,0 +1,3 @@
# https://github.com/jenkinsci/.github/blob/master/.github/release-drafter.adoc
_extends: .github
tag-template: zdevops-$NEXT_MINOR_VERSION
17 changes: 17 additions & 0 deletions .github/workflows/release-drafter.yml
Original file line number Diff line number Diff line change
@@ -0,0 +1,17 @@
# Note: additional setup is required, see https://github.com/jenkinsci/.github/blob/master/.github/release-drafter.adoc

name: Release Drafter

on:
push:
branches:
- "main"

jobs:
update_release_draft:
runs-on: ubuntu-latest
steps:
# Drafts your next Release notes as Pull Requests are merged into the default branch
- uses: release-drafter/release-drafter@v5
env:
GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
1 change: 0 additions & 1 deletion .gitignore
Original file line number Diff line number Diff line change
Expand Up @@ -5,4 +5,3 @@ target
.idea/
.vscode
build/
.gradle/
7 changes: 7 additions & 0 deletions .mvn/extensions.xml
Original file line number Diff line number Diff line change
@@ -0,0 +1,7 @@
<extensions xmlns="http://maven.apache.org/EXTENSIONS/1.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/EXTENSIONS/1.0.0 http://maven.apache.org/xsd/core-extensions-1.0.0.xsd">
<extension>
<groupId>io.jenkins.tools.incrementals</groupId>
<artifactId>git-changelist-maven-extension</artifactId>
<version>1.6</version>
</extension>
</extensions>
2 changes: 2 additions & 0 deletions .mvn/maven.config
Original file line number Diff line number Diff line change
@@ -0,0 +1,2 @@
-Pconsume-incrementals
-Pmight-produce-incrementals
36 changes: 26 additions & 10 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,18 +1,34 @@
# Zowe z/OS DevOps Jenkins plugin
# Zowe zDevOps Jenkins plugin

## Main features
- Secure and modern connection of Jenkins to the mainframes through the use of z/OSMF REST API
- The functionality is based on the Zowe Kotlin SDK methods, such as JCL jobs submission, download, allocate, remove, write to the dataset, etc., with a log collected upon finish
- Multiple connections to various mainframes - z/OS Connections List where you can save all the necessary systems and credentials, all data are safely stored under the protection of Jenkins Credentials manager
- Agent-less solution
- z/OSMF connection validation
- Fast execution and functional extensibility
## About the plugin
The Zowe zDevOps Jenkins Plugin by [IBA Group](https://ibagroupit.com/?utm_campaign=IBA_W-Mainframe&utm_source=jenkins&utm_medium=referral&utm_content=description_zdevops) is an open-source, secure , and reliable agent-less Jenkins plugin that makes it possible to perform most of the actual tasks on the mainframe, managing it with a modern native mainframe zOSMF REST API and the capabilities of available zOSMF SDKs.

## Advantages
- Secure and modern connection of Jenkins to the mainframes through the use of zOSMF REST API.
- The functionality is based on the Kotlin SDK methods, such as JCL jobs submission, download, allocate, write to the dataset, etc., with a log collected upon completion.
- Multiple connections to various mainframes—z/OS Connections List where you can save all the necessary systems and credentials; all data is safely stored under the protection of Jenkins Credentials manager.
- Agent-less.
- z/OSMF connection validation.
- Fast execution and functional extensibility.

## About us
With over 30 years of experience in the mainframe domain, IBA Group is committed to maximizing your mainframe investment and enhancing your IT flexibility.

One of the services we offer is Mainframe DevOps. Our approach is highly flexible, as we work with customers to choose the essential toolset for establishing a pipeline based on their preferences, existing tools, and the latest open-source opportunities (such as Zowe and plugins).

We are also familiar with [Mainframe DevOps Solutions](https://mainframe.ibagroupit.com/?utm_campaign=IBA_W-Mainframe&utm_source=jenkins&utm_medium=referral&utm_content=description_zdevops) of 2023 that can help modernize your mainframe and keep you competitive.

We value your feedback and welcome any suggestions, proposals, or even complaints.

Please feel free to contact us or schedule a call with our Mainframe DevOps expert.

Thank you for considering IBA Group for your mainframe needs.

## Manual plugin installation by the .hpi executable file
The plugin are packaged as self-contained <b>.hpi</b> files, which have all the necessary code, images, and other resources which the plugin needs to operate successfully.

### <b>Already packaged and tested installation .hpi file can be downloaded from a link from a nearby GitHub repository:</b>
### <b>[Zowe z/OS DevOps plugin installation .hpi file](https://github.com/IBA-mainframe-dev/Global-Repository-for-Mainframe-Developers/blob/master/Jenkins%20zOS%20DevOps%20plugin%20installable%20hpi/zos-devops.hpi)</b>
### <b>[Zowe zDevOps plugin installation .hpi file](https://github.com/IBA-mainframe-dev/Global-Repository-for-Mainframe-Developers/blob/master/Jenkins%20zOS%20DevOps%20plugin%20installable%20hpi/zos-devops.hpi)</b>

Assuming a <b>.hpi</b> file has been downloaded, a logged-in Jenkins administrator may upload the file from within the web UI:
1. Navigate to the <b>Manage Jenkins > Manage Plugins</b> page in the web UI.
Expand All @@ -21,7 +37,7 @@ Assuming a <b>.hpi</b> file has been downloaded, a logged-in Jenkins administrat
4. <b>Deploy</b> the plugin file.

## Manual Jenkins plugin installation (Installation via source code build and .hpi file upload)
1. Download the Zowe Jenkins z/OS DevOps plugin source code from its [official GitHub repository](https://github.com/jenkinsci/zdevops-plugin)
1. Download the Zowe zDevOps Jenkins plugin source code from its [official GitHub repository](https://github.com/jenkinsci/zdevops-plugin)
2. It is necessary to build the project with the help of the Maven Build Tool
3. To generate the ```target``` dir with generated-sources - you have to run the Maven command: ```mvn localizer:generate```
4. Next, you need to generate an installation file: .hpi or .jpi file (both are installation files for the Jenkins plugin). This can be done by executing Maven command ```mvn install``` or by ```mvn hpi:hpi```.
Expand Down
25 changes: 14 additions & 11 deletions pom.xml
Original file line number Diff line number Diff line change
Expand Up @@ -4,23 +4,23 @@
<parent>
<groupId>org.jenkins-ci.plugins</groupId>
<artifactId>plugin</artifactId>
<version>4.51</version>
<version>4.55</version>
<relativePath />
</parent>

<groupId>io.jenkins.plugins</groupId>
<artifactId>zdevops</artifactId>
<version>0.1.0-SNAPSHOT</version>
<name>z/OS DevOps</name>
<version>${revision}${changelist}</version>
<name>Zowe zDevOps</name>
<groupId>io.jenkins.plugins</groupId>
<packaging>hpi</packaging>

<url>https://github.com/jenkinsci/${project.artifactId}-plugin</url>
<packaging>hpi</packaging>


<properties>
<revision>0.1.0</revision>
<changelist>999999-SNAPSHOT</changelist>
<changelist>-SNAPSHOT</changelist>
<jenkins.version>2.361</jenkins.version>
<java.level>11</java.level>
<java.version>11</java.version>
<kotlin.version>1.7.0</kotlin.version>
<kotlin.compiler.incremental>true</kotlin.compiler.incremental>
Expand All @@ -29,6 +29,9 @@
<kotlin.compiler.jvmTarget>11</kotlin.compiler.jvmTarget>
<tests.skip>true</tests.skip>
<project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
<!-- TODO fix all warnings -->
<spotbugs.threshold>High</spotbugs.threshold>
<gitHubRepo>jenkinsci/${project.artifactId}-plugin</gitHubRepo>
</properties>

<licenses>
Expand All @@ -47,9 +50,9 @@
</developers>

<scm>
<connection>scm:git:git://github.com/jenkinsci/${project.artifactId}-plugin.git</connection>
<developerConnection>scm:git:[email protected]:jenkinsci/${project.artifactId}-plugin.git</developerConnection>
<url>https://github.com/jenkinsci/${project.artifactId}-plugin</url>
<connection>scm:git:https://github.com/${gitHubRepo}.git</connection>
<developerConnection>scm:git:[email protected]:${gitHubRepo}.git</developerConnection>
<url>https://github.com/${gitHubRepo}</url>
<tag>${scmTag}</tag>
</scm>

Expand Down Expand Up @@ -301,7 +304,7 @@
<dependency>
<groupId>junit</groupId>
<artifactId>junit</artifactId>
<version>4.13</version>
<version>4.13.2</version>
<scope>test</scope>
</dependency>

Expand Down
2 changes: 1 addition & 1 deletion src/main/resources/index.jelly
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
<?jelly escape-by-default='true'?>
<div>
Mainframes DevOps automation plugin, working through z/OSMF REST API and using Zowe Kotlin SDK.
Mainframes z/OS automation plugin, working through z/OSMF REST API and using Zowe Kotlin SDK.
</div>

0 comments on commit 35ba9e8

Please sign in to comment.