Initial commit
diff --git a/README.rst b/README.rst
new file mode 100644
index 0000000..9a006c9
--- /dev/null
+++ b/README.rst
@@ -0,0 +1,139 @@
+=======
+Jenkins
+=======
+
+Install and configure Jenkins master and slave.
+
+Available states
+================
+
+.. contents::
+ :local:
+
+``jenkins.master``
+------------------
+
+Setup jenkins master
+
+``jenkins.slave``
+-----------------
+
+Setup jenkins slave
+
+``jenkins.job_builder``
+-----------------------
+
+Setup jenkins job builder
+
+Available metadata
+==================
+
+.. contents::
+ :local:
+
+``metadata.jenkins.master.single``
+----------------------------------
+
+Setup single-node master
+
+
+``metadata.jenkins.slave.single``
+---------------------------------
+
+Setup Jenkins slave
+
+Configuration parameters
+========================
+
+
+Example reclass
+===============
+
+Master
+------
+
+.. code-block:: yaml
+
+ classes:
+ - service.jenkins.master
+
+ parameters:
+ _param:
+ jenkins_admin_token: xyz
+ jenkins_admin_password_hash: xyz
+ jenkins_admin_password: xyz
+ job_builder_config_address: git@github.com:xyz/myjobs.git
+ job_builder_config_branch: master
+ nginx:
+ server:
+ site:
+ jenkins:
+ enabled: true
+ type: nginx_proxy
+ name: jenkins
+ proxy:
+ host: 127.0.0.1
+ port: 8080
+ protocol: http
+ host:
+ name: jenkins.example.com
+ port: 80
+ jenkins:
+ master:
+ mode: EXCLUSIVE
+ slaves:
+ - name: slave01
+ label: pbuilder
+ executors: 2
+ - name: slave02
+ label: image_builder
+ mode: EXCLUSIVE
+ executors: 2
+ views:
+ - name: "Package builds"
+ regex: "debian-build-.*"
+ - name: "Contrail builds"
+ regex: "contrail-build-.*"
+ - name: "Aptly"
+ regex: "aptly-.*"
+ plugins:
+ - name: slack
+ - name: extended-choice-parameter
+ - name: rebuild
+ - name: test-stability
+
+Slave
+-----
+
+.. code-block:: yaml
+
+ classes:
+ - service.jenkins.slave.single
+ - service.java.environment
+
+ parameters:
+ _param:
+ java_environment_platform: openjdk
+ java_environment_version: 7
+
+ jenkins:
+ slave:
+ master:
+ host: jenkins.example.com
+ port: 80
+ user:
+ name: jenkins_slave
+ password: dexiech6AepohthaiHook2iesh7ol5ook4Ov3leid3yek6daid2ooNg3Ee2oKeYo
+ gpg:
+ keypair_id: A76882D3
+ public_key: |
+ -----BEGIN PGP PUBLIC KEY BLOCK-----
+ ...
+ private_key: |
+ -----BEGIN PGP PRIVATE KEY BLOCK-----
+ ...
+
+Read more
+=========
+
+* https://wiki.jenkins-ci.org/display/JENKINS/Use+Jenkins