Hello 👋 Microservices

A TODO application with a microservice architecture.

Architecture Diagram

Folder Structure

.
├── README.md
├── api-server # todo application api server
├── assets # assets for README.md
├── authentication # todo application authentication server
├── frontend # todo application frontend
├── installation # helm chats for installation
├── mongo # todo application mongo db

Prerequisites

• buy your domain
• create your GCP project
• install helm, argocd cli tools

How to start

1. complete prerequisites
2. setup Kubernetes Cluster
3. install cert-manager

   kubectl apply -f https://github.com/cert-manager/cert-manager/releases/download/v1.12.0/cert-manager.yaml

4. install OpenTelemetry, Jaeger, Prometheus, Grafana, Grafana

   kubectl create namespace observability
   # jaeger
   kubectl create -f https://github.com/jaegertracing/jaeger-operator/releases/download/v1.46.0/jaeger-operator.yaml -n observability
   kubectl create -f ./installation/00-monitoring/jaeger.yaml -n observability
   
   # prometheus operator, quick start guide: https://prometheus-operator.dev/docs/prologue/quick-start/
   git clone https://github.com/prometheus-operator/kube-prometheus.git
   kubectl create -f ./kube-prometheus/manifests/setup
   # wait for namespaces and CRDs to become available, then
   kubectl create -f ./kube-prometheus/manifests/
   
   # prometheus
   kubectl create -f ./installation/00-monitoring/prometheus.yaml
   
   # OpenTelemetry Collector
   kubectl create -f ./installation/00-monitoring/otel-collector.yaml

5. install ArgoCD

   # quick start guide: https://argo-cd.readthedocs.io/en/stable/
   kubectl create namespace argocd
   kubectl apply -n argocd -f https://raw.githubusercontent.com/argoproj/argo-cd/stable/manifests/install.yaml

6. install Litmus

   # quick start guide: https://docs.litmuschaos.io/docs/getting-started/installation
   kubectl apply -f https://litmuschaos.github.io/litmus/3.0.0-beta8/litmus-3.0.0-beta8.yaml

7. install harbor

   # Edit ./installation/harbor-values.yaml
   # externalURL: registry.your.domain
   # harborAdminPassword: your-password
   helm repo add harbor https://helm.goharbor.io
   helm repo update
   helm install harbor harbor/harbor -f ./installation/harbor-values.yaml -n harbor-system --create-namespace

8. install Traefik

   # Edit ./installation/01-traefik-helm/values.yaml
   # adminConfig.DOMAIN_NAME: your-domain.com
   # adminConfig.EMAIL: your-email@email.com
   helm install traefik ./installation/01-traefik-helm -n traefik-system --create-namespace

9. buy domain name & setup Cloud DNS

   set 'A record' to traefik external IP

10. Access to ArgoCD UI

    # quick start guide: https://argo-cd.readthedocs.io/en/stable/
    # access to ArgoCD UI via https://argocd.your.domain
    # setup user
    kubectl edit configmap argocd-cm -n argocd
    # data:
    #   accounts.username: apiKey, login
    argocd account update-password \
     --account username \
     --current-password admin-password \
     --new-password new-password
    # edit RBAC
    kubectl edit configmap argocd-rbac-cm -n argocd
    # data:
    # policy.csv: |
    #    g, new-username, role:admin # you can set role what you want

11. deploy application by ArgoCD

    # Edit ./installation/02-applicatioin-helm/values.yaml
    # adminConfig.DOMAIN_NAME: your-domain.com
    # adminConfig.EMAIL: your-email@your-domain
    # frontend.image.repository: your-frontend-image-repository
    # frontend.image.tag: your-frontend-image-tag
    # backend.APIServer.image.repository: your-backend-image-repository
    # backend.APIServer.image.tag: your-backend-image-tag
    # backend.AuthServer.image.repository: your-authentication-image-repository
    # backend.AuthServer.image.tag: your-authentication-image-tag
    
    # Access ArgoCD UI

Reference

1. setup GKE
2. setup traefik with cert-manager
3. Jaeger 101
4. OpenTelemetry 101
5. OpenTelemetry with Jaeger in Go
6. Prometheus vs Open Telemetry
7. OpenTelemetry collector example