2018-01-29 09:06:43 +00:00
= Evergreen
2018-02-22 14:29:20 +00:00
image:https://badges.gitter.im/jenkins-infra/evergreen.svg[link="https://gitter.im/jenkins-infra/evergreen?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge"]
2018-03-23 13:35:11 +00:00
image:https://ci.jenkins.io/job/Infra/job/evergreen/job/master/badge/icon[link="https://ci.jenkins.io/blue/organizations/jenkins/Infra%2Fevergreen/activity",title="CI Status"]
2018-03-02 13:54:44 +00:00
_if you prefer IRC, check out link:https://irc.gitter.im/[irc.gitter.im]_
2018-02-22 14:29:20 +00:00
2018-03-02 14:29:31 +00:00
link:https://issues.jenkins-ci.org/secure/RapidBoard.jspa?rapidView=406[*Issue Tracker*]
2018-03-01 21:39:41 +00:00
2018-01-29 09:06:43 +00:00
Evergreen is an automatically updating rolling distribution system for
2018-08-15 15:41:24 +00:00
Jenkins It consists of server-side, and client-side components to
2018-01-29 09:06:43 +00:00
support a Chrome-like upgrade experience for Jenkins users.
2018-08-15 15:41:24 +00:00
Jenkins Evergreen provides the end-user with a
2018-04-11 03:00:52 +00:00
pre-assembled collection of legos that can be immediately used to implement CI
footnoteref:[ci, https://en.wikipedia.org/wiki/Continuous_integration]
and CD
footnoteref:[cd, https://en.wikipedia.org/wiki/Continuous_delivery] workloads.
At the same time, this focus on end-users success in these well-defined scenarios
will help the Jenkins project develop new features, and fix
bugs, more rapidly than before.
2018-08-19 16:54:51 +00:00
== Getting Started
Evergreen is currently in _alpha_ and is **not** recommended for production
just yet.
=== Getting started with a Docker-based installation
The easiest way to get started with Jenkins Evergreen is to use the Docker
image which has already been auto-configured for running workloads on Docker
itself. When `jenkins/evergreen:docker-cloud` is launched, it will
automatically download the latest version of Jenkins and the most essential
plugins and automatically configure some basic authentication, Docker settings
and Jenkins Pipeline.
In the example below, Jenkins Evergreen will be made available on port `8080`
and persist its data in `$PWD/jenkins-home`, allowing the container to be
restarted if necessary.
.Starting Jenkins Evergreen
[source,bash]
----
2018-08-24 13:23:20 +00:00
docker volume create jenkins-evergreen-data && \
2018-08-30 06:58:41 +00:00
docker pull jenkins/evergreen:docker-cloud && \
2018-08-19 16:54:51 +00:00
docker run --name evergreen \
2018-08-24 13:23:20 +00:00
--restart=always \
-ti \
2018-08-29 20:01:10 +00:00
-p 8080:80 \
2018-08-19 16:54:51 +00:00
-v /var/run/docker.sock:/var/run/docker.sock \
2018-09-18 15:56:41 +00:00
-v jenkins-evergreen-data:/evergreen/data/ \
2018-08-19 16:54:51 +00:00
-e LOG_LEVEL=debug \
jenkins/evergreen:docker-cloud
----
==== Fetching the administrator password
Once Jenkins has been configured and run, you will need to fetch the
dynamically generated administrator password in order to log in.
[source,bash]
----
2018-09-18 15:56:41 +00:00
docker exec evergreen cat /evergreen/data/jenkins/home/secrets/initialAdminPassword
2018-08-19 16:54:51 +00:00
----
2018-08-24 13:23:20 +00:00
=== Getting started with an AWS-based installation
2018-08-19 16:54:51 +00:00
[NOTE]
====
This documentation is coming soon.
====
2018-04-11 03:00:52 +00:00
=== Milestones
2018-10-03 21:37:13 +00:00
Jenkins Evergreen is currently available for **early adopters**. Please see link:https://jenkins.io/projects/evergreen[jenkins.io/projects/evergreen] for more documentation and instructions on how to use it.
2018-04-11 03:00:52 +00:00
==== Milestone One
2018-10-03 21:37:13 +00:00
:tada:
2018-04-11 03:00:52 +00:00
==== Milestone Two
2018-10-03 21:37:13 +00:00
Currently **in-progress**
2018-04-11 03:00:52 +00:00
2018-08-15 15:41:24 +00:00
The second milestone for Jenkins Evergreen is much more focused on the
2018-04-11 03:00:52 +00:00
end-user experience while exercising the continuous delivery process built out
in Milestone One.
==== Beta
**Currently unplanned**
2018-10-03 21:37:13 +00:00
==== General Availability
2018-04-11 03:00:52 +00:00
**Currently unplanned**
2018-02-08 15:06:04 +00:00
== Design Documents
2018-08-15 15:41:24 +00:00
Evergreen and Jenkins Evergreen are both captured in the following design
2018-02-08 15:06:04 +00:00
documents:
|===
| JEP | Title
| JEP-300
2018-08-15 15:41:24 +00:00
| link:https://github.com/jenkinsci/jep/tree/master/jep/300[Jenkins Evergreen]
2018-02-08 15:06:04 +00:00
| JEP-301
2018-08-15 15:41:24 +00:00
| link:https://github.com/jenkinsci/jep/tree/master/jep/301[Evergreen packaging for Jenkins Evergreen]
2018-02-08 15:06:04 +00:00
2018-03-22 18:44:31 +00:00
| JEP-302
| link:https://github.com/jenkinsci/jep/tree/master/jep/302[Evergreen snapshotting data safety system]
2018-04-03 18:59:54 +00:00
| JEP-303
| link:https://github.com/jenkinsci/jep/blob/master/jep/303[Evergreen Client Registration and Authentication]
2018-04-05 19:47:20 +00:00
| JEP-304
2018-08-15 15:41:24 +00:00
| link:https://github.com/jenkinsci/jep/tree/master/jep/304[Evergreen Client Error Telemetry Logging]
2018-04-05 19:47:20 +00:00
2018-04-16 20:33:04 +00:00
| JEP-305
| link:https://github.com/jenkinsci/jep/tree/master/jep/305[Publishing incremental commits as Maven releases]
2018-04-23 14:22:46 +00:00
| JEP-306
2018-08-15 15:41:24 +00:00
| link:https://github.com/jenkinsci/jep/tree/master/jep/306[Evergreen Instance Client Health Checking]
2018-04-23 14:22:46 +00:00
2018-04-26 20:42:10 +00:00
| JEP-307
| link:https://github.com/jenkinsci/jep/blob/master/jep/307[Evergreen Update Client/Server Lifecycle]
2018-06-01 12:15:42 +00:00
| JEP-308
2018-08-15 15:41:24 +00:00
| link:https://github.com/jenkinsci/jep/blob/master/jep/308[Evergreen Error Telemetry API]
2018-06-01 12:15:42 +00:00
2018-07-22 11:45:55 +00:00
| JEP-309
| link:https://github.com/jenkinsci/jep/blob/master/jep/309[Bill of Materials]
| JEP-310
2018-08-24 13:23:20 +00:00
| link:https://github.com/jenkinsci/jep/blob/master/jep/310[Evergreen AWS auto-configuration]
2018-07-22 11:45:55 +00:00
2018-02-08 15:06:04 +00:00
|===
2018-01-29 09:06:43 +00:00
2018-04-11 03:00:52 +00:00
[[deployment]]
== Deployment
The model applied with the Evergreen distribution system is one similar to
"deploying" Software-as-a-Service, without having a centralized "production"
environment. When documentation refers to a "Deployment", that entails a new
2018-08-15 15:41:24 +00:00
"Upgrade" of Jenkins Evergreen being made available in the Evergreen hosted
2018-04-11 03:00:52 +00:00
service layer, and the backend orchestration necessary to ping connected
Instances to initiate their local upgrade process.
2018-01-29 09:06:43 +00:00
2018-04-11 03:00:52 +00:00
A Deployment is then considered successful when all connected Jenkins
2018-08-15 15:41:24 +00:00
Evergreen Instances are running that new version of Jenkins Evergreen.
2018-01-29 09:06:43 +00:00
2018-03-16 10:24:03 +00:00
== The Four Opens
2018-02-28 18:36:32 +00:00
Inspired by the Openstack project
footnote:[https://governance.openstack.org/tc/reference/opens.html]
2018-08-15 15:41:24 +00:00
_Jenkins Evergreen_ follows "The Four Opens":
2018-02-28 18:36:32 +00:00
2018-03-16 10:24:03 +00:00
=== Open Source
2018-02-28 18:36:32 +00:00
We do _not_ produce “open core” software.
We are committed to creating truly open source software that is usable and
scalable. Truly open source software is not feature or performance limited and
is not crippled.
We use the MIT license.
2018-03-16 10:24:03 +00:00
=== Open Design
2018-02-28 18:36:32 +00:00
*We are committed to an open design process.* The development cycle requires
active collaboration to gather requirements and write specifications for
upcoming releases. Those events, which are *open to anyone,* include users,
developers, and upstream projects. We gather requirements, define priorities
and flesh out technical design to guide development for the next development
cycle.
The community controls the design process. You can help make this software meet
your needs.
2018-03-16 10:24:03 +00:00
=== Open Development
2018-02-28 18:36:32 +00:00
We maintain a publicly available source code repository through the entire
development process. We do public code reviews. We have public roadmaps. This
makes participation simpler, allows users to follow the development process and
participate in QA at an early stage.
2018-03-16 10:24:03 +00:00
=== Open Community
2018-02-28 18:36:32 +00:00
One of our core goals is to maintain a healthy, vibrant developer and user
community. Most decisions are made using a lazy consensus model. All processes
are documented, open and transparent.
2018-03-16 10:24:03 +00:00
== Hacking on the project
See link:HACKING.adoc[the related document].