Cómo crear un Microservicio en Go

Transcript

1. CÓMO CREAR UN MICROSERVICIO EN GO viernes, 22 de noviembre de 2019 Joan López de la Franca @joanjan14 Adrián Pérez @adrianpgl
2. ¿QUIÉNES SOMOS? CÓMO CREAR UN MICROSERVICIO EN GO joanjan14 joanlopez adrianpgl aperezg
3. Para seguir la formación y compartir material utilizaremos el Slack de Friends of Go, para ello deberéis uniros en el siguiente enlace: http://bit.ly/commit-slack-fogo Uniros al canal #commitconf2019 CÓMO CREAR UN MICROSERVICIO EN GO COMUNICACIÓN DURANTE EL WORKSHOP
4. ‣ Clona el repositorio: git clone https://github.com/friendsofgo/workshop-microservices.git ‣ Obtén tu licencia de Kafka-Lense (https://lenses.io/downloads/lenses/) ‣ Haz pull de las siguientes imágenes de docker: docker pull mongo:3.4 docker pull lensesio/box:3.0.2 ‣ Baja Robo3T (https://robomongo.org/download) CÓMO CREAR UN MICROSERVICIO EN GO ANTES DE NADA
5. ¿CÓMO FUNCIONARÁ EL WORKSHOP? CÓMO CREAR UN MICROSERVICIO EN GO
6. ‣ ¿Qué es un microservicio?¿Microservicio para todo? ‣ ¿Por qué Go? ‣ ¿Qué vamos a montar? ‣ ¿Por dónde empiezo? CÓMO CREAR UN MICROSERVICIO EN GO AGENDA: SPRINT 1
7. MICROSERVICIOS CÓMO CREAR UN MICROSERVICIO EN GO
8. ‣ Gran mantenibilidad, testeabilidad, escalabilidad ‣ Desacoplado ‣ Deploy independiente ‣ Pensado para cumplir funciones concretas del negocio ‣ Puede ser gestionado por un equipo pequeño TÍTULO DE LA PRESENTACIÓN ARQUITECTURA DE MICROSERVICIOS
9. ¿MICROSERVICIO PARA TODO? CÓMO CREAR UN MICROSERVICIO EN GO
10. CÓMO CREAR UN MICROSERVICIO EN GO
11. ¿POR QUÉ GO? CÓMO CREAR UN MICROSERVICIO EN GO
12. ‣ Es muy ligero ‣ Es muy rápido ‣ Librería estándar potente para escribir web services ‣ Tiene concurrencia de serie CÓMO CREAR UN MICROSERVICIO EN GO ¿QUÉ APORTA GO, SOBRE OTROS LENGUAJES?
13. ¿QUÉ VAMOS A MONTAR? CÓMO CREAR UN MICROSERVICIO EN GO
14. ¡UNA APLICACIÓN DE CONTADORES! CÓMO CREAR UN MICROSERVICIO EN GO
15. CÓMO CREAR UN MICROSERVICIO EN GO “COUNTERS” -LA APLICACIÓN- ‣ Registro e inicio de sesión (usuarios) ‣ Crear e incrementar (contadores) ‣ Obtener estadísticas de uso (informes) ‣ Sistema de widgets (widgets) ‣ Sistema de facturación (facturación) ‣ Y más…
16. NUESTRA ARQUITECTURA CÓMO CREAR UN MICROSERVICIO EN GO COUNTERS CLIENTE USERS PAYMENTS … SISTEMA DISTRIBUIDO DE EVENTOS
17. COUNTER CÓMO CREAR UN MICROSERVICIO EN GO mongodb KAFKA COUNTERS
18. PACKAGE ORIENTED DESIGN CÓMO CREAR UN MICROSERVICIO EN GO
19. ‣ cmd/ ‣ internal/ y/o pkg/ ‣ kit CÓMO CREAR UN MICROSERVICIO EN GO ¿QUÉ NOS ENCONTRAMOS EN NUESTRO PROYECTO?
20. ¿EMPEZAMOS? CÓMO CREAR UN MICROSERVICIO EN GO
21. REPOSITORIO CÓMO CREAR UN MICROSERVICIO EN GO https://github.com/friendsofgo/workshop-microservices
22. ‣ Docker ‣ Package Oriented Design ‣ Gorilla Mux ‣ Mongo DB ‣ Kafka CÓMO CREAR UN MICROSERVICIO EN GO ¿QUÉ VAMOS A UTILIZAR?
23. ‣ Utilizar la librería estándar para crear un server http ‣ Crear un endpoint GET /health ‣ Devolver 200 OK en el header de cuando se llama a /health ‣ Imprimir en JSON {“data”: {“kind”: “health”, “message”: “everything is fine”} } CÓMO CREAR UN MICROSERVICIO EN GO ¿QUÉ VAS A HACER EN ESTE SPRINT?
24. ¿QUÉ NECESITO SABER? CÓMO CREAR UN MICROSERVICIO EN GO
25. LEVANTAR UN SERVIDOR CÓMO CREAR UN MICROSERVICIO EN GO srv := http.NewServeMux() srv.HandleFunc("/endpoint", func(w http.ResponseWriter, r *http.Request) { w.WriteHeader(http.StatusOK) w.Write([]byte("hola mundo")) }) log.Fatal(http.ListenAndServe(":3000", srv))
26. JSON MARSHAL CÓMO CREAR UN MICROSERVICIO EN GO type response struct { MyField string `json:"my_field"` MyOtherField int `json:"my_other_field,omitempty"` } r := response{MyField: "hello world"} b, err := json.Marshal(r) if err != nil { return err }
27. ¡A PICAR! CÓMO CREAR UN MICROSERVICIO EN GO
28. ¡REPASEMOS LA SOLUCIÓN! CÓMO CREAR UN MICROSERVICIO EN GO
29. SPRINT 2 CÓMO CREAR UN MICROSERVICIO EN GO
30. ‣ Refactorizar mi Servidor HTTP con Gorilla Mux ‣ Utilización de middlewares en mi servidor ‣ Testeando nuestros handlers CÓMO CREAR UN MICROSERVICIO EN GO AGENDA: SPRINT 2
31. USANDO GORILLA MUX CÓMO CREAR UN MICROSERVICIO EN GO https://www.gorillatoolkit.org/pkg/mux
32. CREAR UN SERVIDOR CON GORILLA MUX CÓMO CREAR UN MICROSERVICIO EN GO r := mux.NewRouter() r.HandleFunc("/hello", func(w http.ResponseWriter, r *http.Request) { w.WriteHeader(http.StatusOK) w.Write([]byte("hello world")) }) log.Fatal(http.ListenAndServe(":3000", r))
33. VAMOS A TESTEAR, HTTPTEST CÓMO CREAR UN MICROSERVICIO EN GO
34. TESTEANDO NUESTRO HEALTH HANDLER CÓMO CREAR UN MICROSERVICIO EN GO func TestServer_healthHandler(t *testing.T) { req, err := http.NewRequest("GET", "/health", nil) if err != nil { t.Fatalf("could not created request: %v", err) } … }
35. TESTEANDO NUESTRO HEALTH HANDLER CÓMO CREAR UN MICROSERVICIO EN GO func TestServer_healthHandler(t *testing.T) { ... rec := httptest.NewRecorder() srv := NewServer(context.Background(), "", 0, &creatingmock.Service{}, &log.Logger{}) srv.healthHandler(context.Background()).ServeHTTP(rec, req) res := rec.Result() defer res.Body.Close() ... }
36. TESTEANDO NUESTRO HEALTH HANDLER CÓMO CREAR UN MICROSERVICIO EN GO func TestServer_healthHandler(t *testing.T) { ... rec := httptest.NewRecorder() srv := NewServer(context.Background(), "", 0, &creatingmock.Service{}, &log.Logger{}) srv.healthHandler(context.Background()).ServeHTTP(rec, req) res := rec.Result() defer res.Body.Close() ... }
37. TESTEANDO NUESTRO HEALTH HANDLER CÓMO CREAR UN MICROSERVICIO EN GO func TestServer_healthHandler(t *testing.T) { ... rec := httptest.NewRecorder() srv := NewServer(context.Background(), "", 0, &creatingmock.Service{}, &log.Logger{}) srv.healthHandler(context.Background()).ServeHTTP(rec, req) res := rec.Result() defer res.Body.Close() ... }
38. TESTEANDO NUESTRO HEALTH HANDLER CÓMO CREAR UN MICROSERVICIO EN GO func TestServer_healthHandler(t *testing.T) { ... if res.StatusCode != http.StatusOK { t.Errorf("GET /health want %d, got: %d", http.StatusOK, res.StatusCode) } ... }
39. TESTEANDO NUESTRO HEALTH HANDLER CÓMO CREAR UN MICROSERVICIO EN GO func TestServer_healthHandler(t *testing.T) { ... b, err := ioutil.ReadAll(res.Body) if err != nil { t.Fatalf("GET /health has a unreadble response; %v", err) } expectedResponse := `{"data":{"kind":"health","message":"everything is fine"}}` strResponse := string(b) if strResponse != expectedResponse { t.Errorf("GET /health want response %s, got: %s", expectedResponse, strResponse) } }
40. MIDDLEWARES CÓMO CREAR UN MICROSERVICIO EN GO
41. MIDDLEWARE CÓMO CREAR UN MICROSERVICIO EN GO func loggerMiddleware(next http.Handler) http.Handler { return http.HandlerFunc( func(w http.ResponseWriter, r *http.Request) { path, _ := mux.CurrentRoute(r).GetPathTemplate() log.Printf("%s: %s\n", r.Method, path) next.ServeHTTP(w, r) }, ) }
42. USANDO MIDDLEWARES CÓMO CREAR UN MICROSERVICIO EN GO r := mux.NewRouter() r.Use(loggerMiddleware) r.HandleFunc("/hello", func(w http.ResponseWriter, r *http.Request) { w.WriteHeader(http.StatusOK) w.Write([]byte("hello world")) }) log.Fatal(http.ListenAndServe(":3000", r))
43. ¡A PICAR! CÓMO CREAR UN MICROSERVICIO EN GO git checkout sprint2
44. ‣ Refactorizar el servidor de la solución 1 usando Gorilla Mux ‣ Empezar a utilizar el logging middleware del fichero server/middleware.go ‣ Crear un middleware que logue el tiempo que ha tardado en ejecutarse nuestro handler ‣ Testear un nuevo handler, el cual se encarga de crear un nuevo contador (te damos el caso de uso hecho) CÓMO CREAR UN MICROSERVICIO EN GO ¿QUÉ VAS A HACER EN ESTE SPRINT?
45. ¡REPASEMOS LA SOLUCIÓN! CÓMO CREAR UN MICROSERVICIO EN GO
46. SPRINT 3 CÓMO CREAR UN MICROSERVICIO EN GO
47. ‣ Leyendo eventos de otro microservicio ‣ Exponer nuestro propio endpoint ‣ Publicando eventos hacia otros microservicios ‣ Empaquetando nuestro microservicio para producción CÓMO CREAR UN MICROSERVICIO EN GO AGENDA: SPRINT 3
48. APACHE KAFKA CÓMO CREAR UN MICROSERVICIO EN GO https://blog.friendsofgo.tech/posts/empezando-con-apache-kafka-en-golang/
49. CREAR UN CONSUMER CÓMO CREAR UN MICROSERVICIO EN GO dialer := kafka.Dial([]string{"http://localhost:9092"}) consumer := kafka.NewConsumer(dialer, "users", "users_group#1")
50. CREANDO UN EVENT HANDLER CÓMO CREAR UN MICROSERVICIO EN GO go func() { if err := userConsumer.Read(rootCtx, userEventHandler.Handle); err != nil { cancel() log.Fatalln(err) } }() Read(ctx context.Context, handle Handler) error MÉTODO READ
51. CREANDO UN EVENT HANDLER CÓMO CREAR UN MICROSERVICIO EN GO type Handler func(ctx context.Context, msg []byte) error
52. CREANDO UN EVENT HANDLER CÓMO CREAR UN MICROSERVICIO EN GO type User struct { creatingService creating.Service } func NewUserHandler(creatingService creating.Service) *User { return &User{creatingService: creatingService} } type createdUserEventPayload struct { UserID string `mapstructure:"user_id"` UserName string `mapstructure:"user_name"` } func (u *User) Handle(ctx context.Context, message []byte) error { // code here return nil }
53. PAQUETE DOMAIN CÓMO CREAR UN MICROSERVICIO EN GO type Event struct { ID string `json:"event_id"` EventType string `json:"event_type"` AggregateID string `json:"aggregate_id"` Payload interface{} `json:"payload"` OccurredOn time.Time `json:"occurred_on"` }
54. PAQUETE DOMAIN CÓMO CREAR UN MICROSERVICIO EN GO func EventDecode(message []byte, payload interface{}) (Event, error) { var decoded Event err := json.Unmarshal(message, &decoded) if err != nil { return Event{}, nil } if err := decoded.decodePayload(payload); err != nil { return Event{}, nil } return decoded, nil } func (e *Event) decodePayload(i interface{}) error { return mapstructure.Decode(e.Payload, i) }
55. CREAR UN PUBLISHER CÓMO CREAR UN MICROSERVICIO EN GO dialer := kafka.Dial([]string{"http://localhost:9092"}) kafkaCounterPublisher := kafka.NewPublisher(dialer, "counters")
56. ABSTRAER NUESTRO PUBLISHER CÓMO CREAR UN MICROSERVICIO EN GO type publisher interface { Publish(ctx context.Context, payload interface{}) error } type Publisher struct { publisher publisher } func NewPublisher(p publisher) *Publisher { return &Publisher{publisher: p} } func (e *Publisher) Publish(ctx context.Context, events []domain.Event) error { for _, event := range events { if err := e.publisher.Publish(ctx, event); err != nil { return err } } return nil }
57. EMPAQUETANDO NUESTRA API CÓMO CREAR UN MICROSERVICIO EN GO
58. ¡A PICAR! CÓMO CREAR UN MICROSERVICIO EN GO git checkout sprint3
59. ‣ Crear un contador por defecto cada vez que se recibe un mensaje de USER_CREATED ‣ Crear un nuevo endpoint: GET /counters/belongs-to/{user_id} ‣ Bonus: Publicar un mensaje en Kafka cada vez que un nuevo contador es creado. CÓMO CREAR UN MICROSERVICIO EN GO ¿QUÉ VAS A HACER EN ESTE SPRINT?
60. ¡REPASEMOS LA SOLUCIÓN FINAL! CÓMO CREAR UN MICROSERVICIO EN GO
61. ¡MUCHAS GRACIAS! CÓMO CREAR UN MICROSERVICIO EN GO