Skip to content
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

Added docker support for debugging #2298

Open
wants to merge 3 commits into
base: master
Choose a base branch
from

Conversation

mk0sojo
Copy link
Contributor

@mk0sojo mk0sojo commented Jan 27, 2018

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:

  1. Download and install Git, Docker and Editor or IDE (e.g. VS Code).
  2. Make sure Docker is set up to use Linux containers (if running on Windows) and got 4 GB memory or more allocated to run SQL Server (set in Preferences).
  3. Fork and clone repository
  4. Open terminal or Powershell
  5. Cd to the AlreadyApp directory and type “docker-compose up”. This will take some time the first time it runs as it will download ASP.Net core and SQL Server base images.
  6. Open a browser and navigate to localhost:8000

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.

@jonparker
Copy link
Contributor

@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
Copy link
Contributor Author

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
Copy link
Contributor Author

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:

  1. Clone repo
  2. In AllreadyApp folder run docker-compose up
  3. When done open another terminal and type docker ps. allreadyweb and allreadysqlserver should be running
  4. Open the AllreadyApp folder in VS Code. Go to the debug tab and press play (or just F5). Brake points should now work

image

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
Copy link
Contributor

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.

http://docker-sync.io

@mk0sojo
Copy link
Contributor Author

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
Copy link

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
Copy link
Contributor Author

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
Copy link
Contributor

This is great stuff.

I'd like to merge this in, do we need another commit @mk0sojo for those line endings?

@mk0sojo
Copy link
Contributor Author

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
Copy link
Contributor Author

mk0sojo commented Mar 11, 2018

@MisterJames Is there anything else missing here before it can be merged?

Copy link

@gparlakov gparlakov left a 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.

@@ -0,0 +1,12 @@
FROM microsoft/aspnetcore-build:2.0

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?

RUN gulp clean && gulp min
EXPOSE 80/tcp
RUN chmod +x ../../entrypoint.sh
CMD /bin/bash ../../entrypoint.sh

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
CMD /bin/bash ../../entrypoint.sh
CMD /bin/bash "dotnet ef database update && dotnet AllReady.dll"

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.

@@ -169,7 +169,7 @@ public IServiceProvider ConfigureServices(IServiceCollection services)

//Hangfire
services.AddHangfire(configuration => configuration.UseSqlServerStorage(Configuration["Data:HangfireConnection:ConnectionString"]));

services.AddScoped<IAllReadyUserManager, AllReadyUserManager>();

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)

ports:
- "8000:80"
depends_on:
- db

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.

ACCEPT_EULA: "Y"

volumes:
sql-server-data:

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

allReady/appveyor.yml

Lines 46 to 47 in 37833fc

- ps: cd (Join-Path $env:APPVEYOR_BUILD_FOLDER "AllReadyApp\Web-App\AllReady")
- ps: sqlcmd -S "(local)\SQL2016" -Q "Use [master]; CREATE DATABASE [AllReady]"
for example

>&2 echo "SQL Server is starting up"
sleep 1
done

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...

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

5 participants