353solutions / srv-2210

Practical Go Services

ArdanLabs ∴ 2022

Miki Tebeka [email protected], @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

Terminal Log

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

Terminal Log

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

Terminal Log

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

Terminal Log

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