asepharyana
dcb93035f3
fix(infra): update NATS configuration for OpenTelemetry tracing and JetStream support refactor(dapr): modify Dapr sidecar configuration to use new resources path and config file chore(docs): update deployment documentation to include observability services docs(commit-convention): establish commit message guidelines for Asepharyana Hub docs(deploy-workflow): outline CI/CD pipeline and manual deployment steps for Asepharyana Hub feat(event-driven): implement event-driven architecture patterns with Dapr and NATS docs(hub-rules): define repository structure, submodule strategy, and infrastructure patterns
3.0 KiB
3.0 KiB
name, description
| name | description |
|---|---|
| hub-rules | Repository structure, submodule strategy, infrastructure patterns, and architecture of Asepharyana Hub |
Asepharyana Hub — Repository Rules
Struktur Repository
asepharyana-hub/
├── apps/ # Git submodules — source code aplikasi
├── docs/ # Dokumentasi, ADR, deployment guide
├── infra/ # Infrastructure as code
│ ├── compose/ # Satu compose file per service
│ ├── dapr/ # Dapr component configs
│ ├── docker/ # Dockerfiles per service
│ └── traefik/ # Static & dynamic Traefik config
├── scripts/ # Utility scripts (cleanup, update-deps)
└── .github/workflows/ # CI/CD pipelines
Aturan Submodule
- Setiap aplikasi di
apps/adalah submodule ke repo terpisah. - Perubahan kode aplikasi dilakukan di repo masing-masing, bukan di sini.
- Submodule pointer diupdate oleh CI/CD (bukan manual).
Infrastructure Patterns
Networking
- Semua service join
app-shared-net(external Docker bridge) - Service discovery via Docker DNS (container alias)
- Traefik sebagai ingress untuk HTTP/S eksternal
- Tailscale untuk cross-VPS (PostgreSQL, Redis)
Compose File Pattern
services:
<service>:
container_name: <service>
image: ghcr.io/asepharyana/asepharyana-hub/<service>:sha-<sha>
restart: always
networks:
app-shared-net:
aliases:
- <service>
env_file:
- ../../.env
networks:
app-shared-net:
name: app-shared-net
external: true
Dapr Sidecar Pattern
<service>-dapr:
container_name: <service>-dapr
image: daprio/daprd:latest
restart: always
depends_on:
nats:
condition: service_started
dapr-placement:
condition: service_started
networks:
- app-shared-net
command:
- './daprd'
- '--app-id=<service>'
- '--app-port=<port>'
- '--dapr-http-port=3500'
- '--dapr-grpc-port=50001'
- '--placement-host-address=dapr-placement:50005'
- '--resources-path=/components'
volumes:
- ../../infra/dapr/components:/components
Traefik Routing
- Router + service definition di
infra/traefik/dynamic/apps.yaml - Subdomain pattern:
<service>.asepharyana.my.id+<service>.asepharya.web.id - TLS cert dari volume mount (bukan auto-acme)
Image Tagging
sha-<short-sha>— immutable, untuk rollbacklatest— mutable, untuk convenience- Registry:
ghcr.io/asepharyana/asepharyana-hub/<service>
CI/CD
docker-build-push.yml— build per service, push ke GHCR, update compose manifestdeploy-docker.yml— SSH ke orangevps, pull images, restart- Selective deploy: hanya compose file yg berubah
Deployment Order
shared.yml(Redis)nats.yml(NATS message bus)dapr.yml(Dapr placement)traefik.yml(Reverse proxy)- Service compose files (apps + Dapr sidecar)