google-sre-ebook/README.md

2.2 KiB

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.