jenkins.el

jenkins.el copied to clipboard

#+TITLE: Jenkins.el

[[https://melpa.org/#/jenkins][file:https://melpa.org/packages/jenkins-badge.svg]]

Minimalistic emacs-plugin for integration with Jenkins. Still in active development. ** Installation from MELPA This package available on MELPA. #+begin_src M-x package-install RET jenkins #+end_src

** Installation from source

Jenkins.el is trivial and requires next steps:

• Clone repo to your local disk #+begin_src shell $ git clone [email protected]:rmuslimov/jenkins.el.git #+end_src
• Add jenkins.el path to your emacs path #+begin_src emacs-lisp (add-to-list 'load-path "") #+end_src
• Configure next jenkins.el variables #+begin_src emacs-lisp (setq jenkins-api-token "<api token can be found on user's configure page>") (setq jenkins-url "<jenkins url. Example: https://jenkins.company.com/ >") (setq jenkins-username "") (setq jenkins-viewname "") ;; if you're not using views skip this line #+end_src If you don't know your API token, it's easy to find it in jenkins user credentials page. Just visit: #+begin_src Jenkins main page > People > %Select your user% > Configure > Press on "Show API Token" #+end_src ** Configure *** Views Jenkins.el support using main view for user just define jenkins-viewname and it will be used as main view for jenkins.el. *** Column width for main view It's easy to configure the width of column on main jenkins view. Just set appropiate value with M-x customize or set it manually: #+begin_src elisp $ (setq jenkins-colwidth-name 35) ;; or jenkins-colwidth-id, jenkins-colwidth-last-status #+end_src

** Main screen [[file:main_screen.png]]

• See all jobs building at the moment
• Start building job (press "b' when positioned on target job)
• Visiting job's page (press "v")
• Enter to job screen

** Job details screen

[[file:details_screen.png]]

• Same functionality as on main screen for particular job, plus latest 25 builds history. ** Coming soon:

• Separate screen for build in jenkins.el

• Visiting build page from job screen

• Retrieving raw console output for build

• ...

Enjoy!