Go to file
Baptiste Mathus 9ce2d9bbb4
Merge pull request #320 from mandie722/JENKINS-53589_rm_plugin_dirs
[JENKINS-53589] delete exploded plugin dirs
2018-10-23 15:08:31 +02:00
distribution Update to use fs-extra to get recursive rm, updated tests 2018-10-22 10:59:58 -04:00
docs Re-organize the user-documentation up into the root directory to make it easier to find 2018-09-24 13:03:02 -07:00
services Upgrade to the latest script-security 2018-10-22 10:25:50 -07:00
tools Protect spaces in all tools commands 2018-09-18 00:34:01 +02:00
.dockerignore Refactor the acceptance tests to be separated into offline and online 2018-05-15 13:02:09 -07:00
.gitignore Merge branch 'master' into updates 2018-10-10 08:13:17 -07:00
HACKING.adoc Use the make target which I wrote for easily checking plugin updates 2018-09-21 08:23:32 -07:00
Jenkinsfile Add rollback test (only test) 2018-10-12 17:45:54 +02:00
LICENSE.txt License properly as MIT, and include the Four Opens 2018-02-28 10:36:32 -08:00
Makefile Add task for running 'npm audit fix' for both client and backend sides 2018-10-21 15:39:05 +02:00
README.adoc Some minor updates to the README in the repo 2018-10-03 14:37:13 -07:00
activate Move the ui code over into the client, and just let the client serve it 2018-08-29 10:55:56 -07:00
node.mk Convert everything over to TypeScript 2018-10-06 19:37:07 -07:00

README.adoc

<html lang="en"> <head> </head>

Evergreen

evergreen icon

if you prefer IRC, check out irc.gitter.im

Evergreen is an automatically updating rolling distribution system for Jenkins It consists of server-side, and client-side components to support a Chrome-like upgrade experience for Jenkins users.

Jenkins Evergreen provides the end-user with a pre-assembled collection of legos that can be immediately used to implement CI [1] and CD [2] 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.

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
docker volume create jenkins-evergreen-data && \
docker pull jenkins/evergreen:docker-cloud && \
docker run --name evergreen \
    --restart=always \
    -ti \
    -p 8080:80 \
    -v /var/run/docker.sock:/var/run/docker.sock \
    -v jenkins-evergreen-data:/evergreen/data/ \
    -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.

docker exec evergreen cat /evergreen/data/jenkins/home/secrets/initialAdminPassword

Getting started with an AWS-based installation

Note

This documentation is coming soon.

Milestones

Jenkins Evergreen is currently available for early adopters. Please see jenkins.io/projects/evergreen for more documentation and instructions on how to use it.

Milestone One

Milestone Two

Currently in-progress

The second milestone for Jenkins Evergreen is much more focused on the end-user experience while exercising the continuous delivery process built out in Milestone One.

Beta

Currently unplanned

General Availability

Currently unplanned

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 "Upgrade" of Jenkins Evergreen being made available in the Evergreen hosted service layer, and the backend orchestration necessary to ping connected Instances to initiate their local upgrade process.

A Deployment is then considered successful when all connected Jenkins Evergreen Instances are running that new version of Jenkins Evergreen.

The Four Opens

Inspired by the Openstack project [3] Jenkins Evergreen follows "The Four Opens":

Open Source

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.

Open Design

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.

Open Development

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.

Open Community

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.

Hacking on the project

</html>