1308 lines
58 KiB
HTML
1308 lines
58 KiB
HTML
<!doctype html>
|
|
<html lang="en" class="no-js">
|
|
<head>
|
|
<meta charset="utf-8">
|
|
<meta name="viewport" content="width=device-width, initial-scale=1, shrink-to-fit=no">
|
|
<meta name="generator" content="Hugo 0.62.2" />
|
|
|
|
<META NAME="ROBOTS" CONTENT="NOINDEX, NOFOLLOW">
|
|
|
|
<link rel="alternate" type="application/rss+xml" href="https://jenkinsci.github.io/kubernetes-operator/docs/developer-guide/preview/index.xml">
|
|
|
|
|
|
<link rel="shortcut icon" href="/favicons/favicon.ico" >
|
|
<link rel="apple-touch-icon" href="/kubernetes-operator/favicons/apple-touch-icon-180x180.png" sizes="180x180">
|
|
<link rel="icon" type="image/png" href="/kubernetes-operator/favicons/favicon-16x16.png" sizes="16x16">
|
|
<link rel="icon" type="image/png" href="/kubernetes-operator/favicons/favicon-32x32.png" sizes="32x32">
|
|
<link rel="icon" type="image/png" href="/kubernetes-operator/favicons/android-36x36.png" sizes="36x36">
|
|
<link rel="icon" type="image/png" href="/kubernetes-operator/favicons/android-48x48.png" sizes="48x48">
|
|
<link rel="icon" type="image/png" href="/kubernetes-operator/favicons/android-72x72.png" sizes="72x72">
|
|
<link rel="icon" type="image/png" href="/kubernetes-operator/favicons/android-96x196.png" sizes="96x196">
|
|
<link rel="icon" type="image/png" href="/kubernetes-operator/favicons/android-144x144.png" sizes="144x144">
|
|
<link rel="icon" type="image/png" href="/kubernetes-operator/favicons/android-192x192.png"sizes="192x192">
|
|
|
|
<title>Developer Guide | Jenkins Operator</title><meta property="og:title" content="Developer Guide" />
|
|
<meta property="og:description" content="Jenkins Operator for developers
|
|
" />
|
|
<meta property="og:type" content="website" />
|
|
<meta property="og:url" content="https://jenkinsci.github.io/kubernetes-operator/docs/developer-guide/preview/" />
|
|
<meta property="og:updated_time" content="2020-02-09T00:00:00+00:00" /><meta property="og:site_name" content="Jenkins Operator" />
|
|
<meta itemprop="name" content="Developer Guide">
|
|
<meta itemprop="description" content="Jenkins Operator for developers
|
|
"><meta name="twitter:card" content="summary"/>
|
|
<meta name="twitter:title" content="Developer Guide"/>
|
|
<meta name="twitter:description" content="Jenkins Operator for developers
|
|
"/>
|
|
|
|
|
|
|
|
|
|
|
|
<link rel="preload" href="/kubernetes-operator/scss/main.min.6c58fba96b88d035ce071c346f084a9dc4dedee4e80eb3724fe530520541a4ec.css" as="style">
|
|
<link href="/kubernetes-operator/scss/main.min.6c58fba96b88d035ce071c346f084a9dc4dedee4e80eb3724fe530520541a4ec.css" rel="stylesheet" integrity="">
|
|
|
|
<script
|
|
src="https://code.jquery.com/jquery-3.3.1.min.js"
|
|
integrity="sha256-FgpCb/KJQlLNfOu91ta32o/NMZxltwRo8QtmkMRdAu8="
|
|
crossorigin="anonymous"></script>
|
|
|
|
|
|
<title>Developer Guide | Jenkins Operator</title>
|
|
</head>
|
|
<body class="td-section">
|
|
<header>
|
|
|
|
<nav class="js-navbar-scroll navbar navbar-expand navbar-dark flex-column flex-md-row td-navbar">
|
|
<a class="navbar-brand" href="/kubernetes-operator/">
|
|
<img style="width: 32px; height: 32px; margin-right: 7.5px;" src="/kubernetes-operator/img/logo.svg"></img><span class="text-uppercase font-weight-bold">Jenkins Operator</span>
|
|
</a>
|
|
<div class="td-navbar-nav-scroll ml-md-auto" id="main_navbar">
|
|
<ul class="navbar-nav mt-2 mt-lg-0">
|
|
<li class="nav-item mr-4 mb-2 mb-lg-0">
|
|
<a class="nav-link" href="/kubernetes-operator/about"><span>What's the Jenkins Operator?</span></a>
|
|
</li>
|
|
<li class="nav-item mr-4 mb-2 mb-lg-0">
|
|
<a class="nav-link" href="/kubernetes-operator/docs"><span>Documentation</span></a>
|
|
</li>
|
|
|
|
</ul>
|
|
</div>
|
|
<div class="navbar-nav d-none d-lg-block">
|
|
<input type="search" class="form-control td-search-input" placeholder=" Search this site…" aria-label="Search this site…" autocomplete="off">
|
|
</div>
|
|
</nav>
|
|
|
|
</header>
|
|
<div class="container-fluid td-outer">
|
|
<div class="td-main">
|
|
<div class="row flex-xl-nowrap">
|
|
<div class="col-12 col-md-3 col-xl-2 td-sidebar d-print-none">
|
|
|
|
|
|
|
|
|
|
|
|
<div id="td-sidebar-menu" class="td-sidebar__inner">
|
|
|
|
<form class="td-sidebar__search d-flex align-items-center">
|
|
|
|
<input type="search" class="form-control td-search-input" placeholder=" Search this site…" aria-label="Search this site…" autocomplete="off">
|
|
|
|
<button class="btn btn-link td-sidebar__toggle d-md-none p-0 ml-3 fas fa-bars" type="button" data-toggle="collapse" data-target="#td-section-nav" aria-controls="td-docs-nav" aria-expanded="false" aria-label="Toggle section navigation">
|
|
</button>
|
|
</form>
|
|
|
|
<nav class="collapse td-sidebar-nav pt-2 pl-4" id="td-section-nav">
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<ul class="td-sidebar-nav__section pr-md-3">
|
|
<li class="td-sidebar-nav__section-title">
|
|
<a href="/kubernetes-operator/docs/" class="align-left pl-0 pr-2 td-sidebar-link td-sidebar-link__section">Documentation</a>
|
|
</li>
|
|
<ul>
|
|
<li class="collapse show" id="kubernetes-operator-docs">
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<ul class="td-sidebar-nav__section pr-md-3">
|
|
<li class="td-sidebar-nav__section-title">
|
|
<a href="/kubernetes-operator/docs/installation/" class="align-left pl-0 pr-2 collapsed td-sidebar-link td-sidebar-link__section">Installation</a>
|
|
</li>
|
|
<ul>
|
|
<li class="collapse " id="kubernetes-operator-docs-installation">
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<ul class="td-sidebar-nav__section pr-md-3">
|
|
<li class="td-sidebar-nav__section-title">
|
|
<a href="/kubernetes-operator/docs/installation/preview/" class="align-left pl-0 pr-2 collapsed td-sidebar-link td-sidebar-link__section">Installation - Preview</a>
|
|
</li>
|
|
<ul>
|
|
<li class="collapse " id="kubernetes-operator-docs-installation-preview">
|
|
|
|
|
|
|
|
</li>
|
|
</ul>
|
|
</ul>
|
|
|
|
|
|
|
|
</li>
|
|
</ul>
|
|
</ul>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<ul class="td-sidebar-nav__section pr-md-3">
|
|
<li class="td-sidebar-nav__section-title">
|
|
<a href="/kubernetes-operator/docs/how-it-works/" class="align-left pl-0 pr-2 collapsed td-sidebar-link td-sidebar-link__section">How it works</a>
|
|
</li>
|
|
<ul>
|
|
<li class="collapse " id="kubernetes-operator-docs-how-it-works">
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<a class="td-sidebar-link td-sidebar-link__page " id="m-kubernetes-operator-docs-how-it-works-architecture-and-design" href="/kubernetes-operator/docs/how-it-works/architecture-and-design/">Architecture and design</a>
|
|
|
|
|
|
|
|
|
|
|
|
<a class="td-sidebar-link td-sidebar-link__page " id="m-kubernetes-operator-docs-how-it-works-jenkins-docker-images" href="/kubernetes-operator/docs/how-it-works/jenkins-docker-images/">Jenkins Docker Images</a>
|
|
|
|
|
|
</li>
|
|
</ul>
|
|
</ul>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<ul class="td-sidebar-nav__section pr-md-3">
|
|
<li class="td-sidebar-nav__section-title">
|
|
<a href="/kubernetes-operator/docs/getting-started/" class="align-left pl-0 pr-2 collapsed td-sidebar-link td-sidebar-link__section">Getting Started</a>
|
|
</li>
|
|
<ul>
|
|
<li class="collapse " id="kubernetes-operator-docs-getting-started">
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<ul class="td-sidebar-nav__section pr-md-3">
|
|
<li class="td-sidebar-nav__section-title">
|
|
<a href="/kubernetes-operator/docs/getting-started/latest/" class="align-left pl-0 pr-2 collapsed td-sidebar-link td-sidebar-link__section">Latest (v0.5.x)</a>
|
|
</li>
|
|
<ul>
|
|
<li class="collapse " id="kubernetes-operator-docs-getting-started-latest">
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<a class="td-sidebar-link td-sidebar-link__page " id="m-kubernetes-operator-docs-getting-started-latest-deploy-jenkins" href="/kubernetes-operator/docs/getting-started/latest/deploy-jenkins/">Deploy Jenkins</a>
|
|
|
|
|
|
|
|
|
|
|
|
<a class="td-sidebar-link td-sidebar-link__page " id="m-kubernetes-operator-docs-getting-started-latest-configuration" href="/kubernetes-operator/docs/getting-started/latest/configuration/">Configuration</a>
|
|
|
|
|
|
|
|
|
|
|
|
<a class="td-sidebar-link td-sidebar-link__page " id="m-kubernetes-operator-docs-getting-started-latest-customization" href="/kubernetes-operator/docs/getting-started/latest/customization/">Customization</a>
|
|
|
|
|
|
|
|
|
|
|
|
<a class="td-sidebar-link td-sidebar-link__page " id="m-kubernetes-operator-docs-getting-started-latest-configure-backup-and-restore" href="/kubernetes-operator/docs/getting-started/latest/configure-backup-and-restore/">Configure backup and restore</a>
|
|
|
|
|
|
|
|
|
|
|
|
<a class="td-sidebar-link td-sidebar-link__page " id="m-kubernetes-operator-docs-getting-started-latest-aks" href="/kubernetes-operator/docs/getting-started/latest/aks/">AKS</a>
|
|
|
|
|
|
|
|
|
|
|
|
<a class="td-sidebar-link td-sidebar-link__page " id="m-kubernetes-operator-docs-getting-started-latest-custom-backup-and-restore" href="/kubernetes-operator/docs/getting-started/latest/custom-backup-and-restore/">Custom Backup and Restore Providers</a>
|
|
|
|
|
|
|
|
|
|
|
|
<a class="td-sidebar-link td-sidebar-link__page " id="m-kubernetes-operator-docs-getting-started-latest-notifications" href="/kubernetes-operator/docs/getting-started/latest/notifications/">Notifications</a>
|
|
|
|
|
|
|
|
|
|
|
|
<a class="td-sidebar-link td-sidebar-link__page " id="m-kubernetes-operator-docs-getting-started-latest-openshift" href="/kubernetes-operator/docs/getting-started/latest/openshift/">OpenShift</a>
|
|
|
|
|
|
|
|
|
|
|
|
<a class="td-sidebar-link td-sidebar-link__page " id="m-kubernetes-operator-docs-getting-started-latest-diagnostics" href="/kubernetes-operator/docs/getting-started/latest/diagnostics/">Diagnostics</a>
|
|
|
|
|
|
|
|
|
|
|
|
<a class="td-sidebar-link td-sidebar-link__page " id="m-kubernetes-operator-docs-getting-started-latest-schema" href="/kubernetes-operator/docs/getting-started/latest/schema/">Schema</a>
|
|
|
|
|
|
</li>
|
|
</ul>
|
|
</ul>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<ul class="td-sidebar-nav__section pr-md-3">
|
|
<li class="td-sidebar-nav__section-title">
|
|
<a href="/kubernetes-operator/docs/getting-started/preview/" class="align-left pl-0 pr-2 collapsed td-sidebar-link td-sidebar-link__section">Preview</a>
|
|
</li>
|
|
<ul>
|
|
<li class="collapse " id="kubernetes-operator-docs-getting-started-preview">
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<a class="td-sidebar-link td-sidebar-link__page " id="m-kubernetes-operator-docs-getting-started-preview-deploy-jenkins" href="/kubernetes-operator/docs/getting-started/preview/deploy-jenkins/">Deploy Jenkins</a>
|
|
|
|
|
|
|
|
|
|
|
|
<a class="td-sidebar-link td-sidebar-link__page " id="m-kubernetes-operator-docs-getting-started-preview-configuration" href="/kubernetes-operator/docs/getting-started/preview/configuration/">Configuration</a>
|
|
|
|
|
|
|
|
|
|
|
|
<a class="td-sidebar-link td-sidebar-link__page " id="m-kubernetes-operator-docs-getting-started-preview-customization" href="/kubernetes-operator/docs/getting-started/preview/customization/">Customization</a>
|
|
|
|
|
|
|
|
|
|
|
|
<a class="td-sidebar-link td-sidebar-link__page " id="m-kubernetes-operator-docs-getting-started-preview-configure-backup-and-restore" href="/kubernetes-operator/docs/getting-started/preview/configure-backup-and-restore/">Configure backup and restore</a>
|
|
|
|
|
|
|
|
|
|
|
|
<a class="td-sidebar-link td-sidebar-link__page " id="m-kubernetes-operator-docs-getting-started-preview-aks" href="/kubernetes-operator/docs/getting-started/preview/aks/">AKS</a>
|
|
|
|
|
|
|
|
|
|
|
|
<a class="td-sidebar-link td-sidebar-link__page " id="m-kubernetes-operator-docs-getting-started-preview-custom-backup-and-restore" href="/kubernetes-operator/docs/getting-started/preview/custom-backup-and-restore/">Custom Backup and Restore Providers</a>
|
|
|
|
|
|
|
|
|
|
|
|
<a class="td-sidebar-link td-sidebar-link__page " id="m-kubernetes-operator-docs-getting-started-preview-notifications" href="/kubernetes-operator/docs/getting-started/preview/notifications/">Notifications</a>
|
|
|
|
|
|
|
|
|
|
|
|
<a class="td-sidebar-link td-sidebar-link__page " id="m-kubernetes-operator-docs-getting-started-preview-openshift" href="/kubernetes-operator/docs/getting-started/preview/openshift/">OpenShift</a>
|
|
|
|
|
|
|
|
|
|
|
|
<a class="td-sidebar-link td-sidebar-link__page " id="m-kubernetes-operator-docs-getting-started-preview-diagnostics" href="/kubernetes-operator/docs/getting-started/preview/diagnostics/">Diagnostics</a>
|
|
|
|
|
|
|
|
|
|
|
|
<a class="td-sidebar-link td-sidebar-link__page " id="m-kubernetes-operator-docs-getting-started-preview-schema" href="/kubernetes-operator/docs/getting-started/preview/schema/">Schema</a>
|
|
|
|
|
|
</li>
|
|
</ul>
|
|
</ul>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<ul class="td-sidebar-nav__section pr-md-3">
|
|
<li class="td-sidebar-nav__section-title">
|
|
<a href="/kubernetes-operator/docs/getting-started/v0.4.x/" class="align-left pl-0 pr-2 collapsed td-sidebar-link td-sidebar-link__section">v0.4.x</a>
|
|
</li>
|
|
<ul>
|
|
<li class="collapse " id="kubernetes-operator-docs-getting-started-v0-4-x">
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<a class="td-sidebar-link td-sidebar-link__page " id="m-kubernetes-operator-docs-getting-started-v0-4-x-deploy-jenkins" href="/kubernetes-operator/docs/getting-started/v0.4.x/deploy-jenkins/">Deploy Jenkins</a>
|
|
|
|
|
|
|
|
|
|
|
|
<a class="td-sidebar-link td-sidebar-link__page " id="m-kubernetes-operator-docs-getting-started-v0-4-x-configuration" href="/kubernetes-operator/docs/getting-started/v0.4.x/configuration/">Configuration</a>
|
|
|
|
|
|
|
|
|
|
|
|
<a class="td-sidebar-link td-sidebar-link__page " id="m-kubernetes-operator-docs-getting-started-v0-4-x-customization" href="/kubernetes-operator/docs/getting-started/v0.4.x/customization/">Customization</a>
|
|
|
|
|
|
|
|
|
|
|
|
<a class="td-sidebar-link td-sidebar-link__page " id="m-kubernetes-operator-docs-getting-started-v0-4-x-aks" href="/kubernetes-operator/docs/getting-started/v0.4.x/aks/">AKS</a>
|
|
|
|
|
|
|
|
|
|
|
|
<a class="td-sidebar-link td-sidebar-link__page " id="m-kubernetes-operator-docs-getting-started-v0-4-x-configure-backup-and-restore" href="/kubernetes-operator/docs/getting-started/v0.4.x/configure-backup-and-restore/">Configure backup and restore</a>
|
|
|
|
|
|
|
|
|
|
|
|
<a class="td-sidebar-link td-sidebar-link__page " id="m-kubernetes-operator-docs-getting-started-v0-4-x-custom-backup-and-restore" href="/kubernetes-operator/docs/getting-started/v0.4.x/custom-backup-and-restore/">Custom Backup and Restore Providers</a>
|
|
|
|
|
|
|
|
|
|
|
|
<a class="td-sidebar-link td-sidebar-link__page " id="m-kubernetes-operator-docs-getting-started-v0-4-x-notifications" href="/kubernetes-operator/docs/getting-started/v0.4.x/notifications/">Notifications</a>
|
|
|
|
|
|
|
|
|
|
|
|
<a class="td-sidebar-link td-sidebar-link__page " id="m-kubernetes-operator-docs-getting-started-v0-4-x-openshift" href="/kubernetes-operator/docs/getting-started/v0.4.x/openshift/">OpenShift</a>
|
|
|
|
|
|
|
|
|
|
|
|
<a class="td-sidebar-link td-sidebar-link__page " id="m-kubernetes-operator-docs-getting-started-v0-4-x-diagnostics" href="/kubernetes-operator/docs/getting-started/v0.4.x/diagnostics/">Diagnostics</a>
|
|
|
|
|
|
|
|
|
|
|
|
<a class="td-sidebar-link td-sidebar-link__page " id="m-kubernetes-operator-docs-getting-started-v0-4-x-schema" href="/kubernetes-operator/docs/getting-started/v0.4.x/schema/">Schema</a>
|
|
|
|
|
|
</li>
|
|
</ul>
|
|
</ul>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<ul class="td-sidebar-nav__section pr-md-3">
|
|
<li class="td-sidebar-nav__section-title">
|
|
<a href="/kubernetes-operator/docs/getting-started/v0.3.x/" class="align-left pl-0 pr-2 collapsed td-sidebar-link td-sidebar-link__section">v0.3.x</a>
|
|
</li>
|
|
<ul>
|
|
<li class="collapse " id="kubernetes-operator-docs-getting-started-v0-3-x">
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<a class="td-sidebar-link td-sidebar-link__page " id="m-kubernetes-operator-docs-getting-started-v0-3-x-deploy-jenkins" href="/kubernetes-operator/docs/getting-started/v0.3.x/deploy-jenkins/">Deploy Jenkins</a>
|
|
|
|
|
|
|
|
|
|
|
|
<a class="td-sidebar-link td-sidebar-link__page " id="m-kubernetes-operator-docs-getting-started-v0-3-x-configuration" href="/kubernetes-operator/docs/getting-started/v0.3.x/configuration/">Configuration</a>
|
|
|
|
|
|
|
|
|
|
|
|
<a class="td-sidebar-link td-sidebar-link__page " id="m-kubernetes-operator-docs-getting-started-v0-3-x-customization" href="/kubernetes-operator/docs/getting-started/v0.3.x/customization/">Customization</a>
|
|
|
|
|
|
|
|
|
|
|
|
<a class="td-sidebar-link td-sidebar-link__page " id="m-kubernetes-operator-docs-getting-started-v0-3-x-migration" href="/kubernetes-operator/docs/getting-started/v0.3.x/migration/">Migration from v0.2.x</a>
|
|
|
|
|
|
|
|
|
|
|
|
<a class="td-sidebar-link td-sidebar-link__page " id="m-kubernetes-operator-docs-getting-started-v0-3-x-aks" href="/kubernetes-operator/docs/getting-started/v0.3.x/aks/">AKS</a>
|
|
|
|
|
|
|
|
|
|
|
|
<a class="td-sidebar-link td-sidebar-link__page " id="m-kubernetes-operator-docs-getting-started-v0-3-x-configure-backup-and-restore" href="/kubernetes-operator/docs/getting-started/v0.3.x/configure-backup-and-restore/">Configure backup and restore</a>
|
|
|
|
|
|
|
|
|
|
|
|
<a class="td-sidebar-link td-sidebar-link__page " id="m-kubernetes-operator-docs-getting-started-v0-3-x-custom-backup-and-restore" href="/kubernetes-operator/docs/getting-started/v0.3.x/custom-backup-and-restore/">Custom Backup and Restore Providers</a>
|
|
|
|
|
|
|
|
|
|
|
|
<a class="td-sidebar-link td-sidebar-link__page " id="m-kubernetes-operator-docs-getting-started-v0-3-x-notifications" href="/kubernetes-operator/docs/getting-started/v0.3.x/notifications/">Notifications</a>
|
|
|
|
|
|
|
|
|
|
|
|
<a class="td-sidebar-link td-sidebar-link__page " id="m-kubernetes-operator-docs-getting-started-v0-3-x-diagnostics" href="/kubernetes-operator/docs/getting-started/v0.3.x/diagnostics/">Diagnostics</a>
|
|
|
|
|
|
|
|
|
|
|
|
<a class="td-sidebar-link td-sidebar-link__page " id="m-kubernetes-operator-docs-getting-started-v0-3-x-schema" href="/kubernetes-operator/docs/getting-started/v0.3.x/schema/">Schema</a>
|
|
|
|
|
|
</li>
|
|
</ul>
|
|
</ul>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<ul class="td-sidebar-nav__section pr-md-3">
|
|
<li class="td-sidebar-nav__section-title">
|
|
<a href="/kubernetes-operator/docs/getting-started/v0.1.x/" class="align-left pl-0 pr-2 collapsed td-sidebar-link td-sidebar-link__section">v0.1.x</a>
|
|
</li>
|
|
<ul>
|
|
<li class="collapse " id="kubernetes-operator-docs-getting-started-v0-1-x">
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<a class="td-sidebar-link td-sidebar-link__page " id="m-kubernetes-operator-docs-getting-started-v0-1-x-deploy-jenkins" href="/kubernetes-operator/docs/getting-started/v0.1.x/deploy-jenkins/">Deploy Jenkins</a>
|
|
|
|
|
|
|
|
|
|
|
|
<a class="td-sidebar-link td-sidebar-link__page " id="m-kubernetes-operator-docs-getting-started-v0-1-x-configuration" href="/kubernetes-operator/docs/getting-started/v0.1.x/configuration/">Configuration</a>
|
|
|
|
|
|
|
|
|
|
|
|
<a class="td-sidebar-link td-sidebar-link__page " id="m-kubernetes-operator-docs-getting-started-v0-1-x-customization" href="/kubernetes-operator/docs/getting-started/v0.1.x/customization/">Customization</a>
|
|
|
|
|
|
|
|
|
|
|
|
<a class="td-sidebar-link td-sidebar-link__page " id="m-kubernetes-operator-docs-getting-started-v0-1-x-aks" href="/kubernetes-operator/docs/getting-started/v0.1.x/aks/">AKS</a>
|
|
|
|
|
|
|
|
|
|
|
|
<a class="td-sidebar-link td-sidebar-link__page " id="m-kubernetes-operator-docs-getting-started-v0-1-x-configure-backup-and-restore" href="/kubernetes-operator/docs/getting-started/v0.1.x/configure-backup-and-restore/">Configure backup and restore</a>
|
|
|
|
|
|
|
|
|
|
|
|
<a class="td-sidebar-link td-sidebar-link__page " id="m-kubernetes-operator-docs-getting-started-v0-1-x-diagnostics" href="/kubernetes-operator/docs/getting-started/v0.1.x/diagnostics/">Diagnostics</a>
|
|
|
|
|
|
|
|
|
|
|
|
<a class="td-sidebar-link td-sidebar-link__page " id="m-kubernetes-operator-docs-getting-started-v0-1-x-scheme" href="/kubernetes-operator/docs/getting-started/v0.1.x/scheme/">Scheme</a>
|
|
|
|
|
|
|
|
|
|
|
|
<a class="td-sidebar-link td-sidebar-link__page " id="m-kubernetes-operator-docs-getting-started-v0-1-x-migration-guide-v1alpha1-to-v1alpha2" href="/kubernetes-operator/docs/getting-started/v0.1.x/migration-guide-v1alpha1-to-v1alpha2/">Migration guide from v1alpha1 to v1alpha2</a>
|
|
|
|
|
|
</li>
|
|
</ul>
|
|
</ul>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<ul class="td-sidebar-nav__section pr-md-3">
|
|
<li class="td-sidebar-nav__section-title">
|
|
<a href="/kubernetes-operator/docs/getting-started/v0.2.x/" class="align-left pl-0 pr-2 collapsed td-sidebar-link td-sidebar-link__section">v0.2.x</a>
|
|
</li>
|
|
<ul>
|
|
<li class="collapse " id="kubernetes-operator-docs-getting-started-v0-2-x">
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<a class="td-sidebar-link td-sidebar-link__page " id="m-kubernetes-operator-docs-getting-started-v0-2-x-deploy-jenkins" href="/kubernetes-operator/docs/getting-started/v0.2.x/deploy-jenkins/">Deploy Jenkins</a>
|
|
|
|
|
|
|
|
|
|
|
|
<a class="td-sidebar-link td-sidebar-link__page " id="m-kubernetes-operator-docs-getting-started-v0-2-x-configuration" href="/kubernetes-operator/docs/getting-started/v0.2.x/configuration/">Configuration</a>
|
|
|
|
|
|
|
|
|
|
|
|
<a class="td-sidebar-link td-sidebar-link__page " id="m-kubernetes-operator-docs-getting-started-v0-2-x-customization" href="/kubernetes-operator/docs/getting-started/v0.2.x/customization/">Customization</a>
|
|
|
|
|
|
|
|
|
|
|
|
<a class="td-sidebar-link td-sidebar-link__page " id="m-kubernetes-operator-docs-getting-started-v0-2-x-aks" href="/kubernetes-operator/docs/getting-started/v0.2.x/aks/">AKS</a>
|
|
|
|
|
|
|
|
|
|
|
|
<a class="td-sidebar-link td-sidebar-link__page " id="m-kubernetes-operator-docs-getting-started-v0-2-x-configure-backup-and-restore" href="/kubernetes-operator/docs/getting-started/v0.2.x/configure-backup-and-restore/">Configure backup and restore</a>
|
|
|
|
|
|
|
|
|
|
|
|
<a class="td-sidebar-link td-sidebar-link__page " id="m-kubernetes-operator-docs-getting-started-v0-2-x-custom-backup-and-restore" href="/kubernetes-operator/docs/getting-started/v0.2.x/custom-backup-and-restore/">Custom Backup and Restore Providers</a>
|
|
|
|
|
|
|
|
|
|
|
|
<a class="td-sidebar-link td-sidebar-link__page " id="m-kubernetes-operator-docs-getting-started-v0-2-x-migration" href="/kubernetes-operator/docs/getting-started/v0.2.x/migration/">Migration from v0.1.x</a>
|
|
|
|
|
|
|
|
|
|
|
|
<a class="td-sidebar-link td-sidebar-link__page " id="m-kubernetes-operator-docs-getting-started-v0-2-x-diagnostics" href="/kubernetes-operator/docs/getting-started/v0.2.x/diagnostics/">Diagnostics</a>
|
|
|
|
|
|
|
|
|
|
|
|
<a class="td-sidebar-link td-sidebar-link__page " id="m-kubernetes-operator-docs-getting-started-v0-2-x-schema" href="/kubernetes-operator/docs/getting-started/v0.2.x/schema/">Schema</a>
|
|
|
|
|
|
</li>
|
|
</ul>
|
|
</ul>
|
|
|
|
|
|
|
|
</li>
|
|
</ul>
|
|
</ul>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<ul class="td-sidebar-nav__section pr-md-3">
|
|
<li class="td-sidebar-nav__section-title">
|
|
<a href="/kubernetes-operator/docs/security/" class="align-left pl-0 pr-2 collapsed td-sidebar-link td-sidebar-link__section">Security</a>
|
|
</li>
|
|
<ul>
|
|
<li class="collapse " id="kubernetes-operator-docs-security">
|
|
|
|
|
|
|
|
</li>
|
|
</ul>
|
|
</ul>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<ul class="td-sidebar-nav__section pr-md-3">
|
|
<li class="td-sidebar-nav__section-title">
|
|
<a href="/kubernetes-operator/docs/developer-guide/" class="align-left pl-0 pr-2 td-sidebar-link td-sidebar-link__section">Developer Guide</a>
|
|
</li>
|
|
<ul>
|
|
<li class="collapse show" id="kubernetes-operator-docs-developer-guide">
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<a class="td-sidebar-link td-sidebar-link__page " id="m-kubernetes-operator-docs-developer-guide-tools" href="/kubernetes-operator/docs/developer-guide/tools/">Tools</a>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<ul class="td-sidebar-nav__section pr-md-3">
|
|
<li class="td-sidebar-nav__section-title">
|
|
<a href="/kubernetes-operator/docs/developer-guide/preview/" class="align-left pl-0 pr-2 active td-sidebar-link td-sidebar-link__section">Developer Guide - Preview</a>
|
|
</li>
|
|
<ul>
|
|
<li class="collapse show" id="kubernetes-operator-docs-developer-guide-preview">
|
|
|
|
|
|
|
|
</li>
|
|
</ul>
|
|
</ul>
|
|
|
|
|
|
|
|
</li>
|
|
</ul>
|
|
</ul>
|
|
|
|
|
|
|
|
</li>
|
|
</ul>
|
|
</ul>
|
|
|
|
</nav>
|
|
</div>
|
|
|
|
|
|
|
|
|
|
</div>
|
|
<div class="d-none d-xl-block col-xl-2 td-toc d-print-none">
|
|
|
|
|
|
|
|
|
|
<div class="td-page-meta ml-2 pb-1 pt-2 mb-0">
|
|
|
|
|
|
|
|
<a href="https://github.com/jenkinsci/kubernetes-operator/edit/master/website/content/en/docs/Developer%20Guide/Preview/_index.md" target="_blank"><i class="fa fa-edit fa-fw"></i> Edit this page</a>
|
|
<a href="https://github.com/jenkinsci/kubernetes-operator/issues/new?title=Developer%20Guide" target="_blank"><i class="fab fa-github fa-fw"></i> Create documentation issue</a>
|
|
|
|
|
|
<a href="https://github.com/jenkinsci/kubernetes-operator/issues/new" target="_blank"><i class="fas fa-tasks fa-fw"></i> Create project issue</a>
|
|
|
|
</div>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<nav id="TableOfContents">
|
|
<ul>
|
|
<li>
|
|
<ul>
|
|
<li><a href="#prerequisites">Prerequisites</a></li>
|
|
<li><a href="#clone-repository-and-download-dependencies">Clone repository and download dependencies</a></li>
|
|
<li><a href="#build-and-run-with-a-minikube">Build and run with a minikube</a></li>
|
|
<li><a href="#self-learning">Self-learning</a></li>
|
|
</ul></li>
|
|
</ul>
|
|
</nav>
|
|
|
|
|
|
|
|
</div>
|
|
<main class="col-12 col-md-9 col-xl-8 pl-md-5" role="main">
|
|
<nav aria-label="breadcrumb" class="d-none d-md-block d-print-none">
|
|
<ol class="breadcrumb spb-1">
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<li class="breadcrumb-item" >
|
|
<a href="https://jenkinsci.github.io/kubernetes-operator/docs/">Documentation</a>
|
|
</li>
|
|
|
|
|
|
|
|
|
|
<li class="breadcrumb-item" >
|
|
<a href="https://jenkinsci.github.io/kubernetes-operator/docs/developer-guide/">Developer Guide</a>
|
|
</li>
|
|
|
|
|
|
|
|
|
|
<li class="breadcrumb-item active" aria-current="page">
|
|
<a href="https://jenkinsci.github.io/kubernetes-operator/docs/developer-guide/preview/">Developer Guide - Preview</a>
|
|
</li>
|
|
|
|
</ol>
|
|
</nav >
|
|
|
|
|
|
<div class="td-content">
|
|
<h1>Developer Guide</h1>
|
|
<div class="lead">Jenkins Operator for developers</div>
|
|
|
|
|
|
|
|
|
|
<div class="pageinfo pageinfo-primary">
|
|
<p>This document explains how to setup your development environment.</p>
|
|
|
|
</div>
|
|
|
|
|
|
<h2 id="prerequisites">Prerequisites</h2>
|
|
|
|
<ul>
|
|
<li><a href="https://github.com/operator-framework/operator-sdk">operator_sdk</a> version 1.3.0</li>
|
|
<li><a href="https://git-scm.com/downloads">git</a></li>
|
|
<li><a href="https://golang.org/dl/">go</a> version 1.15.6</li>
|
|
<li><a href="https://jenkinsci.github.io/kubernetes-operator/docs/developer-guide/tools/">goimports, golint, checkmake and staticcheck</a></li>
|
|
<li><a href="https://kubernetes.io/docs/tasks/tools/install-minikube/">minikube</a> version 1.17.1 (preferred Hypervisor - <a href="https://www.virtualbox.org/wiki/Downloads">virtualbox</a>) (automatically downloaded)</li>
|
|
<li><a href="https://docs.docker.com/install/">docker</a> version 17.03+</li>
|
|
</ul>
|
|
|
|
<h2 id="clone-repository-and-download-dependencies">Clone repository and download dependencies</h2>
|
|
<div class="highlight"><pre style="background-color:#f8f8f8;-moz-tab-size:4;-o-tab-size:4;tab-size:4"><code class="language-bash" data-lang="bash">git clone git@github.com:jenkinsci/kubernetes-operator.git
|
|
<span style="color:#204a87">cd</span> kubernetes-operator
|
|
make go-dependencies</code></pre></div>
|
|
<h2 id="build-and-run-with-a-minikube">Build and run with a minikube</h2>
|
|
|
|
<p>Start minikube instance configured for <strong>Jenkins Operator</strong>. Appropriate minikube version will be downloaded to bin folder.</p>
|
|
<div class="highlight"><pre style="background-color:#f8f8f8;-moz-tab-size:4;-o-tab-size:4;tab-size:4"><code class="language-bash" data-lang="bash">make minikube-start</code></pre></div>
|
|
<p>Next run <strong>Jenkins Operator</strong> locally.</p>
|
|
<div class="highlight"><pre style="background-color:#f8f8f8;-moz-tab-size:4;-o-tab-size:4;tab-size:4"><code class="language-bash" data-lang="bash">make run</code></pre></div>
|
|
<p>Console output indicating readiness of this phase:</p>
|
|
<div class="highlight"><pre style="background-color:#f8f8f8;-moz-tab-size:4;-o-tab-size:4;tab-size:4"><code class="language-bash" data-lang="bash">+ build
|
|
+ run
|
|
kubectl config use-context minikube
|
|
Switched to context <span style="color:#4e9a06">"minikube"</span>.
|
|
Watching <span style="color:#4e9a06">'default'</span> namespace
|
|
bin/manager --jenkins-api-hostname<span style="color:#ce5c00;font-weight:bold">=</span>192.168.99.252 --jenkins-api-port<span style="color:#ce5c00;font-weight:bold">=</span><span style="color:#0000cf;font-weight:bold">0</span> --jenkins-api-use-nodeport<span style="color:#ce5c00;font-weight:bold">=</span><span style="color:#204a87">true</span> --cluster-domain<span style="color:#ce5c00;font-weight:bold">=</span>cluster.local
|
|
2021-02-08T14:14:45.263+0100 INFO cmd Version: v0.5.0
|
|
2021-02-08T14:14:45.263+0100 INFO cmd Git commit: 305dbeda-dirty-dirty
|
|
2021-02-08T14:14:45.264+0100 INFO cmd Go Version: go1.15.6
|
|
2021-02-08T14:14:45.264+0100 INFO cmd Go OS/Arch: darwin/amd64
|
|
2021-02-08T14:14:45.264+0100 INFO cmd Watch namespace: default
|
|
2021-02-08T14:14:45.592+0100 INFO controller-runtime.metrics metrics server is starting to listen <span style="color:#ce5c00;font-weight:bold">{</span><span style="color:#4e9a06">"addr"</span>: <span style="color:#4e9a06">"0.0.0.0:8383"</span><span style="color:#ce5c00;font-weight:bold">}</span>
|
|
2021-02-08T14:14:45.599+0100 INFO cmd starting manager
|
|
2021-02-08T14:14:45.599+0100 INFO controller-runtime.manager starting metrics server <span style="color:#ce5c00;font-weight:bold">{</span><span style="color:#4e9a06">"path"</span>: <span style="color:#4e9a06">"/metrics"</span><span style="color:#ce5c00;font-weight:bold">}</span>
|
|
2021-02-08T14:14:45.599+0100 INFO controller-runtime.manager.controller.jenkins Starting EventSource <span style="color:#ce5c00;font-weight:bold">{</span><span style="color:#4e9a06">"reconciler group"</span>: <span style="color:#4e9a06">"jenkins.io"</span>, <span style="color:#4e9a06">"reconciler kind"</span>: <span style="color:#4e9a06">"Jenkins"</span>, <span style="color:#4e9a06">"source"</span>: <span style="color:#4e9a06">"kind source: jenkins.io/v1alpha2, Kind=Jenkins"</span><span style="color:#ce5c00;font-weight:bold">}</span>
|
|
2021-02-08T14:14:45.700+0100 INFO controller-runtime.manager.controller.jenkins Starting EventSource <span style="color:#ce5c00;font-weight:bold">{</span><span style="color:#4e9a06">"reconciler group"</span>: <span style="color:#4e9a06">"jenkins.io"</span>, <span style="color:#4e9a06">"reconciler kind"</span>: <span style="color:#4e9a06">"Jenkins"</span>, <span style="color:#4e9a06">"source"</span>: <span style="color:#4e9a06">"kind source: /, Kind="</span><span style="color:#ce5c00;font-weight:bold">}</span>
|
|
2021-02-08T14:14:45.800+0100 INFO controller-runtime.manager.controller.jenkins Starting EventSource <span style="color:#ce5c00;font-weight:bold">{</span><span style="color:#4e9a06">"reconciler group"</span>: <span style="color:#4e9a06">"jenkins.io"</span>, <span style="color:#4e9a06">"reconciler kind"</span>: <span style="color:#4e9a06">"Jenkins"</span>, <span style="color:#4e9a06">"source"</span>: <span style="color:#4e9a06">"kind source: /, Kind="</span><span style="color:#ce5c00;font-weight:bold">}</span>
|
|
2021-02-08T14:14:45.901+0100 INFO controller-runtime.manager.controller.jenkins Starting EventSource <span style="color:#ce5c00;font-weight:bold">{</span><span style="color:#4e9a06">"reconciler group"</span>: <span style="color:#4e9a06">"jenkins.io"</span>, <span style="color:#4e9a06">"reconciler kind"</span>: <span style="color:#4e9a06">"Jenkins"</span>, <span style="color:#4e9a06">"source"</span>: <span style="color:#4e9a06">"kind source: /, Kind="</span><span style="color:#ce5c00;font-weight:bold">}</span>
|
|
2021-02-08T14:14:46.003+0100 INFO controller-runtime.manager.controller.jenkins Starting EventSource <span style="color:#ce5c00;font-weight:bold">{</span><span style="color:#4e9a06">"reconciler group"</span>: <span style="color:#4e9a06">"jenkins.io"</span>, <span style="color:#4e9a06">"reconciler kind"</span>: <span style="color:#4e9a06">"Jenkins"</span>, <span style="color:#4e9a06">"source"</span>: <span style="color:#4e9a06">"kind source: core/v1, Kind=Secret"</span><span style="color:#ce5c00;font-weight:bold">}</span>
|
|
2021-02-08T14:14:46.004+0100 INFO controller-runtime.manager.controller.jenkins Starting EventSource <span style="color:#ce5c00;font-weight:bold">{</span><span style="color:#4e9a06">"reconciler group"</span>: <span style="color:#4e9a06">"jenkins.io"</span>, <span style="color:#4e9a06">"reconciler kind"</span>: <span style="color:#4e9a06">"Jenkins"</span>, <span style="color:#4e9a06">"source"</span>: <span style="color:#4e9a06">"kind source: core/v1, Kind=ConfigMap"</span><span style="color:#ce5c00;font-weight:bold">}</span>
|
|
2021-02-08T14:14:46.004+0100 INFO controller-runtime.manager.controller.jenkins Starting EventSource <span style="color:#ce5c00;font-weight:bold">{</span><span style="color:#4e9a06">"reconciler group"</span>: <span style="color:#4e9a06">"jenkins.io"</span>, <span style="color:#4e9a06">"reconciler kind"</span>: <span style="color:#4e9a06">"Jenkins"</span>, <span style="color:#4e9a06">"source"</span>: <span style="color:#4e9a06">"kind source: jenkins.io/v1alpha2, Kind=Jenkins"</span><span style="color:#ce5c00;font-weight:bold">}</span>
|
|
2021-02-08T14:14:46.004+0100 INFO controller-runtime.manager.controller.jenkins Starting Controller <span style="color:#ce5c00;font-weight:bold">{</span><span style="color:#4e9a06">"reconciler group"</span>: <span style="color:#4e9a06">"jenkins.io"</span>, <span style="color:#4e9a06">"reconciler kind"</span>: <span style="color:#4e9a06">"Jenkins"</span><span style="color:#ce5c00;font-weight:bold">}</span>
|
|
2021-02-08T14:14:46.004+0100 INFO controller-runtime.manager.controller.jenkins Starting workers <span style="color:#ce5c00;font-weight:bold">{</span><span style="color:#4e9a06">"reconciler group"</span>: <span style="color:#4e9a06">"jenkins.io"</span>, <span style="color:#4e9a06">"reconciler kind"</span>: <span style="color:#4e9a06">"Jenkins"</span>, <span style="color:#4e9a06">"worker count"</span>: 1<span style="color:#ce5c00;font-weight:bold">}</span></code></pre></div>
|
|
<p>Lastly apply Jenkins Custom Resource to minikube cluster:</p>
|
|
<div class="highlight"><pre style="background-color:#f8f8f8;-moz-tab-size:4;-o-tab-size:4;tab-size:4"><code class="language-bash" data-lang="bash">kubectl apply -f config/samples/jenkins.io_v1alpha2_jenkins.yaml
|
|
|
|
<span style="color:#ce5c00;font-weight:bold">{</span><span style="color:#4e9a06">"level"</span>:<span style="color:#4e9a06">"info"</span>,<span style="color:#4e9a06">"ts"</span>:1612790690.875426,<span style="color:#4e9a06">"logger"</span>:<span style="color:#4e9a06">"controller-jenkins"</span>,<span style="color:#4e9a06">"msg"</span>:<span style="color:#4e9a06">"Setting default Jenkins container command"</span>,<span style="color:#4e9a06">"cr"</span>:<span style="color:#4e9a06">"jenkins-example"</span><span style="color:#ce5c00;font-weight:bold">}</span>
|
|
<span style="color:#ce5c00;font-weight:bold">{</span><span style="color:#4e9a06">"level"</span>:<span style="color:#4e9a06">"info"</span>,<span style="color:#4e9a06">"ts"</span>:1612790690.8754492,<span style="color:#4e9a06">"logger"</span>:<span style="color:#4e9a06">"controller-jenkins"</span>,<span style="color:#4e9a06">"msg"</span>:<span style="color:#4e9a06">"Setting default Jenkins container JAVA_OPTS environment variable"</span>,<span style="color:#4e9a06">"cr"</span>:<span style="color:#4e9a06">"jenkins-example"</span><span style="color:#ce5c00;font-weight:bold">}</span>
|
|
<span style="color:#ce5c00;font-weight:bold">{</span><span style="color:#4e9a06">"level"</span>:<span style="color:#4e9a06">"info"</span>,<span style="color:#4e9a06">"ts"</span>:1612790690.875456,<span style="color:#4e9a06">"logger"</span>:<span style="color:#4e9a06">"controller-jenkins"</span>,<span style="color:#4e9a06">"msg"</span>:<span style="color:#4e9a06">"Setting default operator plugins"</span>,<span style="color:#4e9a06">"cr"</span>:<span style="color:#4e9a06">"jenkins-example"</span><span style="color:#ce5c00;font-weight:bold">}</span>
|
|
<span style="color:#ce5c00;font-weight:bold">{</span><span style="color:#4e9a06">"level"</span>:<span style="color:#4e9a06">"info"</span>,<span style="color:#4e9a06">"ts"</span>:1612790690.875463,<span style="color:#4e9a06">"logger"</span>:<span style="color:#4e9a06">"controller-jenkins"</span>,<span style="color:#4e9a06">"msg"</span>:<span style="color:#4e9a06">"Setting default Jenkins master service"</span>,<span style="color:#4e9a06">"cr"</span>:<span style="color:#4e9a06">"jenkins-example"</span><span style="color:#ce5c00;font-weight:bold">}</span>
|
|
<span style="color:#ce5c00;font-weight:bold">{</span><span style="color:#4e9a06">"level"</span>:<span style="color:#4e9a06">"info"</span>,<span style="color:#4e9a06">"ts"</span>:1612790690.875467,<span style="color:#4e9a06">"logger"</span>:<span style="color:#4e9a06">"controller-jenkins"</span>,<span style="color:#4e9a06">"msg"</span>:<span style="color:#4e9a06">"Setting default Jenkins slave service"</span>,<span style="color:#4e9a06">"cr"</span>:<span style="color:#4e9a06">"jenkins-example"</span><span style="color:#ce5c00;font-weight:bold">}</span>
|
|
<span style="color:#ce5c00;font-weight:bold">{</span><span style="color:#4e9a06">"level"</span>:<span style="color:#4e9a06">"info"</span>,<span style="color:#4e9a06">"ts"</span>:1612790690.881811,<span style="color:#4e9a06">"logger"</span>:<span style="color:#4e9a06">"controller-jenkins"</span>,<span style="color:#4e9a06">"msg"</span>:<span style="color:#4e9a06">"*v1alpha2.Jenkins/jenkins-example has been updated"</span>,<span style="color:#4e9a06">"cr"</span>:<span style="color:#4e9a06">"jenkins-example"</span><span style="color:#ce5c00;font-weight:bold">}</span>
|
|
<span style="color:#ce5c00;font-weight:bold">{</span><span style="color:#4e9a06">"level"</span>:<span style="color:#4e9a06">"info"</span>,<span style="color:#4e9a06">"ts"</span>:1612790691.252834,<span style="color:#4e9a06">"logger"</span>:<span style="color:#4e9a06">"controller-jenkins"</span>,<span style="color:#4e9a06">"msg"</span>:<span style="color:#4e9a06">"Creating a new Jenkins Master Pod default/jenkins-jenkins-example"</span>,<span style="color:#4e9a06">"cr"</span>:<span style="color:#4e9a06">"jenkins-example"</span><span style="color:#ce5c00;font-weight:bold">}</span>
|
|
<span style="color:#ce5c00;font-weight:bold">{</span><span style="color:#4e9a06">"level"</span>:<span style="color:#4e9a06">"info"</span>,<span style="color:#4e9a06">"ts"</span>:1612790691.322793,<span style="color:#4e9a06">"logger"</span>:<span style="color:#4e9a06">"controller-jenkins"</span>,<span style="color:#4e9a06">"msg"</span>:<span style="color:#4e9a06">"Jenkins master pod restarted by operator:"</span>,<span style="color:#4e9a06">"cr"</span>:<span style="color:#4e9a06">"jenkins-example"</span><span style="color:#ce5c00;font-weight:bold">}</span>
|
|
<span style="color:#ce5c00;font-weight:bold">{</span><span style="color:#4e9a06">"level"</span>:<span style="color:#4e9a06">"info"</span>,<span style="color:#4e9a06">"ts"</span>:1612790691.322817,<span style="color:#4e9a06">"logger"</span>:<span style="color:#4e9a06">"controller-jenkins"</span>,<span style="color:#4e9a06">"msg"</span>:<span style="color:#4e9a06">"Jenkins Operator version has changed, actual '' new 'v0.5.0'"</span>,<span style="color:#4e9a06">"cr"</span>:<span style="color:#4e9a06">"jenkins-example"</span><span style="color:#ce5c00;font-weight:bold">}</span>
|
|
<span style="color:#ce5c00;font-weight:bold">{</span><span style="color:#4e9a06">"level"</span>:<span style="color:#4e9a06">"info"</span>,<span style="color:#4e9a06">"ts"</span>:1612790691.3228202,<span style="color:#4e9a06">"logger"</span>:<span style="color:#4e9a06">"controller-jenkins"</span>,<span style="color:#4e9a06">"msg"</span>:<span style="color:#4e9a06">"Jenkins CR has been replaced"</span>,<span style="color:#4e9a06">"cr"</span>:<span style="color:#4e9a06">"jenkins-example"</span><span style="color:#ce5c00;font-weight:bold">}</span>
|
|
<span style="color:#ce5c00;font-weight:bold">{</span><span style="color:#4e9a06">"level"</span>:<span style="color:#4e9a06">"info"</span>,<span style="color:#4e9a06">"ts"</span>:1612790695.8789551,<span style="color:#4e9a06">"logger"</span>:<span style="color:#4e9a06">"controller-jenkins"</span>,<span style="color:#4e9a06">"msg"</span>:<span style="color:#4e9a06">"Creating a new Jenkins Master Pod default/jenkins-jenkins-example"</span>,<span style="color:#4e9a06">"cr"</span>:<span style="color:#4e9a06">"jenkins-example"</span><span style="color:#ce5c00;font-weight:bold">}</span>
|
|
<span style="color:#ce5c00;font-weight:bold">{</span><span style="color:#4e9a06">"level"</span>:<span style="color:#4e9a06">"warn"</span>,<span style="color:#4e9a06">"ts"</span>:1612790817.9423082,<span style="color:#4e9a06">"logger"</span>:<span style="color:#4e9a06">"controller-jenkins"</span>,<span style="color:#4e9a06">"msg"</span>:<span style="color:#4e9a06">"Reconcile loop failed: couldn't init Jenkins API client: Get \"http://192.168.99.254:31998/api/json\": dial tcp 192.168.99.254:31998: connect: connection refused"</span>,<span style="color:#4e9a06">"cr"</span>:<span style="color:#4e9a06">"jenkins-example"</span><span style="color:#ce5c00;font-weight:bold">}</span>
|
|
<span style="color:#ce5c00;font-weight:bold">{</span><span style="color:#4e9a06">"level"</span>:<span style="color:#4e9a06">"warn"</span>,<span style="color:#4e9a06">"ts"</span>:1612790817.9998221,<span style="color:#4e9a06">"logger"</span>:<span style="color:#4e9a06">"controller-jenkins"</span>,<span style="color:#4e9a06">"msg"</span>:<span style="color:#4e9a06">"Reconcile loop failed: couldn't init Jenkins API client: Get \"http://192.168.99.254:31998/api/json\": dial tcp 192.168.99.254:31998: connect: connection refused"</span>,<span style="color:#4e9a06">"cr"</span>:<span style="color:#4e9a06">"jenkins-example"</span><span style="color:#ce5c00;font-weight:bold">}</span>
|
|
<span style="color:#ce5c00;font-weight:bold">{</span><span style="color:#4e9a06">"level"</span>:<span style="color:#4e9a06">"info"</span>,<span style="color:#4e9a06">"ts"</span>:1612790818.581316,<span style="color:#4e9a06">"logger"</span>:<span style="color:#4e9a06">"controller-jenkins"</span>,<span style="color:#4e9a06">"msg"</span>:<span style="color:#4e9a06">"base-groovy ConfigMap 'jenkins-operator-base-configuration-jenkins-example' name '1-basic-settings.groovy' running groovy script"</span>,<span style="color:#4e9a06">"cr"</span>:<span style="color:#4e9a06">"jenkins-example"</span><span style="color:#ce5c00;font-weight:bold">}</span>
|
|
...
|
|
<span style="color:#ce5c00;font-weight:bold">{</span><span style="color:#4e9a06">"level"</span>:<span style="color:#4e9a06">"info"</span>,<span style="color:#4e9a06">"ts"</span>:1612790820.9473379,<span style="color:#4e9a06">"logger"</span>:<span style="color:#4e9a06">"controller-jenkins"</span>,<span style="color:#4e9a06">"msg"</span>:<span style="color:#4e9a06">"base-groovy ConfigMap 'jenkins-operator-base-configuration-jenkins-example' name '8-disable-job-dsl-script-approval.groovy' running groovy script"</span>,<span style="color:#4e9a06">"cr"</span>:<span style="color:#4e9a06">"jenkins-example"</span><span style="color:#ce5c00;font-weight:bold">}</span>
|
|
<span style="color:#ce5c00;font-weight:bold">{</span><span style="color:#4e9a06">"level"</span>:<span style="color:#4e9a06">"info"</span>,<span style="color:#4e9a06">"ts"</span>:1612790821.244055,<span style="color:#4e9a06">"logger"</span>:<span style="color:#4e9a06">"controller-jenkins"</span>,<span style="color:#4e9a06">"msg"</span>:<span style="color:#4e9a06">"Base configuration phase is complete, took 2m6s"</span>,<span style="color:#4e9a06">"cr"</span>:<span style="color:#4e9a06">"jenkins-example"</span><span style="color:#ce5c00;font-weight:bold">}</span>
|
|
<span style="color:#ce5c00;font-weight:bold">{</span><span style="color:#4e9a06">"level"</span>:<span style="color:#4e9a06">"info"</span>,<span style="color:#4e9a06">"ts"</span>:1612790821.7953842,<span style="color:#4e9a06">"logger"</span>:<span style="color:#4e9a06">"controller-jenkins"</span>,<span style="color:#4e9a06">"msg"</span>:<span style="color:#4e9a06">"Waiting for Seed Job Agent `seed-job-agent`..."</span>,<span style="color:#4e9a06">"cr"</span>:<span style="color:#4e9a06">"jenkins-example"</span><span style="color:#ce5c00;font-weight:bold">}</span>
|
|
...
|
|
|
|
<span style="color:#ce5c00;font-weight:bold">{</span><span style="color:#4e9a06">"level"</span>:<span style="color:#4e9a06">"info"</span>,<span style="color:#4e9a06">"ts"</span>:1612790851.843638,<span style="color:#4e9a06">"logger"</span>:<span style="color:#4e9a06">"controller-jenkins"</span>,<span style="color:#4e9a06">"msg"</span>:<span style="color:#4e9a06">"Waiting for Seed Job Agent `seed-job-agent`..."</span>,<span style="color:#4e9a06">"cr"</span>:<span style="color:#4e9a06">"jenkins-example"</span><span style="color:#ce5c00;font-weight:bold">}</span>
|
|
<span style="color:#ce5c00;font-weight:bold">{</span><span style="color:#4e9a06">"level"</span>:<span style="color:#4e9a06">"info"</span>,<span style="color:#4e9a06">"ts"</span>:1612790853.489524,<span style="color:#4e9a06">"logger"</span>:<span style="color:#4e9a06">"controller-jenkins"</span>,<span style="color:#4e9a06">"msg"</span>:<span style="color:#4e9a06">"User configuration phase is complete, took 2m38s"</span>,<span style="color:#4e9a06">"cr"</span>:<span style="color:#4e9a06">"jenkins-example"</span><span style="color:#ce5c00;font-weight:bold">}</span>
|
|
|
|
Two log lines says that Jenkins Operator works correctly:
|
|
|
|
* <span style="color:#4e9a06">`</span>Base configuration phase is <span style="color:#204a87">complete</span><span style="color:#4e9a06">`</span> - ensures manifests, Jenkins pod, Jenkins configuration and Jenkins API token
|
|
* <span style="color:#4e9a06">`</span>User configuration phase is <span style="color:#204a87">complete</span><span style="color:#4e9a06">`</span> - ensures Jenkins restore, backup and seed <span style="color:#204a87">jobs</span> along with user configuration
|
|
|
|
> Details about base and user phase can be found <span style="color:#ce5c00;font-weight:bold">[</span>here<span style="color:#ce5c00;font-weight:bold">]</span><span style="color:#ce5c00;font-weight:bold">(</span>https://jenkinsci.github.io/kubernetes-operator/docs/how-it-works/architecture-and-design/<span style="color:#ce5c00;font-weight:bold">)</span>.</code></pre></div>
|
|
<p>bash
|
|
kubectl get jenkins -o yaml</p>
|
|
|
|
<p>apiVersion: v1
|
|
items:
|
|
- apiVersion: jenkins.io/v1alpha2
|
|
kind: Jenkins
|
|
metadata:
|
|
…
|
|
spec:
|
|
backup:
|
|
action: {}
|
|
containerName: “”
|
|
interval: 0
|
|
makeBackupBeforePodDeletion: false
|
|
configurationAsCode:
|
|
configurations: []
|
|
secret:
|
|
name: “”
|
|
groovyScripts:
|
|
configurations: []
|
|
secret:
|
|
name: “”
|
|
jenkinsAPISettings:
|
|
authorizationStrategy: createUser
|
|
master:
|
|
basePlugins:
|
|
…
|
|
containers:
|
|
- command:
|
|
- bash
|
|
- -c
|
|
- /var/jenkins/scripts/init.sh && exec /sbin/tini -s – /usr/local/bin/jenkins.sh
|
|
env:
|
|
- name: JAVA_OPTS
|
|
value: -XX:+UnlockExperimentalVMOptions -XX:+UseCGroupMemoryLimitForHeap
|
|
-XX:MaxRAMFraction=1 -Djenkins.install.runSetupWizard=false -Djava.awt.headless=true
|
|
image: jenkins/jenkins:2.263.3-lts-alpine
|
|
imagePullPolicy: Always
|
|
livenessProbe:
|
|
…
|
|
readinessProbe:
|
|
…
|
|
resources:
|
|
limits:
|
|
cpu: 1500m
|
|
memory: 3Gi
|
|
requests:
|
|
cpu: “1”
|
|
memory: 500Mi
|
|
disableCSRFProtection: false
|
|
restore:
|
|
action: {}
|
|
containerName: “”
|
|
getLatestAction: {}
|
|
seedJobs:
|
|
- additionalClasspath: “”
|
|
bitbucketPushTrigger: false
|
|
buildPeriodically: “”
|
|
description: Jenkins Operator repository
|
|
failOnMissingPlugin: false
|
|
githubPushTrigger: false
|
|
id: jenkins-operator
|
|
ignoreMissingFiles: false
|
|
pollSCM: “”
|
|
repositoryBranch: master
|
|
repositoryUrl: <a href="https://github.com/jenkinsci/kubernetes-operator.git">https://github.com/jenkinsci/kubernetes-operator.git</a>
|
|
targets: cicd/jobs/*.jenkins
|
|
unstableOnDeprecation: false
|
|
service:
|
|
port: 8080
|
|
type: NodePort
|
|
serviceAccount: {}
|
|
slaveService:
|
|
port: 50000
|
|
type: ClusterIP
|
|
status:
|
|
appliedGroovyScripts:
|
|
- configurationType: base-groovy
|
|
hash: 2ownqpRyBjQYmzTRttUx7axok3CKe2E45frI5iRwH0w=
|
|
name: 1-basic-settings.groovy
|
|
source: jenkins-operator-base-configuration-jenkins-example
|
|
…
|
|
baseConfigurationCompletedTime: “2021-02-08T13:27:01Z”
|
|
createdSeedJobs:
|
|
- jenkins-operator
|
|
operatorVersion: v0.5.0
|
|
provisionStartTime: “2021-02-08T13:24:55Z”
|
|
userAndPasswordHash: nnfZsWmFfAYlYyVYeKhWW2KB4L8mE61JUfetAsr9IMM=
|
|
userConfigurationCompletedTime: “2021-02-08T13:27:33Z”
|
|
kind: List
|
|
metadata:
|
|
resourceVersion: “”
|
|
selfLink: “”</p>
|
|
<pre><code></code></pre>
|
|
<p>bash
|
|
kubectl get po</p>
|
|
|
|
<p>NAME READY STATUS RESTARTS AGE
|
|
jenkins-jenkins-example <sup>1</sup>⁄<sub>1</sub> Running 0 23m
|
|
seed-job-agent-jenkins-example-758cc7cc5c-82hbl <sup>1</sup>⁄<sub>1</sub> Running 0 21m</p>
|
|
<pre><code>### Debug Jenkins Operator</code></pre>
|
|
<p>bash
|
|
make run OPERATOR_EXTRA_ARGS=“–debug”</p>
|
|
<pre><code>## Build and run with a remote Kubernetes cluster
|
|
|
|
You can also run the controller locally and make it listen to a remote Kubernetes server.</code></pre>
|
|
<p>bash
|
|
make run NAMESPACE=default KUBECTL_CONTEXT=remote-k8s EXTRA_ARGS=‘–kubeconfig ~/.kube/config’</p>
|
|
<pre><code>Once **Jenkins Operator** are up and running, apply Jenkins custom resource:</code></pre>
|
|
<p>bash
|
|
kubectl –context remote-k8s –namespace default apply -f deploy/crds/jenkins_v1alpha2_jenkins_cr.yaml
|
|
kubectl –context remote-k8s –namespace default get jenkins -o yaml
|
|
kubectl –context remote-k8s –namespace default get po</p>
|
|
<pre><code>## Testing
|
|
|
|
Tests are written using [Ginkgo](https://onsi.github.io/ginkgo/) with [Gomega](https://onsi.github.io/gomega/).
|
|
|
|
Run unit tests with go fmt, lint, statickcheck, vet:</code></pre>
|
|
<p>bash
|
|
make verify</p>
|
|
<pre><code>Run unit tests only:</code></pre>
|
|
<p>bash
|
|
make test</p>
|
|
<pre><code>### Running E2E tests
|
|
|
|
Run e2e tests with minikube:</code></pre>
|
|
<p>bash
|
|
make minikube-start
|
|
make e2e</p>
|
|
<pre><code>Run the specific e2e test:</code></pre>
|
|
<p>bash
|
|
make e2e E2E_TEST_SELECTOR=‘^TestConfiguration$’</p>
|
|
<pre><code>### Building docker image on minikube
|
|
|
|
To be able to work with the docker daemon on `minikube` machine run the following command before building an image:</code></pre>
|
|
<p>bash
|
|
eval $(bin/minikube docker-env)</p>
|
|
<pre><code>### When `api/v1alpha2/jenkins_types.go` has changed
|
|
|
|
Run:</code></pre>
|
|
<p>bash
|
|
make manifests</p>
|
|
<pre><code>### Getting the Jenkins URL and basic credentials</code></pre>
|
|
<p>bash
|
|
minikube service jenkins-operator-http-<cr_name> –url
|
|
kubectl get secret jenkins-operator-credentials-<cr_name> -o ‘jsonpath={.data.user}’ | base64 -d
|
|
kubectl get secret jenkins-operator-credentials-<cr_name> -o ‘jsonpath={.data.password}’ | base64 -d
|
|
```</p>
|
|
|
|
<h2 id="self-learning">Self-learning</h2>
|
|
|
|
<ul>
|
|
<li><p><a href="https://www.youtube.com/watch?v=8_DaCcRMp5I">Tutorial: Deep Dive into the Operator Framework for… Melvin Hillsman, Michael Hrivnak, & Matt Dorn
|
|
</a></p></li>
|
|
|
|
<li><p><a href="https://www.katacoda.com/openshift/courses/operatorframework">Operator Framework Training By OpenShift</a></p></li>
|
|
</ul>
|
|
|
|
<div class="section-index">
|
|
|
|
|
|
|
|
|
|
<hr class="panel-line">
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
</div>
|
|
|
|
|
|
|
|
<div class="text-muted mt-5 pt-3 border-top">Last modified February 9, 2020
|
|
</div>
|
|
</div>
|
|
|
|
</main>
|
|
</div>
|
|
</div>
|
|
|
|
<footer class="bg-dark py-5 row d-print-none">
|
|
<div class="bg-dark container-fluid trademark-bigger">
|
|
<div class="row">
|
|
<div class="col-6 col-sm-4 text-xs-center order-sm-2">
|
|
|
|
</div>
|
|
<div class="col-6 col-sm-4 text-right text-xs-center order-sm-3">
|
|
|
|
</div>
|
|
<div class="col-12 col-sm-12 text-center py-4 order-sm-2">
|
|
<small class="text-white">© 2021 Jenkins Operator is created by VirtusLab. Source is available under Apache License Version 2 and website content under Creative Commons Attribution-ShareAlike 4.0.</small><br>
|
|
<small class="text-white">Jenkins® is a registered trademark of Software in the Public Interest, Inc.</small>
|
|
|
|
<p class="mt-2"><a href="/kubernetes-operator/about/">What's the Jenkins Operator?</a></p>
|
|
|
|
</div>
|
|
</div>
|
|
</div>
|
|
</footer>
|
|
|
|
|
|
</div>
|
|
|
|
<script src="https://cdnjs.cloudflare.com/ajax/libs/popper.js/1.14.3/umd/popper.min.js" integrity="sha384-ZMP7rVo3mIykV+2+9J3UJ46jBk0WLaUAdn689aCwoqbBJiSnjAK/l8WvCWPIPm49" crossorigin="anonymous"></script>
|
|
<script src="https://stackpath.bootstrapcdn.com/bootstrap/4.1.3/js/bootstrap.min.js" integrity="sha384-ChfqqxuZUCnJSK3+MXmPNIyE6ZbWh2IMqE241rYiqJxyMiZ6OW/JmZQ5stwEULTy" crossorigin="anonymous"></script>
|
|
|
|
|
|
|
|
|
|
|
|
<script src="/kubernetes-operator/js/main.min.b0e99aac17991fa76812dd47914049168ac469a1faa0939560f0b370565becab.js" integrity="sha256-sOmarBeZH6doEt1HkUBJForEaaH6oJOVYPCzcFZb7Ks="></script>
|
|
|
|
|
|
|
|
</body>
|
|
</html> |