Skip to content

This operator creates, deploys, and manages the EDP Jenkins instance on Kubernetes and OpenShift. In addition, the Jenkins instance is equipped with the necessary plugins. There is also the ability to customize the Jenkins instance as well as to check the changes during the application creation

License

Notifications You must be signed in to change notification settings

zmotso/edp-jenkins-operator

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

codecov

Jenkins Operator

❗ Please refer to EDP documentation to get the notion of the main concepts and guidelines.

Get acquainted with the Jenkins Operator and the installation process as well as the local development, and architecture scheme.

Overview

Jenkins Operator creates, deploys and manages the EDP Jenkins instance, which is equipped with the necessary plugins, on Kubernetes and OpenShift. Also, Jenkins operator is responsible for creating Jenkins job's.

There is an ability to customize the Jenkins instance and to check changes during the application creation.

NOTE: Operator is platform-independent, that is why there is a unified instruction for deploying.

Prerequisites

  1. Linux machine or Windows Subsystem for Linux instance with Helm 3 installed;
  2. Cluster admin access to the cluster;
  3. EDP project/namespace is deployed by following the Install EDP instruction.

Installation

In order to install the EDP Jenkins Operator, follow the steps below:

  1. To add the Helm EPAMEDP Charts for local client, run "helm repo add":

    helm repo add epamedp https://epam.github.io/edp-helm-charts/stable
  2. Choose available Helm chart version:

    helm search repo epamedp/jenkins-operator -l

    Example response:

      NAME                      CHART VERSION   APP VERSION     DESCRIPTION
      epamedp/jenkins-operator  2.11.1          2.11.1          A Helm chart for EDP Jenkins Operator
      epamedp/jenkins-operator  2.11.0          2.11.0          A Helm chart for EDP Jenkins Operator
      epamedp/jenkins-operator  2.10.1          2.10.1          A Helm chart for EDP Jenkins Operator
      epamedp/jenkins-operator  2.10.0          2.10.0          A Helm chart for EDP Jenkins Operator
    

    NOTE: It is highly recommended to use the latest released version.

  3. Full chart parameters available in deploy-templates/README.md.

NOTE: You can add any number of shared libraries. For correct passing values you have to adjust it by index [i]:

--set jenkins.sharedLibraries[0].name="stub-name" --set jenkins.sharedLibraries[0].url="stub-url" --set jenkins.sharedLibraries[0].tag="stub-tag" --set jenkins.sharedLibraries[0].secret="stub-secret-name" --set jenkins.sharedLibraries[0].type="ssh"

NOTE: Adding private shared-library requires pre-condition before deploy - created secret with credentials to private repository:

Shared library secrets examples:

SSH secret:

kind: Secret
apiVersion: v1
metadata:
  name: <jenkins.sharedLibraries[i].secret>
  namespace: <edp-project>
data:
  id_rsa: private-key
  id_rsa.pub: private-key
  username: username
type: Opaque

Password secret:

kind: Secret
apiVersion: v1
metadata:
  name: <jenkins.sharedLibraries[i].secret>
  namespace: <edp-project>
data:
  first_name: first-name
  last_name: last-name
  password: password
  username: username
type: Opaque

Token secret:

kind: Secret
apiVersion: v1
metadata:
  name: <jenkins.sharedLibraries[i].secret>
  namespace: <edp-project>
data:
  password: token
  username: username
type: Opaque

NOTE: Due to the unstable work of the Jenkins plugin with the "token" secret type, it is recommended to use the "password" secret type. Simply add the token into the Password field.

  1. Install operator in the namespace with the helm command; find below the installation command example:
    helm install jenkins-operator epamedp/jenkins-operator --version <chart_version> --namespace <edp-project> --set name=jenkins-operator --set global.edpName=<edp-project> --set global.platform=<platform_type> --set global.dnsWildCard=<cluster_DNS_wildcard>
  2. Check the namespace that should contain operator deployment with your operator in a running status.

Local Development

In order to develop the operator, first set up a local environment. For details, please refer to the Local Development page.

Development versions are also available, please refer to the snapshot helm chart repository page.

Related Articles

About

This operator creates, deploys, and manages the EDP Jenkins instance on Kubernetes and OpenShift. In addition, the Jenkins instance is equipped with the necessary plugins. There is also the ability to customize the Jenkins instance as well as to check the changes during the application creation

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Go 98.2%
  • Other 1.8%