Update README.md
This commit is contained in:
40
README.md
40
README.md
@@ -2,8 +2,6 @@
|
|||||||
|
|
||||||
This repo contains the starter code for the "Notely" application for the "Learn CICD" course on [Boot.dev](https://boot.dev).
|
This repo contains the starter code for the "Notely" application for the "Learn CICD" course on [Boot.dev](https://boot.dev).
|
||||||
|
|
||||||
This README is for reference purposes only! Follow the instructions in the course, don't start doing all the steps here in the README.
|
|
||||||
|
|
||||||
## Local Development
|
## Local Development
|
||||||
|
|
||||||
Make sure you're on Go version 1.20+.
|
Make sure you're on Go version 1.20+.
|
||||||
@@ -20,40 +18,6 @@ Run the server:
|
|||||||
go build -o notely && ./notely
|
go build -o notely && ./notely
|
||||||
```
|
```
|
||||||
|
|
||||||
*This starts the server in non-database mode.* It will serve a webpage at `http://localhost:8000`. However, you won't be able to interact with the webpage until you connect it to a MySQL database and run the migrations.
|
*This starts the server in non-database mode.* It will serve a simple webpage at `http://localhost:8000`.
|
||||||
|
|
||||||
## Database Setup
|
You do not need to set up a database and any interactivity on the page yet. Instructions for that will come later in the course!
|
||||||
|
|
||||||
This project uses a MySQL database for persistent storage. You can install MySQL locally for local development, or connect to a remote database.
|
|
||||||
|
|
||||||
Add *your* database connection string to your `.env` file. Here's an example:
|
|
||||||
|
|
||||||
```bash
|
|
||||||
DATABASE_URL="username:password@host/dbname?tls=true"
|
|
||||||
```
|
|
||||||
|
|
||||||
Once you have an empty database, you'll need to run migrations to create the schema. Make sure you have [goose](https://github.com/pressly/goose) installed:
|
|
||||||
|
|
||||||
```bash
|
|
||||||
go install github.com/pressly/goose/v3/cmd/goose@latest
|
|
||||||
```
|
|
||||||
|
|
||||||
Then run the migrations:
|
|
||||||
|
|
||||||
```bash
|
|
||||||
./scripts/migrateup.sh
|
|
||||||
```
|
|
||||||
|
|
||||||
Start the server:
|
|
||||||
|
|
||||||
```bash
|
|
||||||
go build -o notely && ./notely
|
|
||||||
```
|
|
||||||
|
|
||||||
Because the `DATABASE_URL` environment variable is set, the server will connect to the database and serve the webpage at `http://localhost:8000`. The page should be fully functional now. You can:
|
|
||||||
|
|
||||||
* Create a user (login as that user)
|
|
||||||
* Save notes
|
|
||||||
* Logout (To log in again you'll just create a new user)
|
|
||||||
|
|
||||||
*The purpose of this project is to just be a simple CRUD app that we can use to practice CI/CD. It's not meant to be a fully functional app.*
|
|
||||||
|
|||||||
Reference in New Issue
Block a user