
Security News
vlt Launches "reproduce": A New Tool Challenging the Limits of Package Provenance
vlt's new "reproduce" tool verifies npm packages against their source code, outperforming traditional provenance adoption in the JavaScript ecosystem.
@jenkins-cd/sse-gateway
Advanced tools
Client API for the Jenkins SSE Gateway plugin. Browser UI push events from Jenkins.
Server Sent Events (SSE) Gateway plugin for Jenkins.
Uses the pubsub-light-module jenkins-module to receive light-weight events and forward them into browser-land via SSE.
npm install --save @jenkins-cd/sse-gateway
This plugin requires Jenkins version 2.2 or later.
2.2+ is needed because it supports Servlet 3 asynchronous requests, which are needed for Server Sent Events.
The API is quite simple, allowing you to subscribe
to (and unsubscribe
from) Jenkins event
notification "channels".
The "job" channel is where you listen for events relating to Jenkins Jobs, all of which are enumerated in the Events.JobChannel Javadoc.
var sse = require('@jenkins-cd/sse-gateway');
// Connect to the SSE Gateway, providing an optional client Id.
var connection = sse.connect('myplugin');
// subscribe to all events on the "job" channel...
var jobSubs = connection.subscribe('job', function (event) {
var event = event.jenkins_event;
var jobName = event.job_name;
if (event === 'job_run_ended') {
var runStatus = event.job_run_status;
var runUrl = event.jenkins_object_url;
// Do whatever ....
}
});
// And some time later, unsubscribe using the return from the subscribe...
connection.unsubscribe(jobSubs);
The above example subscribes to all events on the "job" channel i.e. all events for all jobs in the Jenkins instance. This may be what you want in some cases, but in many cases you are just interested in receiving specific events. To do this, you simply need to specify a "filter" when subscribing to the channel.
For example, to only receive "FAILURE" events for the "order-management-webapp-deploy" job:
var sse = require('@jenkins-cd/sse-gateway');
// Connect to the SSE Gateway, providing an optional client Id.
var connection = sse.connect('myplugin');
// Add a filter as the last parameter ...
var jobSubs = connection.subscribe('job', function (event) {
// this event is only relating to 'order-management-webapp-deploy' ...
}, {
job_name: 'order-management-webapp-deploy',
job_run_status: 'FAILURE'
});
// And some time later, unsubscribe using the return from the subscribe...
connection.unsubscribe(jobSubs);
As is to be expected, the connection to Jenkins can be lost. To handle this situation, simply register an onError
handler with the connection instance.
var sse = require('@jenkins-cd/sse-gateway');
// Connect to the SSE Gateway.
var connection = sse.connect('myplugin');
// Connection error handling...
connection.onError(function (e) {
// Check the connection...
connection.waitConnectionOk(function(status) {
if (status.connectError) {
// The last attempt to connect was a failure, so
// notify the user in some way....
} else if (status.connectErrorCount > 0) {
// The last attempt to connect was not a failure,
// but we had earlier failures, so undo
// earlier error notifications etc ...
// And perhaps reload the current page, forcing
// a login if needed....
setTimeout(function() {
window.location.reload(true);
}, 2000);
}
});
});
// etc...
Note that only one handler can be registered per
connection
instance.
Note how the supplied connection.onError
handler makes a call to connection.waitConnectionOk
.
connection.waitConnectionOk
takes a connection status callback handler. This handler is called
periodically until the connection is ok again i.e. it can be called more than once, constantly getting
feedback on the connection state.
As always with Internet Explorer, there are issues. It doesn't support the SSE EventSource
so in order to
use it on Internet Explorer, please make sure that a polyfill is added to the page before your app. We have
used this one and found it to work fine.
To add this polyfill to your .jelly
file, simply include the following adjunct as early as possible.
<st:adjunct includes="org.jenkinsci.plugins.ssegateway.sse.EventSource" />
To use this API in a headless/non-browser JavaScript environment (e.g. server-side JavaScript, or a test environment), just
require
the headless-client
e.g.:
var sse = require('@jenkins-cd/sse-gateway/headless-client');
// etc....
The SSE Gateway client code uses the @jenkins-cd/logging
package for client-side/browser logging. See the Browser Configuration docs for how to configure logging in your browser, configuring the stored value of jenkins-instance/logging/categories:org.jenkinsci.sse
for SSE logs.
See the sse-gateway-sample-plugin.
FAQs
Client API for the Jenkins SSE Gateway plugin. Browser UI push events from Jenkins.
The npm package @jenkins-cd/sse-gateway receives a total of 975 weekly downloads. As such, @jenkins-cd/sse-gateway popularity was classified as not popular.
We found that @jenkins-cd/sse-gateway demonstrated a not healthy version release cadence and project activity because the last version was released a year ago. It has 11 open source maintainers collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Security News
vlt's new "reproduce" tool verifies npm packages against their source code, outperforming traditional provenance adoption in the JavaScript ecosystem.
Research
Security News
Socket researchers uncovered a malicious PyPI package exploiting Deezer’s API to enable coordinated music piracy through API abuse and C2 server control.
Research
The Socket Research Team discovered a malicious npm package, '@ton-wallet/create', stealing cryptocurrency wallet keys from developers and users in the TON ecosystem.