A Jenkins task should be run when a new commit is pushed to rLF master branch with something like:
#!/bin/sh
cargo doc --no-deps
scp -rp target/doc/* ysul.nasqueron.org:/var/wwwroot/nasqueron.org/docs/limiting-factor/rust/That will push new crate documentation to http://docs.nasqueron.org/limiting-factor/rust/limiting_factor
| rLF Limiting Factor | |||
| D1748 | rLFb48f510e75a8 Generate Cargo documentation in Jenkins | ||
| rOPS Nasqueron Operations | |||
| D1847 | rOPS4e7d27911cdc Deploy Limiting factor documentation | ||
| Status | Subtype | Assigned | Task | ||
|---|---|---|---|---|---|
| Resolved | dereckson | T1407 Generate Cargo documentation automatically and publish it to docs.nasqueron.org | |||
| Open | None | T1458 Allow Salt to trigger Jenkins jobs on CD |
Jenkins job works.
Job is triggered by H16 on commit. The Herald rule has successfully been triggered by 80ee76e8cdcf and successfully triggered the build 16 on Jenkins.
node('rust') { stage('Checkout') { git 'https://devcentral.nasqueron.org/source/limiting-factor.git' } try { stage('Build') { sh 'cargo build' } stage('Doc') { sh 'cargo doc || cargo doc --no-deps' sh ''' cd target/doc tar czf ../doc.tar.gz * ''' } } finally { archiveArtifacts artifacts: 'target/doc/**', onlyIfSuccessful: true archiveArtifacts artifacts: 'target/doc.tar.gz', onlyIfSuccessful: true stage('Publish') { sshPublisher( failOnError: true, publishers: [ sshPublisherDesc( configName: 'ysul-deploy', verbose: true, transfers: [ sshTransfer( sourceFiles: 'target/doc.tar.gz', removePrefix: 'target/', remoteDirectory: 'workspace', cleanRemote: true, execCommand: 'tar xzvf workspace/doc.tar.gz -C /var/wwwroot/nasqueron.org/docs/limiting-factor/rust/' ) ] ) ] ) } } }