Cross-Platform Full-Stack Deployment

#### <a href="https://twitter.com/hashtag/AATC2017">#AATC2017</a>

[schmonz.com/talk /2017-aatc](https://schmonz.com/talk/2017-aatc/)
]

---

.left-column[
<a href="https://www.agilealliance.org/agile-alliance-technical-conference-2017/"><img src="../aatc-logo.jpg" width="154" height="106" alt="Agile Alliance Technical Conference" class="img" /></a>
]

### <a href="https://twitter.com/schmonz">@schmonz</a>

#### <a href="https://twitter.com/hashtag/AATC2017">#AATC2017</a>

[schmonz.com/talk /2017-aatc](https://schmonz.com/talk/2017-aatc/)
]

---

# Cross-Platform Full-Stack Deployment

## Amitai Schleier

### Agile Alliance Technical Conference

### 2017/04/20

???

1. Press 'C' to clone and move it to projector
2. Press 'P' to show these here presenter notes

### 90 minutes

Sure, it works on your machine. But how confident are you that your
Linux servers provide the same runtime environment as your Mac laptop?
And when there's a security hole somewhere in your app stack, how
quickly and safely can you upgrade to fix it? How much happier would you
be if you could generate identical software configurations for your dev
and prod boxen, no matter what OS they run?

Stop crossing your fingers that brew-ing here and apt-get-ing there
will produce matching results. You deserve DevOps happiness! Learn how
to pronounce "pkgsrc" -- and how a practical, proven cross-platform
package manager can save you from the kind of surprises that ruin
your week.

---

- Running any Unixy OS (maybe even <a href="https://en.wikipedia.org/wiki/Windows%20Subsystem%20for%20Linux">Windows Subsystem for Linux</a>),
- With a working C compiler,
- And a cloned [pkgsrc-2017Q1 tree](https://github.com/jsonn/pkgsrc.git)
 - (Post-clone, run `git checkout pkgsrc_2017Q1`)

<a href="https://github.com/jsonn/pkgsrc.git"><img src="./300x300-qrcode-pkgsrc.png" width="300" height="300" alt="pkgsrc.git" class="img" /></a>
]

???
- Need pkgsrc? All USB sticks have a `.zip` (already on the right branch)
- Need a Unix VirtualBox? A couple USB sticks have NetBSD and Ubuntu
	- File -> Import Appliance...
	- Username/password: "aatc"/"aatc"

---

## [agilealliance.org/the-alliance /code_of_conduct](https://www.agilealliance.org/the-alliance/code_of_conduct)

<a href="https://www.agilealliance.org/the-alliance/code_of_conduct/"><img src="./300x300-qrcode-coc.png" width="300" height="300" alt="Code of Conduct" class="img" /></a>
]

---

## [agilealliance.org/the-alliance /code_of_conduct](https://www.agilealliance.org/the-alliance/code_of_conduct)

**Not** to prevent behavior we don't like -- nothing can -- but

To remind ourselves, when we see some, how _we'll_ want to behave.
]

It's a cognitive aid:

Declaring our intentions helps us live up to them.
]

---

## [agilealliance.org/the-alliance /code_of_conduct](https://www.agilealliance.org/the-alliance/code_of_conduct)

### Key features

1. "Harassment includes..."
2. "To make clear what is expected..."
3. "If you are being harassed, notice that someone else is being harassed, or..."

### Homework

Build shared understanding: Hit the [Learning Lounge](https://www.agilealliance.org/agile-alliance-technical-conference-2017/program/special-events/) and pair with someone on a few Gherkin examples for this Code of Conduct.

(Extra credit: Figure out how to automate them.)
]

---

## 1. Talk a little
## 2. Pair a little
## 3. Solo a little
]

---

## 1. Get pkgsrc (and get rid of it)
## 2. Install `$FOO` from source
## 3. Update laptop from source
## 4. Update server from binaries
## 5. Build deploy-ready binaries
## 6. Package your own code
]

---

## Two options:

### 1. Not your thing? Cool, find something else

### 2. Sound good? Cool, find your new pair partner

]

---

## <a href="../../../../../talk/2017-aatc/">schmonz.com/talk /2017-aatc</a>

<a href="../../../../../talk/2017-aatc/"><img src="./300x300-qrcode-slides.png" width="300" height="300" alt="Get These Slides" class="img" /></a>
]

???

There's a payoff at the end!

---

```sh
$ git clone https://github.com/jsonn/pkgsrc.git

$ cd pkgsrc && git checkout pkgsrc_2017Q1

$ cd bootstrap && ./bootstrap --unprivileged

$ sudo vi /etc/paths  # add ~/pkg/sbin and ~/pkg/bin

$ pkg_info
```
]

???

While you wait, I'll set up a mail server!

---

