-
Notifications
You must be signed in to change notification settings - Fork 627
Added docker support for debugging #2298
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Conversation
jonparker
commented
Jan 29, 2018
@mk0sojo That's awesome work. Hopefully this will make it much easier for people to get started.
Have you tested debugging with VS code or Visual Studio?
mk0sojo
commented
Jan 30, 2018
@jonparker Still needs to add a better debugging experience and need to speed up the restore / build process a bit.
Will look into it a bit more.
mk0sojo
commented
Feb 3, 2018
@jonparker @MisterJames Added support for debugging in VS Code and tried to speed up the build time a bit.
To try:
- Clone repo
- In AllreadyApp folder run docker-compose up
- When done open another terminal and type docker ps. allreadyweb and allreadysqlserver should be running
- Open the AllreadyApp folder in VS Code. Go to the debug tab and press play (or just F5). Brake points should now work
The only (known) limitation is that it is not possible to edit an HTML or CSS file without rebuilding.
Let me know what you think.
jonparker
commented
Feb 3, 2018
That's great. Have you heard of docker-sync? It allows for you to build within the container while having the files checked out on the host.
mk0sojo
commented
Feb 4, 2018
It looks like it could be usefull, my only concern is that it looks a bit complicated to install (on windows in particular https://github.com/EugenMayer/docker-sync/wiki/docker-sync-on-Windows). I'm not sure if that is any better than the installation instructions we currently have running everything locally? On our codathons, is there any particular step that users find difficult or is it just the number of steps?
tony-ho
commented
Feb 20, 2018
@mk0sojo I tested this on Windows and there was an issue with the line endings in AllReadyApp/entrypoint.sh:
allreadyweb | ../../entrypoint.sh: line 2: $'\r': command not found
: invalid option/../entrypoint.sh: line 3: set: -
allreadyweb | set: usage: set [-abefhkmnptuvxBCHP] [-o option-name] [--] [arg ...]
allreadyweb | ../../entrypoint.sh: line 12: syntax error: unexpected end of file
allreadyweb exited with code 2
The cause was the bash script being checked with the Windows line-ending, \r\n. When run on Linux inside the Docker container, the \r breaks the script.
The issue is described is more detail here:
https://techblog.dorogin.com/case-of-windows-line-ending-in-bash-script-7236f056abe
The solution is to configure .gitattributes to convert bash script line endings to LF on checkout so it will retain the Unix line-endings regardless of operating system.
I've made this change to a clone of your branch here:
https://github.com/tony-ho/allReady/tree/issue-branch-2247
I also rewrote the Docker connection string logic. Instead of using the ALLREADY_DOCKER_DEBUG environment variable to conditionally set Docker-specific connection strings, the connection strings can be passed as environment variables via docker-compose.yml. These will override the values in appSettings.json.
Let me know if and how you want to merge these changes.
mk0sojo
commented
Feb 21, 2018
@tony-ho Thanks for the feedback and testing it on Windows. The changes to the connection string logic looks great as well. Let me know if you have any more feedback.
MisterJames
commented
Feb 21, 2018
This is great stuff.
I'd like to merge this in, do we need another commit @mk0sojo for those line endings?
mk0sojo
commented
Feb 22, 2018
@MisterJames I have added @tony-ho changes to the pull request so it should be ok to merge now.
mk0sojo
commented
Mar 11, 2018
@MisterJames Is there anything else missing here before it can be merged?
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
@mk0sojo
I realize this is a bit old and seems forgotten by the maintainers. Still:
I've been working on similar idea for the past couple of days. Then this PR. I think some value could be added by tweaking some of the changes. Please see comments. I could do the changes but wanted to get your feedback before that.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
@mk0sojo This whole dockerfile seems to do nothing more than just install the vs debugger and then on startup just keep the process running. What purpose does it serve?
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Instead of having a whole separate file (entrypoint.sh) I believe we could just simply chain the migration and the app start. That we we can drop the .sh file and also the end-of-line issues discussed in the PR comments.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
This file seems to only have whitespace changes - perhaps it could be excluded/rolled-back from the PR (i.e. github checkout origin/master -- AllReadyApp/Web-App/AllReady/Startup.cs)
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Since the db container takes a bit of time to spin up, I'd suggest adding
restart: on-failure
So that docker could retry starting the app if the db is not yet up and running.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Also I could not see where is the logic that actually creates the database table AllReady like done in the appveyor run script
Lines 46 to 47 in 37833fc
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
This file seems to only run the migration and does not actually start the app. i.e. dotnet AllReady.dll is nowhere to be seen...
For #2247
First shot at debugging the web app in a docker containers (one for the app and one for SQL server). This is the steps to try this out:
The main remaining issue is after changing anything in the project the whole project is restored, build and nom packages are installed (even if it is just a change to a HTML file)
Will try to solve it, but please let me know what you think so far. I have only tried it on a Mac so far but it "should" work on Windows as well.