Welcome to GoTAL, a Go-based enterprise project. This project utilizes a robust architecture suitable for scalable and efficient web services.
- Golang environment setup
- http server + grpc server (microservices)
- MySQL and Redis services running
- Necessary environment variables set for MySQL and Redis configurations
┌───────────────┐ ┌───────────────┐ ┌───────────────┐
│ Frontend │ │ Frontend │ │ Frontend │ ...... (Different Roles Of Clients)
│ (Customer) │ │ (Admin) │ │ (Robot) │
└───────┬───────┘ └───────┬───────┘ └───────┬───────┘
│ │ │
▼ ▼ ▼
┌───────────────┐ ┌───────────────┐ ┌───────────────┐
│ BFF │ │ BFF │ │ BFF │
│ (Controller │ │ (Controller │ │ (Controller │
│ + Service) │ │ + Service) │ │ + Service) │
└───────┬───────┘ └───────┬───────┘ └───────┬───────┘
│ │ │
▼ ▼ ▼
┌───────────────┐ ┌───────────────┐ ┌───────────────┐
│ Store Layer │ │ Store Layer │ │ Store Layer │
│ (gRPC Client) │ │ (gRPC Client) │ │ (gRPC Client) │
└───────┬───────┘ └───────┬───────┘ └───────┬───────┘
│ │ │
▼ ▼ ▼
┌───────────────┐ ┌───────────────┐ ┌───────────────┐
│ Backend gRPC │ │ Backend gRPC │ │ Backend gRPC │
│ Services │ │ Services │ │ Services │
│(Service + │ │(Service + │ │(Service + │
│ Store) │ │ Store) │ │ Store) │
└───────────────┘ └───────────────┘ └───────────────┘
│ │ │
└───────────────────────┴───────────────────────┘
│
▼
┌───────────┐
│ Database │
└───────────┘
├── CHANGELOG
├── CONTRIBUTING.md
├── LICENSE
├── Makefile
├── README.md
├── api
├── build
├── cert
│ ├── apiserver-key.pem
│ ├── apiserver.pem
│ ├── san.cnf
│ ├── server.crt
│ ├── server.csr
│ └── server.key
├── cmd
│ ├── apiserver
│ │ ├── stdout
│ │ ├── apiserver
│ │ └── apiserver.go
│ ├── authzserver
│ │ ├── authzserver
│ │ └── authzserver.go
│ ├── redis_test
│ │ ├── main
│ │ ├── main.go
│ │ └── redis_test
│ ├── rpc_test
│ │ └── main.go
│ └── user_service
│ ├── user.go
│ └── user_service
├── configs
│ ├── apiserver-client.yaml
│ ├── authzserver.yaml
│ └── user-service.yaml
├── deployments
├── docs
├── githooks
├── go.mod
├── go.sum
├── image.png
├── init
├── init.sh
├── internal
│ ├── apiserver
│ │ ├── app.go
│ │ ├── auth.go
│ │ ├── config
│ │ ├── controller
│ │ ├── grpc.go
│ │ ├── options
│ │ ├── router.go
│ │ ├── run.go
│ │ ├── server.go
│ │ ├── service
│ │ └── store
│ ├── authzserver
│ │ ├── app.go
│ │ ├── config
│ │ ├── options
│ │ ├── run.go
│ │ └── server.go
│ ├── pkg
│ │ ├── code
│ │ ├── errors
│ │ ├── logger
│ │ ├── middleware
│ │ ├── options
│ │ ├── response
│ │ ├── server
│ │ ├── util
│ │ └── validation
│ ├── proto
│ │ ├── options
│ │ └── user
│ └── user_service
│ ├── app.go
│ ├── config
│ ├── doc.go
│ ├── grpc.go
│ ├── options
│ ├── router.go
│ ├── run.go
│ ├── server.go
│ ├── service
│ └── store
├── logs
│ ├── apiserver.error.log
│ ├── apiserver.log
│ └── user_service
│ ├── user.error.log
│ └── user.log
├── pkg
│ ├── app
│ │ ├── app.go
│ │ ├── cmd.go
│ │ ├── config.go
│ │ ├── help.go
│ │ └── option.go
│ ├── cache
│ │ ├── cache.go
│ │ └── redis.go
│ ├── cli
│ ├── db
│ │ ├── mysql.go
│ │ └── plugin.go
│ ├── log
│ │ ├── context.go
│ │ ├── encoder.go
│ │ ├── log.go
│ │ ├── options.go
│ │ └── types.go
│ ├── shutdown
│ │ ├── managers
│ │ └── shutdown.go
│ ├── util
│ │ ├── common
│ │ ├── flag
│ │ └── term
│ └── validator
├── test
│ └── ratelimiter-test.sh
├── third_party
└── tools
61 directories, 64 files
-
Building the API server: Navigate to the API server directory:
cd /Users/huanghaitao/gotal/cmd/apiserverBuild the API server:
go build -
Starting the Server: Run the API server with the specified configuration:
./apiserver --config ../../configs/apiserver.yamlThis will initialize the server with various configurations as shown in your provided start-up log.
After the section on starting the server, the following detailed configurations are applied:
server:
mode: debug # Modes: release, debug, test. Default is release.
healthz: true # Enable health check, setting up /healthz route. Default is true.
middlewares: recovery,logger,secure,nocache,cors,dump # List of gin middlewares.grpc:
bind-address: 0.0.0.0 # IP address for gRPC. Default is 0.0.0.0.
bind-port: 8082 # Port for gRPC. Default is 8081.insecure:
bind-address: 0.0.0.0 # IP address for insecure binding. Default is 127.0.0.1.
bind-port: 8884 # Non-secure port. Default is 8080.secure:
bind-address: 0.0.0.0 # IP address for HTTPS. Default is 0.0.0.0.
bind-port: 8445 # Port for HTTPS. Default is 8443.
tls:
cert-key:
cert-file: /Users/huanghaitao/gotal/cert/apiserver.pem # Certificate file path.
private-key-file: /Users/huanghaitao/gotal/cert/apiserver-key.pem # Private key file path.mysql:
host: 127.0..0.1 # MySQL server address.
username: root # MySQL username.
password: # MySQL password.
database: db # Database name.
max-idle-connections: 100 # Max idle connections.
max-open-connections: 100 # Max open connections.
max-connection-life-time: 10s # Connection lifetime.
log-level: 4 # Log level.redis:
host: 127.0.0.1 # Redis host.
port: 6379 # Redis port.
password: # Redis password.
# Additional configuration details can be specified here.jwt:
realm: JWT # JWT realm identifier.
key: # Secret key.
timeout: 24h # Token expiration time.
max-refresh: 24h # Token refresh time.feature:
enable-metrics: true # Enable metrics at /metrics.
profiling: true # Enable performance analysis at /debug/pprof/.ratelimit:
requests-per-second: 1 # Requests per second per user.
burst-size: 20 # Maximum burst size.
custom-limits:
"/test-response":
requests-per-second: 1.5 # Requests per second for specific endpoint.
burst-size: 10 # Burst size for specific endpoint.log:
name: apiserver # Logger name.
development: true # Development mode.
level: debug # Log level.
format: console # Log format.
enable-color: true # Color output.
disable-caller: false # Caller information.
disable-stacktrace: false # Stack trace.
output-paths: /Users/huanghaitao/gotal/logs/apiserver.log # Output paths.
error-output-paths: /Users/huanghaitao/gotal/logs/apiserver.error.log # Error log paths.This detailed configuration will ensure that your GoTAL API server is set up with the specific settings required for its operation. These settings include server modes, service bindings, database connections, logging, and more, ensuring a comprehensive and robust setup for your enterprise-grade application.
The server's behavior is controlled by various flags and options. These include but are not limited to:
- gRPC Configurations: Address, port, message size limits.
- MySQL and Redis Configurations: Host, port, authentication, pooling settings.
- JWT Settings: Key, timeout, refresh settings.
- Server Mode: Including debug, test, and release modes.
Detailed flag descriptions are available in the start-up log section of this README.
The project is structured into several layers to promote separation of concerns and maintainability:
- Controller Layer: Handles HTTP requests, invoking the appropriate services.
- Service Layer: Contains business logic and interacts with the repository layer.
- Repository Layer: Responsible for data access and storage management.
- Cobra & Viper: Used for building CLI and managing configuration files.
- Validator: Ensures that incoming requests meet the defined constraints.
- Middleware: Includes authentication, logging, CORS, rate limiting, etc.
- Logging: Structured logging for tracing and monitoring.
- MySQL & Redis: Used for data storage and caching.
Refer to CONTRIBUTING.md for guidelines on how to contribute to this project.
This project is licensed under the terms mentioned in LICENSE.
For a detailed changelog, see CHANGELOG.
This README provides a basic overview of GoTAL. For detailed documentation, refer to the docs directory.