```sh
$ rm -rf ~/pkg

$ rm -rf .../pkgsrc
```
]

---

```sh
$ git --version

$ cd .../pkgsrc/*/git-base

$ bmake install

$ bmake clean

$ git --version
```
]

---

## [openssl.org/news /vulnerabilities.html](https://www.openssl.org/news/vulnerabilities.html)

```sh
$ openssl version

$ cd .../pkgsrc/*/openssl

$ bmake install clean

$ openssl version
```
]

---

## [smashcompany.com/technology /i-hate-dependencies](http://www.smashcompany.com/technology/i-hate-dependencies)

```sh
$ cd .../pkgsrc/*/ruby-nokogiri

$ bmake install clean
```
]

???

What isn't totally making sense yet?

---

## [vimdoc.sourceforge.net/htmldoc /usr_90.html](http://vimdoc.sourceforge.net/htmldoc/usr_90.html)

```sh
$ cd .../pkgsrc/*/vim

$ bmake show-installed-depends

$ bmake show-options

$ vi ~/pkg/etc/mk.conf  # add PKG_OPTIONS.vim+=python

$ bmake show-options

$ bmake sid

$ bmake install clean

$ ldd ~/pkg/bin/vim     # or otool -L
```
]

---

```sh
$ pkg_rolling-replace -suv
```

Oh yeah, and rebuild everything with our preferred OpenSSL:

```sh
$ vi ~/pkg/etc/mk.conf      # add PREFER_PKGSRC=openssl

$ cd ~/pkg/pkgdb && grep "blddep openssl" */+CONTENTS \
    | cut -d / -f 1 | sort -u \
    | xargs pkg_admin set rebuild=YES

$ pkg_rolling-replace -sv

$ pkg_info openssl
```
]

---

```sh
$ sudo pkgin update

$ sudo pkgin upgrade
```
]

---

```sh
$ cd .../pkgsrc/*/pkg_comp && make install clean

$ sudo pkg_comp auto bash sudo tmux qmail-run
```
]

???

- "If you depend on it, update more often. Keep your search space small.
  When things break -- and they will -- you'll understand sooner."
- Example: post-branch, https://github.com/mattn/p5-Devel-CheckLib/issues/23
- Count dependencies: pkg_comp, built, installed

---

## [netbsd.org/docs /pkgsrc/creating.html](https://www.netbsd.org/docs/pkgsrc/creating.html)

```sh
$ url2pkg http://www.libsrs2.org/srs/libsrs2-1.0.18.tar.gz

$ vi Makefile    # etc.
```
]

---

- Uniquely flexible package manager
- Uniquely powerful supporting infrastructure
- 20 years of automation effort
- Your habits are portable across systems
- No magic
]

---

- For speed, start from VM or Docker image
- The Git example was realistic; could replace a custom script
 - For speed, pick an example with fewer dependencies
- The OpenSSL security example was relevant
- Use `cd */foo` to switch to a subdirectory without knowing its parent
- Could use nicer ["porcelain"](http://stackoverflow.com/questions/6976473/what-does-the-term-porcelain-mean-in-git)
- Harder than `yum`, but also does more
- Could especially help manage dependencies on dev machines
- <a href="https://en.wikipedia.org/wiki/Nix">Nix</a> is a very interesting package manager, competes with pkgsrc
]

---

## [submissions.agilealliance.org/aatc2017 /feedback/5813](https://submissions.agilealliance.org/aatc2017/feedback/5813)

<a href="https://submissions.agilealliance.org/aatc2017/feedback/5813"><img src="./300x300-qrcode-feedback.png" width="300" height="300" alt="Rate This Session" class="img" /></a>
]

---

> "Before Agile in 3 Minutes, I couldn't get my team to have a
> conversation about important topics. Now I have to timebox it."

## <a href="https://agilein3minut.es/">agilein3minut.es</a>

<a href="https://agilein3minut.es"><img src="./300x300-qrcode-podcast.png" width="300" height="300" alt="Agile in 3 Minutes" class="img" /></a>
]

---

The simplest _essays_ that could possibly work. $4 today!

## [leanpub.com/agilein3minutes /c/aatc17](https://leanpub.com/agilein3minutes/c/aatc17)

<a href="https://leanpub.com/agilein3minutes/c/aatc17"><img src="./300x300-qrcode-book.png" width="300" height="300" alt="Agile in 3 Minutes: The Book" class="img" /></a>
]

---

Does your company deliver valuable software? Maybe I can help. Consulting, coaching, training.

## <a href="../../../../../coach/">schmonz.com/coach</a>

<a href="../../../../../coach/"><img src="./300x300-qrcode-coach.png" width="300" height="300" alt="Let's Keep Going" class="img" /></a>
]

---

# Cross-Platform Full-Stack Deployment

## Amitai Schleier

### [schmonz.com](https://schmonz.com)