nemo
/
google-sre-ebook
mirror of https://github.com/captn3m0/google-sre-ebook.git
1
0
Fork 0
Code Issues Projects Releases Wiki Activity
45 Commits 7 Branches 2 Tags 576 KiB
Shell 53.7%
Ruby 38.3%
Dockerfile 8%
Go to file
Martin Malina 45ab1b57a7 Correct output directory info in readme 
With the docker run command as specified, the files show up in the current directory on the host system, not in output/.
 		2019-03-24 17:51:07 +05:30
cover add support to generate multi book 2019-02-01 06:17:47 +01:00
metadata add The Site Reliability Workbook 2019-02-01 06:28:34 +01:00
.dockerignore Easier Docker workflow 2018-05-17 01:54:54 +05:30
.editorconfig Initial commit 2017-09-16 21:52:31 +05:30
.gitignore Fix Directory Structure Changes (#17) 2018-12-20 23:23:37 +05:30
COPYING Adds License 2017-09-16 23:22:58 +05:30
Dockerfile Merge changes from master 2019-01-31 15:23:27 +05:30
Gemfile Initial commit 2017-09-16 21:52:31 +05:30
Gemfile.lock [deps] bundle update (and upgrade to bundler 2.x) 2019-01-31 15:20:16 +05:30
README.md Correct output directory info in readme 2019-03-24 17:51:07 +05:30
books.sh better names for output files 2019-02-03 16:10:22 +01:00
bootstrap.sh fix exit on 404 code and space in vars 2019-02-01 09:27:32 +01:00
generate.rb tidy up and make it easy to change book name 2019-01-31 08:46:20 +01:00

README.md

Google SRE Book/s

Generates a EPUB/MOBI/PDF for the Google SRE Book/s.

Original sources are downloaded from https://landing.google.com/sre/books

Visit the Releases page to download the latest release.

Books

Site Reliability Engineering (2016) The Site Reliability Workbook (2018)
site reliability engineering cover the site reliability workbook cover

Build

Docker (Preferred)

Requirements:

  • Docker

You can generate either of books using BOOK_SLUG variable.

Available values for BOOK_SLUG:

  • sre_book Site Reliability Engineering.
  • srw_book The Site Reliability Workbook.
$ docker run --rm --volume "$(pwd):/output" -e BOOK_SLUG='srw_book' captn3m0/google-sre-ebook:latest
  • You should see the final EPUB/MOBI/PDF files in the current directory after the above runs.
  • The file may be owned by the root user.

NOTE: You'll have to allow docker access to a directory that's local to your system. The safest way to do this is as follows:

$ mkdir /tmp/sreoutput
$ chcon -Rt svirt_sandbox_file_t /tmp/sreoutput
$ docker run --rm --volume "/tmp/sreoutput:/output" -e BOOK_SLUG='srw_book' captn3m0/google-sre-ebook:latest

The build for the above Docker image can be audited at https://cloud.docker.com/swarm/captn3m0/repository/docker/captn3m0/google-sre-ebook/builds.

macOS

Review and run the bootstrap.sh script to generate the EPUB, MOBI, and PDF files

Requirements:

  • Ruby
  • gem install bundler
  • bundle install
  • brew install pandoc
  • brew cask install calibre
  • brew install wget

Known Issues

  • metadata is not complete. There are just too many authors
  • Foreword/Preface is not part of the index

LICENSE

This is licensed under WTFPL. See COPYING file for the full text.