-
Notifications
You must be signed in to change notification settings - Fork 404
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Signed-off-by: Dan Luhring <[email protected]>
- Loading branch information
Showing
1 changed file
with
29 additions
and
0 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,29 @@ | ||
# Debugging | ||
|
||
Sometimes it's challenging to track down the cause of unexpected behavior in an app. Because `ko` makes it simple to make tweaks to your app and immediately rebuild your image, it's possible to iteratively explore various aspects of your app, such as by adding log lines that print variable values. | ||
|
||
But for those times when you want to solve the problem _as fast as possible_, `ko` supports debugging your Go app with [delve](https://github.com/go-delve/delve). | ||
|
||
To use this feature, just add the `--debug` flag to your `ko build` command. This adjusts how the image is built: | ||
|
||
- It installs `delve` in the image (in addition to your own app). | ||
- It sets the image's `ENTRYPOINT` to a `delve exec ...` command that runs the Go app in debug-mode, listening on port `40000` for a debugger client. | ||
- It ensures your compiled Go app includes debug symbols needed to enable debugging. | ||
|
||
**Note:** This feature is geared toward development workflows. It **should not** be used in production. | ||
|
||
### How it works | ||
|
||
Build the image using the debug feature. | ||
|
||
```plaintext | ||
ko build . --debug | ||
``` | ||
|
||
Run the container, ensuring that the debug port (`40000`) is exposed to allow clients to connect to it. | ||
|
||
```plaintext | ||
docker run -p 40000:40000 <img> | ||
``` | ||
|
||
This sets up your app to be waiting to run the command you've specified. All that's needed now is to connect your debugger client to the running container! |