O slideshow foi denunciado.
Utilizamos seu perfil e dados de atividades no LinkedIn para personalizar e exibir anúncios mais relevantes. Altere suas preferências de anúncios quando desejar.
Troubleshooting
guides and team docs
for your Kubernetes
deployments
using Notebooks
✨
Want to follow along? Go here:
https://github.com/TylerLeonhardt/Manning-Kubernetes-Notebooks
@TylerLeonhardt – Software Engineer - Microsoft
I’m not a Kubernetes expert
(But I like to think I know a thing or two about docs and running commands)
Is this you/your team?
• Have misc onboarding docs for your project
• Have troubleshooting guides for when stuff goes wron...
You can do better…
• OneNote, Notion, Google Docs
• Doesn’t have real source control so change tracking is hard
• Code for...
Picture this…
Markdown,
with
executable
code blocks
Backed by a JSON file
or readable text format
for source control
Notebooks 📒📓📔📕📗📘📙
Data
professionals
have been
using
Notebooks for
years
WHY?
• The interactive
experience came first
(run code, see output)
• Rich output – plotting
.NET Interactive will be
our backend
• Can act as a Juypter kernel
• Provides PowerShell support out of the box
• PowerShe...
Notebooks Demo
📒📓📔📕📗📘📙
A Notebook is an abstract concept
When I talk about Notebooks, I’m talking about the user experience
Markdown as docs
Code...
Jupyter Notebooks
• File extension: ipynb
• File format: json
• File contains last output: yes
.NET Interactive Books
• File extension: dib
• File format: ”scriptwich”
• File contains last output: no
Choose your own adventure
Cloud (only
ipynb's for
now...)
Jupyter Lab
MyBinder
Self hosted
somewhere
Local
ipynbs
Jupyter ...
Demos
• Managing a local Kubernetes cluster
• Managing an AKS cluster locally
• Managing an AKS cluster using Az Shell
• P...
My use of PowerShell…
PowerShell is just a shell and scripting language – like bash, zsh, fish.
The syntax is a bit differ...
My advice
• Use the GitHub template if you can
• Comes with everything you need and is easy to customize
• Can be used in ...
Big slide of links
• .NET Interactive – https://github.com/dotnet/interactive
• Editors
• Jupyter Lab - https://github.com...
Crafting interactive troubleshooting guides and team documentation for your Kubernetes deployments using Jupyter Notebooks...
Crafting interactive troubleshooting guides and team documentation for your Kubernetes deployments using Jupyter Notebooks...
Crafting interactive troubleshooting guides and team documentation for your Kubernetes deployments using Jupyter Notebooks...
Crafting interactive troubleshooting guides and team documentation for your Kubernetes deployments using Jupyter Notebooks...
Crafting interactive troubleshooting guides and team documentation for your Kubernetes deployments using Jupyter Notebooks...
Próximos SlideShares
Carregando em…5
×

Crafting interactive troubleshooting guides and team documentation for your Kubernetes deployments using Jupyter Notebooks with Tyler Leonhardt.

284 visualizações

Publicada em

Tyler Leonhardt's slides from the live@Manning Kubernetes conference (June 30th, 2020).

Learn more about live@Manning conferences here: https://freecontent.manning.com/livemanning-conferences/

Publicada em: Software
  • Seja o primeiro a comentar

  • Seja a primeira pessoa a gostar disto

Crafting interactive troubleshooting guides and team documentation for your Kubernetes deployments using Jupyter Notebooks with Tyler Leonhardt.

  1. 1. Troubleshooting guides and team docs for your Kubernetes deployments using Notebooks
  2. 2. ✨ Want to follow along? Go here: https://github.com/TylerLeonhardt/Manning-Kubernetes-Notebooks
  3. 3. @TylerLeonhardt – Software Engineer - Microsoft
  4. 4. I’m not a Kubernetes expert (But I like to think I know a thing or two about docs and running commands)
  5. 5. Is this you/your team? • Have misc onboarding docs for your project • Have troubleshooting guides for when stuff goes wrong • Probably in OneNote, Notion, Google Docs, Plain markdown
  6. 6. You can do better… • OneNote, Notion, Google Docs • Doesn’t have real source control so change tracking is hard • Code formatting is a little tricky • Markdown • Better than the others since it can be next to code in a git repo • Requires an extra step to render it usually • All of these are static – copy paste commands into your terminal
  7. 7. Picture this… Markdown, with executable code blocks
  8. 8. Backed by a JSON file or readable text format for source control
  9. 9. Notebooks 📒📓📔📕📗📘📙
  10. 10. Data professionals have been using Notebooks for years
  11. 11. WHY? • The interactive experience came first (run code, see output) • Rich output – plotting
  12. 12. .NET Interactive will be our backend • Can act as a Juypter kernel • Provides PowerShell support out of the box • PowerShell can run native executables like bash/zsh can • Provides plotting out of the box for PowerShell too
  13. 13. Notebooks Demo 📒📓📔📕📗📘📙
  14. 14. A Notebook is an abstract concept When I talk about Notebooks, I’m talking about the user experience Markdown as docs Code that you can execute
  15. 15. Jupyter Notebooks • File extension: ipynb • File format: json • File contains last output: yes
  16. 16. .NET Interactive Books • File extension: dib • File format: ”scriptwich” • File contains last output: no
  17. 17. Choose your own adventure Cloud (only ipynb's for now...) Jupyter Lab MyBinder Self hosted somewhere Local ipynbs Jupyter Lab nteract Azure Data Studio (in the future…) Visual Studio Code dibs Visual Studio Code
  18. 18. Demos • Managing a local Kubernetes cluster • Managing an AKS cluster locally • Managing an AKS cluster using Az Shell • Plotting output of kubectl
  19. 19. My use of PowerShell… PowerShell is just a shell and scripting language – like bash, zsh, fish. The syntax is a bit different… but one-off commands you run in bash should work the same (I hope my examples have shown that) You may even come to like PowerShell’s syntax… and if not, you can of course run bash from PowerShell: PS > bash -c ’echo 5’
  20. 20. My advice • Use the GitHub template if you can • Comes with everything you need and is easy to customize • Can be used in MyBinder when you’re on the move or locally via Docker • Can be opened in Jupyter Lab or Azure Data Studio locally • If you don’t want to install Python, use dibs • They’ll only become more powerful in time • They work in VS Code already • Try Azure Data Studio if you want to use ipynb’s and don’t mind installing Python
  21. 21. Big slide of links • .NET Interactive – https://github.com/dotnet/interactive • Editors • Jupyter Lab - https://github.com/jupyterlab/jupyterlab#getting-started • Visual Studio Code Insiders - https://code.visualstudio.com/insiders/ • .NET Interactive Notebooks extension: https://marketplace.visualstudio.com/items?itemName=ms-dotnettools.dotnet-interactive- vscode • Azure Data Studio Insiders - https://github.com/microsoft/azuredatastudio#try-out-the-latest-insiders-build-from-main • nteract - https://nteract.io/ • Sample Notebooks repo – https://github.com/TylerLeonhardt/JupyterNotebooks • Sample DIBs repo – https://github.com/TylerLeonhardt/dotnet-interactive-books • K8s docs and guides used in this talk • https://github.com/feiskyer/kubernetes-handbook/blob/master/en/troubleshooting/index.md • https://github.com/kubernetes/website/blob/master/content/en/docs/tasks/debug-application-cluster/debug-application- introspection.md • PowerShell – https://github.com/PowerShell/PowerShell • Fastpages (Notebooks for blogging!) - https://github.com/fastai/fastpages

×