Skip to content

Commit

Permalink
chore: add readme for example app debugging
Browse files Browse the repository at this point in the history
  • Loading branch information
dreadl0ck committed Apr 14, 2022
1 parent b5ec699 commit 63083b9
Showing 1 changed file with 52 additions and 0 deletions.
52 changes: 52 additions & 0 deletions test/app/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,52 @@
# README

Instructions to debug the example app.

## STEPS

Install dependencies:

$ brew install helm kubectx k9s

Start docker, check which context you are connected to:

$ kubectx
docker-desktop

Setup local cluster, deploy test chart:

$ cd test/app
$ make build && make deploy

Use k9s to check if the example app pod is running:

$ k9s

then patch:

$ gograpple patch example --image golang

and debug (using vscode):

$ gograpple delve example --source . --vscode

set a breakpoint in the HTTP handler.

> Note: before the startup of the service debugging does not work as delve is not started yet!
Use port forwarding via k9s to expose the pod (shift-F):

- App Port: 80
- Local Port: 8080

> Note: This will be reverted once you exit k9s!
Now access the web service by visiting: http://localhost:8080

You should be dropped into the debugger in VSCode at the breakpoint!

Once done, rollback:

$ gograpple patch example --rollback

Happy debugging!

0 comments on commit 63083b9

Please sign in to comment.