Debugging the Scariest Development Environments: End the nightmares with tools like envinfo and Solidarity

In a world where perpetually confused developers can’t quite get their environments working, new libraries emerge from the ashes of lost productivity: envinfo and Solidarity. Escape the complexity and witness the rise of projects embracing change to save their projects from themselves.

Transcript

1. @ModusCreate Debugging the Scariest Development Environments: End the nightmares with tools like envinfo and Solidarity Trevor Brindle trevor.brindle@moduscreate.com
2. Your Development Environment • Tools, Processes & Files used • Growing complexity :(
3. The Problems • command not found • works on my computer • what version do you have? • what SDK version do I need? • every issue template ever…
4. **Please mention other relevant information such as Node.js version, Operating System, yarn and npm versions.**
5. THE WORST QUIZ EVER • What version of Bash was Globstar (**) added? • When was async/await added to Node? • When did Ruby add safe navigation (&.) ? • When did `npm install` start updating package-lock.json? • When was overflowchanged removed from Chrome?
6. WARNING:
 THIS REALLY HAPPENED :(
7. YEAH, 
 THIS TOO :(
8. How do I find this again?
10. The Solutions •Enforce what you use •Know what you have •Lock down critical paths
12. Story Time • cmd -v until you (╯°□°）╯︵ ┻━┻ • PR to React Native • Read the whole story on medium: • envinfo: An OSS Story
 goo.gl/zeqZcQ • $ `react-native info`
13. System: OS: Linux 4.9 Debian GNU/Linux 8 (jessie) CPU: x64 Intel(R) Core(TM) i7-4870HQ CPU@2.50GHz Memory: 327.91 MB / 1.991 GB Container: Yes Shell: 4.3.30 - /bin/bash Binaries: Node: 9.7.1 - /usr/local/bin/node Yarn: 1.5.1 - /usr/local/bin/yarn npm: 5.6.0 - /usr/local/bin/npm Languages: Bash: 4.3.30 - /bin/bash Python: 2.7.9 - /usr/bin/python
14. CLI Programmatic $ npm install envinfo $ yarn add envinfo $ npm install -g envinfo $ yarn global add envinfo Getting Started
15. $ npx envinfo@latest $ npm install envinfo && envinfo (pre npm 5.2) $ ./envinfo-macos (look ma, no node dependency!) $ curl -L getenv.info | bash
16. CLI Options •Formatting •npm •Categories —-system —-SDKs —-browsers —-languages —-duplicates —-fullTree —-markdown —-json —-showNotFound
17. import { helpers } from 'envinfo'; const os = await helpers.getOSInfo(); const docker = await helpers.getDockerInfo(); console.log({ os, docker }); import { run } from ‘envinfo'; const info = await run({…}); 
 console.log({ info });
18. defaults: { System: ['OS', 'CPU', 'Memory', 'Container', 'Shell'], Binaries: ['Node', 'Yarn', 'npm', 'Watchman'], Virtualization: ['Docker', 'Parallels', 'VirtualBox', 'VMware'], SDKs: ['iOS SDK', 'Android SDK'], IDEs: ['Android Studio', 'Atom', 'VSCode', 'Sublime Text', 'Xcode'], Languages: ['Bash', 'Go', 'Elixir', 'PHP', 'Python', 'Ruby'], Browsers: [ 'Chrome', 'Chrome Canary’, 'Firefox', 'Safari', 'Safari Technology Preview', ], npmPackages: true, npmGlobalPackages: true, },
20. So?
22. CLI help & Issue Templates $ react-native info $ create-react-app --info $ exp diagnostics $ webpack-cli info $ gatbsy info
23. HALP • 184 stars on GitHub • ~80,000 per day • ~2 million per month • ~550,000 per week
25. •Cross Platform •Time Saving •Light Touch •Files •CLI •Variables •Shell •Custom
26. Getting Started $ npm install (—-global) solidarity $ touch .solidarity $ solidarity
27. { // I’m JSON5 - comment me! $schema: “http://json.schemastore.org/solidaritySchema", requirements: { Yarn: [ { rule: "cli", binary: "yarn", semver: "~1.5.1", error: "Yarn: You have {{installedVersion}}, and need {{wantedVersion}}. Update with `npm install -g yarn@{{wantedVersion}}` or `curl -o- -L https://yarnpkg.com/install.sh | bash -s -- --version {{wantedVersion}}`" } ] } }
28. Solidarity In Action
29. Solidarity Snapshots
30. Neat Tricks • npm “pre” hooks • unterminated escape codes • git config user.email • inject wantedVersion
33. $ docker run -it --rm node:8 /bin/bash -c "npx envinfo@latest" $ envinfo --helper Docker // [ 'Docker', '18.03.0', '/usr/local/bin/docker' ] $ docker run -v $PWD:/src -w /src -u node -it --rm node /bin/bash alias dockerhere=‘…’
35. •No Human Intervention •Critical Paths •Complex Setup •Works with Docker? •Windows / macOS
36. $ vagrant init ubuntu/xenial64 $ vagrant up $ vagrant ssh -c "npx envinfo@latest" $ vagrant ssh $ vagrant halt
38. Want to see more? @TrevorBrindleJS @ModusCreate moduscreate.com github.com/tabrindle/envinfo github.com/infinitered/solidarity