Skip to content

Commit 5ebcfa8

Browse files
Cleaned up README
1 parent 963770b commit 5ebcfa8

File tree

2 files changed

+19
-5
lines changed

2 files changed

+19
-5
lines changed

README.md

Lines changed: 18 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,22 +1,36 @@
11
# gomin
22

3-
## Get Started
3+
## Pre-requisites
44

55
1. Install [Pre-Commit](https://pre-commit.com/). This project uses pre-commit to ensure code is all nice and tidy before others can see it.
66
2. Install the pre-commit hooks by running `pre-commit install`
77
3. Install [Atlas](https://atlasgo.io/getting-started). Atlas is used for database migrations
88

9+
## Getting Started
10+
11+
This project uses [Taskfile](https://taskfile.dev/) for running tasks. The following tasks are available
12+
13+
- `task build` - creates the executable storing it in `out/bin` directory along with the config file
14+
- `task clean` - cleans various build artifacts
15+
- `task d.build` - builds the docker container
16+
- `task d.down` - shuts down the docker containers
17+
- `task d.up` - starts up the docker containers (postgres + gomin api)
18+
- `task db.migrate` - useful when changing the `database/schema.hcl` file, applies changes to the local database
19+
- `task db.up` - useful for ONLY starting the database (not the api)
20+
- `task server.run` - runs the code locally (not using docker)
21+
- `task test` - runs tests including coverage
22+
923
## Roadmap
1024

1125
1. [x] - Simple REST API
1226
2. [x] - Add initial Makefile
1327
3. [x] - Add pre-commit
14-
4. [ ] - Initial database setup
15-
5. [ ] - Incorpoate database into REST API
28+
4. [x] - Initial database setup
29+
5. [x] - Incorpoate database into REST API
1630
6. [ ] - Integration tests for database
1731
7. [ ] - E2E tests for REST API
1832
8. [ ] - Add github build for golang
19-
9. [ ] - Add docker packaging
33+
9. [x] - Add docker packaging
2034
10. [ ] - Add docker image build in Github Actions on Tag
2135
11. [ ] - Terraform plan for RDS
2236
12. [ ] - Terraform plan for ECS

Taskfile.yaml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -18,7 +18,7 @@ tasks:
1818

1919
d.build:
2020
cmds:
21-
- docker build -t ghcr.io/pauljamescleary/gomin:latest --build-arg ENV=$APP_ENV .
21+
- docker build -t ghcr.io/pauljamescleary/gomin:latest .
2222

2323
d.down:
2424
cmds:

0 commit comments

Comments
 (0)