4.0 KiB
4.0 KiB
中文 | English
请加入我们，共同完善这个项目。
对于初学者
在开始之前，您可能需要了解以下技术:
| Name | Domain |
|---|---|
| HTTP Protocol | Core |
| RESTful | Core |
| gRPC | gRPC runner extension |
| Prometheus | Application monitor |
| Cobra | The Go CLI framework |
| Element Plus | The front-end framework |
| Docker | The container image build |
| Helm chart | The Kubernetes application package |
| GitHub Actions | The continuous integration |
| make | The automated Build Tools |
| Docs Guide | 文档编写指南 |
设置开发环境
本项目使用
make作为构建工具，并设计了非常强大的 make 指令系统。您可以通过运行make help查看所有可用的命令。
强烈建议您配置 git pre-commit 钩子。它会强制在提交前运行单元测试。
运行以下命令：
make install-precheck
打印各行代码：
git ls-files | xargs cloc
pprof
go tool pprof -http=:9999 http://localhost:8080/debug/pprof/heap
其他用法：
/debug/pprof/heap?gc=1/debug/pprof/heap?seconds=10/debug/pprof/goroutine/?debug=0
SkyWalking
docker run -p 12800:12800 -p 9412:9412 docker.io/apache/skywalking-oap-server:9.0.0
docker run -p 8080:8080 -e SW_OAP_ADDRESS=http://172.11.0.6:12800 -e SW_ZIPKIN_ADDRESS=http://172.11.0.6:9412 docker.io/apache/skywalking-ui:9.0.0
make build
export SW_AGENT_NAME=atest
export SW_AGENT_REPORTER_GRPC_BACKEND_SERVICE=172.11.0.6:30689
export SW_AGENT_PLUGIN_CONFIG_HTTP_SERVER_COLLECT_PARAMETERS=true
export SW_AGENT_METER_COLLECT_INTERVAL=3
export SW_AGENT_LOG_TYPE=std
export SW_AGENT_REPORTER_DISCARD=true
./bin/atest server --local-storage 'bin/*.yaml' --http-port 8082 --port 7072 --console-path console/atest-ui/dist/
通过 BanYanDB 运行 SkyWalking：
docker run -p 17912:17912 -p 17913:17913 apache/skywalking-banyandb:latest standalone
docker run -p 12800:12800 -p 9412:9412 \
-e SW_STORAGE=banyandb \
-e SW_STORAGE_BANYANDB_HOST=192.168.1.98 \
docker.io/apache/skywalking-oap-server
第一次贡献
对于第一次对此项目贡献代码的开发者，您应该在本地开发环境运行如下命令：
make test
以确保通过项目测试，这会有助于您检查并解决在提交时遇到的错误，同时减少 review 的复杂度。
FAQ
- Got sum missing match error of go.
- 运行命令：
go clean -modcache && go mod tidy.
- 运行命令：