This repository holds the first milestone build for the DevOps (CSC 591) course at NC State, Fall '16. The specification for this milestone can be found here: https://github.com/CSC-DevOps/Course/blob/milestone1/Project/M1.md.
- Capabilities:
- The ability to trigger a build in response to a git commit via a git hook.
- Server-side Github Webhook (click to see webhook) for the Complexity project calls build server by making a
POSTrequest at/postreceive, passing what branch has had a change pushed to it. Build serverapp.jscatches this request (through theexpressmodule) and runs the build script applicable to that branch.
post-commitclient-side hook can also be used to tell the build server to build a branch but this method will force a push on commit which is not a normal or expected function of build servers.
- Server-side Github Webhook (click to see webhook) for the Complexity project calls build server by making a
- The ability to execute a build job via a script or build manager (e.g., shell, maven), which ensures a clean build each time.
- Build scripts
build-devandbuild-releasecalled by express server handles removing old libraries, switching branches, pulling new code, and building that code. The sample Complexity project is aNode.jsapplication, so for now we have done a simple npm install to build all dependencies of the project.
- Build scripts
- The ability to determine failure or success of a build job, and as a result trigger an external event (run post-build task, send email, etc).
- We have executed a child process where we run specific shell scripts to build specific branches. That script returns an error if something went wrong in the build. This is used in the
Node.jsbuildserver to trigger an email script, which reads the email IDs from a file and sends a build status mail using themailutilsmodule.
- We have executed a child process where we run specific shell scripts to build specific branches. That script returns an error if something went wrong in the build. This is used in the
- The ability to have multiple jobs corresponding to multiple branches in a repository. Specifically, a commit to a branch, release, will trigger a release build job. A commit to a branch, dev, will trigger a dev build job.
- The Github post-receive webhook sends the branch pushed to, based on the branch sent different build jobs are run from the build server
app.js(as long as the branch is an acceptable branch to the build server).
- The Github post-receive webhook sends the branch pushed to, based on the branch sent different build jobs are run from the build server
- The ability to track and display a history of past builds (a simple list works) via http.
- We create one log file for each build, where we verbosely note down whatever happened in the build process. The build history can be seen here. This is basically a simple GET request to the root directory of the build server. We parse the log files present in the log directory on that request and present it as a list of logs, with date, branch and build status, using a
Jadetemplate. The log files are click-able. You can click on a log file link to view its contents.
- We create one log file for each build, where we verbosely note down whatever happened in the build process. The build history can be seen here. This is basically a simple GET request to the root directory of the build server. We parse the log files present in the log directory on that request and present it as a list of logs, with date, branch and build status, using a
- The ability to trigger a build in response to a git commit via a git hook.
- Code
- in buildserver folder
- Team Member Unity IDs and Contributions
- ddas4 (Debalin Das)
- kkapoor (Kunal Kapoor)
- pmukher (Pratik Mukherjee)
- izdrosos (Ian Drosos)
- README.md
- this file
- Screencast