This repository has been archived on 2023-10-28. You can view files and clone it, but cannot push or open issues or pull requests.
pwt-0x01-ng/README.md
surtur 0741deaff9
chore: change compose targets
* update Makefile and README
* [skip ci]
2021-01-23 14:25:24 +01:00

36 lines
1.4 KiB
Markdown

# pwt-0x01-ng
this repo holds *sawce* for PWT .netcore mvc project 0x01-ng
### how to run this
- Makefile (you need `make` for this) --> see the [[Makefile]]
- direct `dotnet` (and/or `docker`) commands
#### useful Makefile targets
- `restore` --> runs `dotnet restore .`
- `clean` --> clean builds the project
- `build` --> builds the project
- `dockerdevbuild` --> clean-builds a container image from [[Dockerfile.dev]] (have a look in there for details)
- `dcdevb` --> compose clean build of a debug (dev) version, pulling db
- `dcdevup` --> runs the above (see [[docker-compose.yml]])
> you need to have created a db beforehand to run these
- `run` --> runs `$CURRENT_ENV dotnet watch run .`
- `dev` --> runs `restore build run` - this is kind of a convenience target
#### run using dotnet
> run the `dotnet` commands from the solution folder
> note that a preconfigured db is required for any kind of running the project (consider taking a look at [useful makefile targets](#useful-makefile-targets))
on the first run, restore stuff
```sh
dotnet restore
```
build and run
```sh
dotnet build && dotnet run
```
#### errors
if you get a weird long error about not being able to listen bind a port, make sure nothing else is listening on the port *this* thing is trying to bind (tcp/5000).
if something else *is* already listening, solve it by killing it before running `dotnet run` or change the app port in [[Properties/launchSettings.json]]