123 lines
8.4 KiB
Markdown
123 lines
8.4 KiB
Markdown
# Google SRE Book/s
|
||
|
||
Generates a EPUB/MOBI/PDF for the Google SRE Books. Original sources are downloaded from https://sre.google/books/
|
||
|
||
Visit the [Releases](https://github.com/captn3m0/google-sre-ebook/releases) page to download the latest release. Go through all the releases, and click "Assets" to view a list of files.
|
||
|
||
# Books
|
||
|
||
| Site Reliability Engineering (2016) | The Site Reliability Workbook (2018) |
|
||
| :-------------------------------------------------------------------------------------------------------------------------------------------------------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
||
| <a href="https://github.com/captn3m0/google-sre-ebook/releases"><img src="cover/sre-book.jpg" width="320" alt="site reliability engineering cover" /></a><br> <a href="https://books.google.com/books?id=81UrjwEACAAJ">BUY</a> | <a href="https://github.com/captn3m0/google-sre-ebook/releases"><img src="cover/workbook.jpg" width="320" alt="the site reliability workbook cover" /></a><br> <a href="https://books.google.com/books?id=fElmDwAAQBAJ">BUY</a>|
|
||
|
||
A few other SRE books/reports are available as directly from Google or publishers. A few links point to Internet Archive. Links marked in 🔻 are currently down.
|
||
|
||
- [Building Secure & Reliable Systems](https://sre.google/books/building-secure-reliable-systems/) - [[PDF](https://sre.google/static/pdf/building_secure_and_reliable_systems.pdf)] [[EPUB](https://sre.google/static/pdf/building_secure_and_reliable_systems.epub)] [[MOBI](https://sre.google/static/pdf/building_secure_and_reliable_systems.mobi)] [[Google Books](https://www.google.com/books/edition/Building_Secure_and_Reliable_Systems/Kn7UxwEACAAJ?hl=en)] [[Amazon](https://www.amazon.com/dp/B088Y67XG4)] [[Kobo](https://www.kobo.com/in/en/ebook/building-secure-and-reliable-systems)]
|
||
- [Training Site Reliability Engineers](https://sre.google/resources/practices-and-processes/training-site-reliability-engineers/) - [[PDF](https://googlesre.page.link/traininggh)] [[EPUB](https://sre.google/static/pdf/training-sre-epub.epub)]
|
||
- [SLO Adoption and Usage in SRE](https://www.oreilly.com/library/view/slo-adoption-and/9781492075370/) - [[PDF](https://web.archive.org/web/20210702035314/https://static.googleusercontent.com/media/sre.google/en//static/pdf/slo-adoption-and-usage-in-sre.pdf)]
|
||
- [Practical Guide to Cloud Migration](https://sre.google/resources/practices-and-processes/practical-guide-to-cloud-migration/) - [[PDF](https://sre.google/static/pdf/practical-guide-to-cloud-migration.pdf)] [[EPUB](https://sre.google/static/pdf/practical-guide-to-cloud-migration.epub)]
|
||
- [Creating a Production Launch Plan](https://sre.google/resources/practices-and-processes/production-launch-planning/) - [[PDF](https://googlesre.page.link/plpgh)] [[EPUB](https://web.archive.org/web/20210702003102/https://sre.google/static/pdf/cplp-epub.zip)] [[MOBI](https://web.archive.org/web/20210102115046/https://sre.google/static/pdf/cplp-mobi.zip)]
|
||
- [Case Studies in Infrastructure Change Management](https://get.oreilly.com/ind_case-studies-in-infrastructure-change-management.html) - [[PDF](https://web.archive.org/web/20210702035412/https://static.googleusercontent.com/media/sre.google/en//static/pdf/case-studies-infrastructure-change-management.pdf)]
|
||
- [A Case Study in Community-Driven Software Adoption](https://www.oreilly.com/library/view/a-case-study/9781098114596/) - [[PDF](https://web.archive.org/web/20210702035416/https://static.googleusercontent.com/media/sre.google/en//static/pdf/community-driven-software-adoption.pdf)] [[EPUB](https://web.archive.org/web/20210702003151/https://sre.google/static/pdf/community-driven-software-adoption-epub.zip)] [[MOBI](https://web.archive.org/web/20210702003132/https://sre.google/static/pdf/community-driven-software-adoption-mobi.zip)]
|
||
- [Incident Metrics in SRE](https://sre.google/resources/practices-and-processes/incident-metrics-in-sre/) - [[PDF](https://static.googleusercontent.com/media/sre.google/en//static/pdf/IncidentMeticsInSre.pdf)] [[EPUB](https://static.googleusercontent.com/media/sre.google/en//static/pdf/IncidentMeticsInSre.epub)]
|
||
- [Engineering Reliable Mobile Applications](https://www.oreilly.com/library/view/engineering-reliable-mobile/9781492057444/) - [[PDF](https://web.archive.org/web/20211011151056/https://static.googleusercontent.com/media/sre.google/en//static/pdf/engineering-reliable-mobile-applications.pdf)] [[EPUB](https://web.archive.org/web/20210702082730if_/https://sre.google/static/pdf/engineering-reliable-mobile-applications-epub.zip)] [[MOBI 🔻](https://sre.google/static/pdf/engineering-reliable-mobile-applications-mobi.zip)]
|
||
|
||
You might also like:
|
||
|
||
- [Software Engineering at Google](https://abseil.io/resources/swe-book) [[PDF](https://github.com/abseil/abseil.github.io/raw/cd13b21daa6ec74155548241241693198c1b1264/resources/swe_at_google.2.pdf)] [[PDF-Archive](https://archive.softwareheritage.org/browse/content/sha1_git:80ee550c6bda571d4e9f56fc093243d31a90b651/raw/?filename=swe_at_google.2.pdf)] [[Read Online](https://abseil.io/resources/swe-book/html/toc.html)] [[O’Reilly](https://www.oreilly.com/library/view/software-engineering-at/9781492082781/)] [[Amazon](https://www.amazon.com/_/dp/1492082791)] [[Ebooks.com](https://www.ebooks.com/en-in/book/detail/209970024/)] [Generated EPUB/PDF](https://github.com/captn3m0/google-swe-ebook/)
|
||
|
||
# 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' ghcr.io/captn3m0/google-sre-ebook:ruby
|
||
```
|
||
|
||
Builds on [Docker Hub](https://hub.docker.com/r/captn3m0/google-sre-ebook) are no longer maintained.
|
||
|
||
## macOS / Linux
|
||
|
||
Requirements:
|
||
|
||
- Make
|
||
- Ruby
|
||
- `gem install bundler`
|
||
- `bundle install`
|
||
- `brew install pandoc`
|
||
- `brew cask install calibre`
|
||
- `brew install wget`
|
||
|
||
Run either of the following:
|
||
|
||
```bash
|
||
# To download Site Reliability Engineering.
|
||
BOOK_SLUG='sre_book' ./generate.sh
|
||
|
||
# To download The Site Reliability Workbook.
|
||
BOOK_SLUG='srw_book' ./generate.sh
|
||
```
|
||
|
||
### PDF options
|
||
|
||
Any option can be passed to `pandoc` by `PDF_OPT_` prefix, for example:
|
||
|
||
```sh
|
||
PDF_OPT_GEOMETRY=margin=1.5cm \
|
||
PDF_OPT_DOCUMENTCLASS=extbook \
|
||
PDF_OPT_FONTSIZE=14pt \
|
||
PDF_OPT_MAINFONT=LiberationSerif-Regular.ttf \
|
||
PDF_OPT_MAINFONTOPTIONS=BoldFont=LiberationSerif-Bold.ttf,ItalicFont=LiberationSerif-Italic.ttf,BoldItalicFont=LiberationSerif-BoldItalic.ttf \
|
||
PDF_OPT_MONOFONT=LiberationMono-Regular.ttf \
|
||
PDF_OPT_MONOFONTOPTIONS=BoldFont=LiberationMono-Bold.ttf,ItalicFont=LiberationMono-Italic.ttf,BoldItalicFont=LiberationMono-BoldItalic.ttf \
|
||
PDF_OPT_SANSFONT=LiberationSans-Regular.ttf \
|
||
PDF_OPT_SANSFONTOPTIONS=BoldFont=LiberationSans-Bold.ttf,ItalicFont=LiberationSans-Italic.ttf,BoldItalicFont=LiberationSans-BoldItalic.ttf \
|
||
BOOK_SLUG=sre_book ./generate.sh
|
||
```
|
||
|
||
Default options passed to `pandoc` in `generate.sh` are overloaded by `PDF_OPT_` prefix, see `PDF_OPT_GEOMETRY` in above example.
|
||
|
||
Fonts in above axample are packed to `fonts-liberation2` on **Ubuntu**.
|
||
|
||
See more details:
|
||
|
||
* <https://pandoc.org/MANUAL.html#fonts>
|
||
* <https://ctan.org/pkg/extsizes>
|
||
* <https://ctan.org/pkg/fontspec>
|
||
|
||
# Known Issues
|
||
|
||
- metadata is not complete. There are just too many authors
|
||
- Foreword/Preface is not part of the index
|
||
- The typesetting is not great and does not match the original. See #22 for a list
|
||
|
||
# LICENSE
|
||
|
||
This is licensed under WTFPL. See COPYING file for the full text.
|
||
|
||
## Extra
|
||
|
||
I have a list of my E-book publishing related projects at https://captnemo.in/ebooks/. Links to other related books can be found at https://github.com/upgundecha/howtheysre#books-1
|