Skip to content

SETUP.md

Latest commit

 

History

History
58 lines (43 loc) · 2.21 KB

SETUP.md

File metadata and controls

58 lines (43 loc) · 2.21 KB

Setup

1. Go

In this workshop, we will create an HTTP REST server using Go. First of all, you have make sure you have Go 1.11 or higher installed, allowing you to use the go mod feature. It makes the development easier.

If you have the right version installed, you should have something similar:

go version
> go version go1.18.5 linux/amd64 # OK

If it's not your case, you can install it using the following commands:

# Will download go binaries
wget https://go.dev/dl/go1.19.linux-amd64.tar.gz

# Will extract and move binaries into GOPATH
sudo rm -rf /usr/local/go && sudo tar -C /usr/local -xzf go1.19.linux-amd64.tar.gz

Then, open your .zshrc or .bashrc file and append the following line at the end:

export PATH=$PATH:/usr/local/go/bin:$(go env GOPATH)/bin

To create the server, we will use two external dependencies (nothing to install for now):

  • mux, an HTTP router that allows us to create routes to receive data.
  • handlers, working with mux, to add middlewares to our routes.

The language should NOT be an issue in this workshop, if you're struggling with Go, do not hesitate to ask for help !

2. Postman, Hoppscotch, Curl

We will be using postman to test out our routes, but you can also use Hoppscotch, curl, or whatever other tool you want for your tests since they will be personal, but we highly recommend postman as we will explain you how to use it.

3. Launching the server

Once everything is installed, you have to download the workshop files here. Then, go in the src folder and execute:

go run ./
# to simply launch the server

or

go build ./ && ./poc-workshop-go
# to compile a binary and run it

If you have Server runs on http://localhost:8080, you've finished the setup and you can go for the exercises

Go back to the exercises