import (\n "context"\n "github.com\/sirupsen\/logrus"\n "github.company.com\/org\/repo\/gapi"\n "time"\n gdocs "google.golang.org\/api\/docs\/v1"\n)<\/code><\/pre>\n\u2705 \u63a8\u8350\u5199\u6cd5\uff1a<\/p>\n
import (\n "context"\n "time"\n\n "github.com\/sirupsen\/logrus"\n gdocs "google.golang.org\/api\/docs\/v1"\n\n "github.company.com\/org\/repo\/gapi"\n "github.company.com\/org\/repo\/snow"\n "github.company.com\/org\/repo\/internal\/clients\/slack"\n)<\/code><\/pre>\n\u5355\u4e2a\u6587\u4ef6\u5185\u7684\u4ee3\u7801\u5e03\u5c40<\/h3>\n
\u4e00\u4e2a \u3002go \u6587\u4ef6\u5efa\u8bae\u6309\u4ee5\u4e0b\u987a\u5e8f\u7ec4\u7ec7\uff08\u517b\u6210\u4e60\u60ef\u540e\u9605\u8bfb\u548c review \u6548\u7387\u4f1a\u660e\u663e\u63d0\u5347\uff09\uff1a<\/p>\n
\n- const \/ var \u5b9a\u4e49<\/li>\n
- struct \/ interface \u5b9a\u4e49<\/li>\n
- \u5bfc\u51fa\u7684\uff08\u5927\u5199\uff09\u65b9\u6cd5<\/li>\n
- \u975e\u5bfc\u51fa\u7684\uff08\u5c0f\u5199\uff09\u65b9\u6cd5<\/li>\n
- \u8f85\u52a9\u51fd\u6570<\/li>\n<\/ol>\n
4. \u547d\u540d\uff1a\u7b80\u5355\u3001\u4e0d\u5197\u4f59<\/h2>\n
\u5305\u540d\u5df2\u7ecf\u63d0\u4f9b\u4e86\u4e0a\u4e0b\u6587\uff0c\u5c31\u4e0d\u8981\u5728\u7c7b\u578b\u540d\u91cc\u91cd\u590d\u3002<\/p>\n
\u274c \u5197\u4f59\u5199\u6cd5\uff1a<\/p>\n
type DeploymentTransformerHandlerIntf interface{}\ntype DeploymentTransformerHandler struct{}<\/code><\/pre>\n\u2705 \u7b80\u6d01\u5199\u6cd5\uff1a<\/p>\n
type DeploymentTransformerIntf interface{}\ntype DeploymentTransformer struct{}<\/code><\/pre>\n\u201cHandler\u201d\u5728\u8fd9\u91cc\u5c31\u662f\u7eaf\u566a\u97f3\uff0c\u5f92\u589e\u9605\u8bfb\u8d1f\u62c5\u3002<\/p>\n
5. Context\uff1a\u4f20\u53c2\uff0c\u4e0d\u8981\u585e\u7ed3\u6784\u4f53<\/h2>\n
\u6c38\u8fdc\u628a context.Context \u4f5c\u4e3a\u51fd\u6570\u7684\u7b2c\u4e00\u4e2a\u53c2\u6570\u4f20\u5165<\/strong>\uff0c\u800c\u4e0d\u662f\u585e\u5230 struct \u5b57\u6bb5\u91cc\u3002\u8fd9\u6837\u624d\u80fd\u6b63\u786e\u4f20\u64ad\u53d6\u6d88\u4fe1\u53f7\u548c\u8d85\u65f6\u3002<\/p>\n\u274c \u9519\u8bef\u505a\u6cd5\uff1a<\/p>\n
type Client struct {\n ctx context.Context\n}\n\nfunc (c *Client) DoSomething(foo string) {\n \/\/ \u7528 c.ctx \u2014\u2014 \u5343\u4e07\u522b\u8fd9\u6837\uff01\n}<\/code><\/pre>\n\u2705 \u6b63\u786e\u505a\u6cd5\uff1a<\/p>\n
func (c *Client) DoSomething(ctx context.Context, foo string) {\n \/\/ \u7528 ctx\n}<\/code><\/pre>\n\u94c1\u5f8b<\/strong>\uff1a\u53ea\u8981\u65b9\u6cd5\u9700\u8981 context\uff0c\u4e00\u5f8b\u653e\u5728\u7b2c\u4e00\u4e2a\u53c2\u6570\u3002<\/p>\n6. \u65b9\u6cd5\u7b7e\u540d\uff1a\u62e5\u62b1\u51fd\u6570\u9009\u9879\u6a21\u5f0f\uff08Functional Options\uff09<\/h2>\n
\u53c2\u6570\u4e00\u591a\u5c31\u707e\u96be\u3002\u63a8\u8350\u4f7f\u7528\u51fd\u6570\u9009\u9879\u6a21\u5f0f\uff0c\u65e2\u53ef\u8bfb\u53c8\u7075\u6d3b\u3002<\/p>\n
\u274c \u707e\u96be\u7b7e\u540d\uff1a<\/p>\n
svr := server.New("localhost", 8080, time.Minute, 120)<\/code><\/pre>\n\u8c01\u77e5\u9053 time.Minute \u548c 120 \u5206\u522b\u662f\u4ec0\u4e48\uff1f<\/p>\n
\u2705 \u81ea\u89e3\u91ca\u5199\u6cd5\uff1a<\/p>\n
svr := server.New(\n server.WithHost("localhost"),\n server.WithPort(8080),\n server.WithTimeout(time.Minute),\n server.WithMaxConn(120),\n)<\/code><\/pre>\n\u540e\u7eed\u52a0\u53c2\u6570\u4e5f\u4e0d\u7834\u574f\u5df2\u6709\u8c03\u7528\uff0c\u6269\u5c55\u6027\u6781\u5f3a\u3002<\/p>\n
7. \u9519\u8bef\u5904\u7406\uff1a\u4e0a\u4e0b\u6587\u624d\u662f\u738b\u9053<\/h2>\n\u7528\u5806\u6808 + \u9519\u8bef\u5305\u88c5<\/h3>\n
\u63a8\u8350\u4f7f\u7528 github.com\/pingcap\/errors<\/code>\u3001go.uber.org\/multierr<\/code> \u6216\u7c7b\u4f3c\u5e93\uff08\u6216\u81ea\u5df1\u5c01\u88c5 yerrors\uff09\uff0c\u7ed9\u9519\u8bef\u81ea\u52a8\u5e26\u4e0a\u8c03\u7528\u6808\u3002<\/p>\n\u4e3a\u4ec0\u4e48\uff1f<\/strong> \u624b\u52a8\u5728\u5b57\u7b26\u4e32\u91cc\u5199\u201c\u5728 xxx \u65b9\u6cd5\u91cc\u51fa\u9519\u201d\u7ef4\u62a4\u6210\u672c\u6781\u9ad8\u4e14\u5bb9\u6613\u6f0f\uff0c\u5806\u6808\u4e00\u6b21\u89e3\u51b3\u3002<\/p>\n\u5b89\u5168\u7ea2\u7ebf<\/strong>\uff1a\u5806\u6808\u4fe1\u606f\u53ea\u5199\u65e5\u5fd7\uff0c\u7edd\u4e0d<\/strong>\u8fd4\u56de\u7ed9 API \u8c03\u7528\u65b9\uff08\u6cc4\u9732\u5b9e\u73b0\u7ec6\u8282\u662f\u5b89\u5168\u6f0f\u6d1e\uff09\u3002<\/p>\n\u65e5\u5fd7\u7ea7\u522b\u8981\u5206\u6e05<\/h3>\n\n- Error<\/strong> \u7ea7\u522b\uff1a\u53ea\u7528\u4e8e\u771f\u6b63\u7684\u670d\u52a1\u5185\u90e8\u9519\u8bef\uff08500 \u573a\u666f\uff09<\/li>\n
- Warn<\/strong> \u7ea7\u522b\uff1a\u7528\u6237\/\u5ba2\u6237\u7aef\u7684\u9519\u8bef\uff08400 \u573a\u666f\uff09<\/li>\n<\/ul>\n
\u9519\u8bef\u53ea\u5728\u9876\u5c42 log \u4e00\u6b21<\/h3>\n
\u5c42\u5c42 log \u540c\u4e00\u4e2a\u9519\u8bef\u662f\u53cd\u6a21\u5f0f\u3002<\/p>\n
\u274c \u5c42\u5c42\u91cd\u590d log\uff1a<\/p>\n
if err != nil {\n log.Errorf("ERROR :: Google Docs :: NewGoogleApiHandler :: Unable to create service :: %v", err)\n return nil, err\n}<\/code><\/pre>\n\u2705 \u4f18\u96c5\u5305\u88c5\u5411\u4e0a\u900f\u4f20\uff1a<\/p>\n
if err != nil {\n return nil, fmt.Errorf("failed to create google docs service: %w", err)\n \/\/ \u6216\u7528 errors.Wrap \/ yerrors.Errorf\n}<\/code><\/pre>\n\u9876\u5c42\u7edf\u4e00 log + \u5e26\u6808\uff0c\u5e72\u51c0\u53c8\u597d debug\u3002<\/p>\n
8. \u65e5\u5fd7\uff1a\u7ed3\u6784\u5316 > \u5b57\u7b26\u4e32\u62fc\u63a5<\/h2>\n
\u63a8\u8350\u7528 zap<\/strong> \u6216 logrus<\/strong>\uff08\u751f\u4ea7\u73af\u5883\u5f00 JSON \u683c\u5f0f\uff09\u3002<\/p>\n\u7ed3\u6784\u5316\u65e5\u5fd7\u793a\u4f8b<\/h3>\n
\u274c \u5b57\u7b26\u4e32\u62fc\u63a5\uff1a<\/p>\n
log.Errorf("Failed to write summary. Error: %s", err)<\/code><\/pre>\n\u2705 \u7ed3\u6784\u5316\uff1a<\/p>\n
log.WithFields(log.Fields{\n "event": event,\n "topic": topic,\n "key": key,\n}).Info("processing new event")<\/code><\/pre>\n\u7ed3\u6784\u5316\u65e5\u5fd7\u5728 ELK \/ Loki \/ \u963f\u91cc\u4e91 SLS \u7b49\u5e73\u53f0\u4e0a\u641c\u7d22\u3001\u544a\u8b66\u6548\u7387\u9ad8\u51fa\u51e0\u4e2a\u91cf\u7ea7\u3002<\/p>\n
\u53ef\u5ffd\u7565\u7684\u5df2\u77e5\u9519\u8bef\u6253 Debug<\/h3>\nif err != nil {\n if errors.Is(err, ErrUserAlreadyExists) { \/\/ \u6216 err.Error() == "user_exists"\n log.WithError(err).Debug("user exists, continuing")\n return nil \/\/ \u6216 continue\n }\n return nil, fmt.Errorf("failed to add user %s: %w", userID, err)\n}<\/code><\/pre>\n\u8bf7\u6c42\u7ea7\u65e5\u5fd7\uff08\u5e26 trace id\uff09<\/h3>\n
\u7528\u51fd\u6570\u5f0f Logger \u6ce8\u5165\uff1a<\/p>\n
type Handler struct {\n LoggerFn func(ctx context.Context) *logrus.Entry\n}\n\nfunc (h *Handler) CheckHealth(ctx context.Context) {\n logger := h.LoggerFn(ctx)\n logger.Info("health check started")\n}<\/code><\/pre>\n\u4e2d\u95f4\u4ef6\u53ef\u4ee5\u628a request-id \/ trace-id \u585e\u8fdb context\uff0c\u81ea\u52a8\u5e26\u5230\u6240\u6709\u65e5\u5fd7\u91cc\uff0c\u5b9e\u73b0\u5168\u94fe\u8def\u8ffd\u8e2a\u3002<\/p>\n
9. HTTP \u8c03\u7528\uff1a\u4f18\u5148\u7528 Context \u8d85\u65f6<\/h2>\n
\u4e0d\u8981\u4f9d\u8d56 http.Client \u7684\u5168\u5c40 Timeout\uff0c\u7528 context \u63a7\u5236\u66f4\u7cbe\u7ec6\u3002<\/p>\n
ctx, cancel := context.WithTimeout(context.Background(), 30*time.Second)\ndefer cancel()\n\nreq, _ := http.NewRequestWithContext(ctx, http.MethodGet, url, nil)\nresp, err := client.Do(req)<\/code><\/pre>\n\u8fd9\u6837\u80fd\u66f4\u597d\u5730\u914d\u5408\u4e0a\u5c42\u8d85\u65f6\u548c\u53d6\u6d88\u4f20\u64ad\u3002<\/p>\n