Jenkins Remoting layer
Jenkins remoting is an executable JAR, which implements communication layer in Jenkins automation server. It's being used for master <=> agent(fka "slave") and master <=> CLI communications.
In general, this library contains the bootstrap code to bridge separate JVMs into a single semi-shared space. It includes: TCP-based communication protocols, data serialization, Java classloading.
The library is reusable outside Jenkins.
Currently there are two supported baselines of Remoting.
Remoting 3 is a new baseline introduced in Jenkins 2.27.
- Java 7 is a new target JVM, the new remoting version is not guaranteed to work properly on Java 9 and versions below Java 7
JNLP4-connectprotocol, which improves performance and stability compared to the JNLP3 protocol
Remoting 3 does not have full binary compatibity with Remoting
2 (see Remoting 3 Compatibility Notes).
Remoting 2 is a version, which was used in Jenkins till the
It is not being offered in new releases of Jenkins.
This version is still being maintained, because it is being used in Jenkins LTS and several other projects.
- The version will be maintained till at least May 2017
- New releases may include bugfixes, security fixes and performance enhancements
- There is no plans to introduce new features in
Changelogs for Remoting 2.x releases are available here.
Remoting documentation is under development. More info will appear soon. Feel free to contribute.
- Changelog - Mainstream - Changelog for the Remoting 3 and previous releases of Remoting 2
- Changelog - 2.x - Changelog for the Remoting
2.xstabilization releases after the Remoting 3 release
- Remoting 3 Compatibility Notes
- Remoting Protocols - Overview of protocols integrated with Jenkins
- Remoting Configuration - Configuring remoting agents
- Jenkins Specifics - Notes on using remoting in Jenkins
- Troubleshooting - Investigating and solving common remoting issues
Remoting library uses the Jenkins bugtracker.
Issues should be reported there in the
JENKINS project with the
See How to report an issue for more details about Jenkins issue reporting.
- Remoting Architecture Overview by Winston Prakash, Oracle (the information is outdated)
- Making your plugin behave in distributed Jenkins
- Writing an SCM plugin. Remoting examples
- Troubleshooting remoting issues
- Scaling Jenkins to Hundreds of Nodes by Akshay Dayal, Google (remoting optimization, JNLP3)