Skip to content
This is the frontend application driven by data from the Jenkins Plugin Site API.
JavaScript CSS Other
Branch: develop
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.github
__tests__
app
public
views
webpack
.babelrc
.editorconfig
.eslintignore
.eslintrc
.gitignore
CONTRIBUTING.md
Dockerfile
Jenkinsfile
LICENSE.txt
README.md
package.json
postinstall.js
server.js
setup-jasmine-env.js
yarn.lock

README.md

Jenkins Plugin Site

Join the chat at https://gitter.im/jenkinsci/docs GitHub release

This is the frontend application driven by data from the Jenkins Plugin Site API.

Architecture

The application is developed using React, Redux, Express, Webpack, and Reselect.

Production deployments use server side rendering to help ensure quality SEO results.

We welcome any enhancements and bugfixes, please see our guidelines on how you can contribute.

Running the app

Requirements

  • node 6.9+
  • yarn 0.18+

Run locally with client side rendering

yarn
yarn start
Open http://localhost:5000

This is recommended for normal development as it uses webpack-dev-server and enables hot reloading so changes to code are immediately detected and the application is recompiled. By default it communicates with https://plugins.jenkins.io/api for the REST API. To specify a different location supply the REST_API_URL environment variable.

Run locally with server side rendering

yarn
yarn server
Open http://localhost:5000

This uses server side rendering to help ensure SEO results. This does not enable hot reloading. If REST_API_URL is unset it defaults to https://plugins.jenkins.io/api.

When using server side rendering, the application will download a header from an external location and inject itself into the content and replace the view/index.hbs. This is intended for use in the Dockerfile production deployment. By default the location is https://jenkins.io/plugins/index.html. To specify a different location supply the HEADER_FILE environment variable.

Linting

ESLint with React linting options have been enabled.

yarn lint

Tests

Execute tests via

yarn test

or run in watch mode

yarn test:watch

Deploying the app

It's recommended the application be deployed via it's Dockerfile.

Requirements

  • Docker 1.12+
docker build -t jenkinsciinfra/plugin-site --rm --no-cache .
docker run -p 5000:5000 -it jenkinsciinfra/plugin-site

If REST_API_URL is unset it defaults to https://plugins.jenkins.io/api. If HEADER_FILE is unset it defaults to https://jenkins.io/plugins/index.html

You can’t perform that action at this time.