Hello, world! GSoC 2020 Phase 3 has ended now and it was a great period for thw Jenkins Windows Services - YAML Configuration Support project. In this blog post, I will announce the updates during the GSoC 2020 - Phase 2 and Phase 3. If you are not already aware of this project, I would recommend reading this blog post which was published after GSoC 2020 - Phase 1.
Project Scope
Windows Service Wrapper - YAML configuration support
YAML schema validation
New CLI
XML Schema validation
YAML Configuration Support
Under WinSW - YAML configurations support, these tasks will be done.
YAML to Object mapping
At the moment YAML object mapping is finished and merged. You can find all the implementations in this Pull Request.
Extend WinSW to support both XML and YAML
This task is already done and merged. Find the implementation in this Pull Request.
YAML Configuration support for Extensions
At the moment there are 2 internal plugins in WinSW. RunAwayProcessKiller and SharedDirectoryMapper. We allow users to provide configurations for those plugins in the same XML and YAML configuration file which is used to configure WinSW. This task is merged as well.Pull Request
YAML schema validation
Users can validate YAML configuration file against JSON schema file. Users can use YAML utility tool from Visual Studio market place to validate YAML config file against JSON schema.
Key updates in Phase 2 and Phase 3
YAML Configuration structure
Environment variables
Now users can provide environment variables as a sequence of dictionaries that contains name and value for environment variables.
TimeStamp values
Users can specify timestamp values in the same manner used in XML (e.g.
10 ms,5 sec,3 min)
YAML configuration document was published. YAML Configuration Specification
Extend the WinSW to support both XML and YAML
Sample YAML Configuration File
id: jenkinsname: Jenkinsdescription: This service runs Jenkins automation server.env:
- name: JENKINS_HOMEvalue: '%LocalAppData%\Jenkins.jenkins'
- name: LM_LICENSE_FILEvalue: host1;host2executable: javaarguments: >-
-Xrs -Xmx256m -Dhudson.lifecycle=hudson.lifecycle.WindowsServiceLifecycle
-jar "E:\Winsw Test\yml6\jenkins.war" --httpPort=8081log:mode: rotateonFailure:
- action: restartdelay: 10 sec
- action: rebootdelay: 1 hourextensions:
- id: killOnStartupenabled: yesclassname: WinSW.Plugins.RunawayProcessKiller.RunawayProcessKillerExtensionsettings:pidfile: '%BASE%\pid.txt'stopTimeOut: 5000StoprootFirst: false
- id: mapNetworDirsenabled: yesclassname: WinSW.Plugins.SharedDirectoryMapper.SharedDirectoryMappersettings:mapping:
- enabled: falselabel: Nuncpath: \\UNC
- enabled: falselabel: Muncpath: \\UNC2New CLI
Let me explain in brief, why we need a new CLI. In WinSW, we will keep both XML and YAML configuration support. But according to the current implementation, the user can’t specify the configurations file explicitly. Also, we want to let the user skip the schema validation as well. So We decided to move into new CLI which is more structured with commands and options. Please read my previous blog post to learn more about commands and options in the new CLI.
How to try
User can configure the Windows Service Wrapper by both XML and YAML configuration files using the following steps.
Create the configuration file (XML or YAML).
Save it with the same name as the Windows Service Wrapper executable name.
Place the configuration file inside the directory(or in a parent directory), where the Windows Service Wrapper executable is located.
If there are both XML and YAML configuraiton files, Windows Service Wrapper will be configured by the XML configuration file.
Future Works
XML Schema validation
XML configuration file will be validated with the XSD file. I have started working on this feature and you can find the implementation in this Pull Request.
YAML Configuration validate on startup
How to contribute
You can find the GitHub repository in this link. Issues and Pull requests are always welcome. Also, you can communicate with us in the WinSW Gitter channel, which is a great way to get in touch and there are project sync up meetings every Tuesday at 13:30 UTC on the Gitter channel.