353solutions/srv-2210

Go

Practical Go Services

ArdanLabs ∴ 2022

Miki Tebeka miki@353solutions.com, @tebeka, mikitebeka, blog

Shameless Plugs

Go Essential Training - LinkedIn Learning
- Rest of classes
Go Brain Teasers book

Day 4

Agenda

Security best practices
OWASP top 10
The security mindset

Links

casbin - Authorization framework
golang.org/x/crypto/acme/autocert - Certificates from Let's Encrypt
Guide to HTTP timeouts
golang.org/x/time/rate Rate limiting
OWASP top 10
gosec - Security oriented linter
html/template
gorilla/handlers - CORS

Data & Other

curl -d@./_class/start.json http://localhost:8080/rides
curl -uBond:007 -d@./_class/start.json http://localhost:8080/rides

Day 3

Agenda

Testing overview
Testing handlers
Running services in testing
Mocking
Performance optimization

Links

Linters
- staticcheck
- golangci-lint
- Write your own with x/tools/go/analysis
Testing
- testing
- testify - Many test utilities (including suites & mocking)
- Tutorial: Getting started with fuzzing
  - testing/quick - Initial fuzzing library
- test containers
- net/http/httptest
- How SQLite is Tested
Performance Optimization
- Miki's Optimization guidelines
- Amdahl's Law - Limits of concurrency
- Computer Latency at Human Scale
- Rules of Optimization Club
- Profiling Go Programs In the Go blog
- High Performance Go Workshop by Dave Cheney
- hey
  - go install github.com/rakyll/hey@latest
  - export PATH=$(go env GOPATH)/bin:${PATH}

Data & Other

go get github.com/rakyll/hey@latest

Day 2

Agenda

Databases
Working with database/sql
Working with redis
Logging
Monitoring

Links

copier - Copy struct to another
multierr - Combine errors
Databases
- database/sql
- sqlx
- lig/pg
- sqlc - Generate code
- gorm - ORM
- pgcli - PostgreSQL command line client
- go-redis
- bbolt
Logging & Metrics
- log
- uber/zap
- expvar
  - expvarmon
- Open Telemetry
- Let's talk about logging by Dave Cheney
- Prometheus metric types

Data & Other

docker exec -it <id> psql -U postgres
- or pgcli -p 5432 -U postgres -h localhost
docker exec -it <id> redis-cli

Day 1

Agenda

REST APIs
Handlers
JSON
Middleware

Code

Clone the repo:

$ git clone https://github.com/353solutions/srv-2210.git unter

Links

Configuration
- conf
- viper & cobra
ArdanLabs service - More complex system
Validation
- cue
- validator
REST APIs
- HTTP status cats
- encoding/json
- net/http
- gorilla/mux - HTTP router with more frills
- chi - A nice web framework
  - Also Gin, Echo, Fiber, fasthttp, ...
Setting up
- Go SDK
  - go version
- And IDE such as VSCode or Goland
- git
  - git --version
- Docker
  - docker pull postgres:15-alpine
  - docker pull redis:7-alpine

Design

[library]
layers:
    - business
    - foundations

front ends: [web] [cli] [gui]

Rules of thumb: imports go downward in the layers

Data Types: one per layer API Business Database

Data & Other

curl -d'{"driver": "gomez", "kind": "private"}' http://localhost:8080/rides
curl -d'{"distance": 3.14}' http://localhost:8080/rides/<id>/end