常用的 Git 配置，你知道幾個(gè)？
作者：crossoverJie
OTel 是可觀測(cè)系統(tǒng)的新標(biāo)準(zhǔn)，基于它可以兼容以前使用的 Prometheus、 victoriametrics、skywalking 等系統(tǒng)，同時(shí)還可以靈活擴(kuò)展，不用與任何但一生態(tài)或技術(shù)棧進(jìn)行綁定。
- 使用NewServer函數(shù)構(gòu)建服務(wù)實(shí)例,利用依賴注入方式將所有的依賴參數(shù)包含進(jìn)來(lái)。
func NewServer(
logger *Logger
config *Config
commentStore *commentStore
anotherStore *anotherStore
) http.Handler {
mux := http.NewServeMux()
addRoutes(
mux,
Logger,
Config,
commentStore,
anotherStore,
)
var handler http.Handler = mux
handler = someMiddleware(handler)
handler = someMiddleware2(handler)
handler = someMiddleware3(handler)
return handler
}- 在routes.go文件中統(tǒng)一定義所有路由函數(shù)。
func addRoutes(
mux *http.ServeMux,
logger *logging.Logger,
config Config,
tenantsStore *TenantsStore,
commentsStore *CommentsStore,
conversationService *ConversationService,
chatGPTService *ChatGPTService,
authProxy *authProxy
) {
mux.Handle("/api/v1/", handleTenantsGet(logger, tenantsStore))
mux.Handle("/oauth2/", handleOAuth2Proxy(logger, authProxy))
mux.HandleFunc("/healthz", handleHealthzPlease(logger))
mux.Handle("/", http.NotFoundHandler())
}- 主函數(shù)只調(diào)用run函數(shù)來(lái)運(yùn)行服務(wù)
func run(ctx context.Context, w io.Writer, args []string) error {
ctx, cancel := signal.NotifyContext(ctx, os.Interrupt)
defer cancel()
// ...
}
func main() {
ctx := context.Background()
if err := run(ctx, os.Stdout, os.Args); err != nil {
fmt.Fprintf(os.Stderr, "%s\n", err)
os.Exit(1)
}
}- 返回閉包 handle
// handleSomething handles one of those web requests
// that you hear so much about.
func handleSomething(logger *Logger) http.Handler {
thing := prepareThing()
return http.HandlerFunc(
func(w http.ResponseWriter, r *http.Request) {
// use thing to handle request
logger.Info(r.Context(), "msg", "handleSomething")
}
)
}- 定義通用的encode和decode函數(shù)
func encode[T any](w http.ResponseWriter, r *http.Request, status int, v T) error {
w.Header().Set("Content-Type", "application/json")
w.WriteHeader(status)
if err := json.NewEncoder(w).Encode(v); err != nil {
return fmt.Errorf("encode json: %w", err)
}
return nil
}
func decode[T any](r *http.Request) (T, error) {
var v T
if err := json.NewDecoder(r.Body).Decode(&v); err != nil {
return v, fmt.Errorf("decode json: %w", err)
}
return v, nil
}- 提供一個(gè)抽象的 Validator 接口用于驗(yàn)證
// Validator is an object that can be validated.
type Validator interface {
// Valid checks the object and returns any
// problems. If len(problems) == 0 then
// the object is valid.
Valid(ctx context.Context) (problems map[string]string)
}
func decodeValid[T Validator](r *http.Request) (T, map[string]string, error) {
var v T
if err := json.NewDecoder(r.Body).Decode(&v); err != nil {
return v, nil, fmt.Errorf("decode json: %w", err)
}
if problems := v.Valid(r.Context()); len(problems) > 0 {
return v, problems, fmt.Errorf("invalid %T: %d problems", v, len(problems))
}
return v, nil, nil
}自定義校驗(yàn)需要實(shí)現(xiàn) Validator 接口。
7.使用 Once 延遲調(diào)用來(lái)提高啟動(dòng)性能。
func handleTemplate(files string...) http.HandlerFunc {
var (
init sync.Once
tpl *template.Template
tplerr error
)
return func(w http.ResponseWriter, r *http.Request) {
init.Do(func(){
tpl, tplerr = template.ParseFiles(files...)
})
if tplerr != nil {
http.Error(w, tplerr.Error(), http.StatusInternalServerError)
return
}
// use tpl
}
}What is OpenTelemetry?
這是一篇 OTel 的科普文章
OpenTelemetry 提供一個(gè)統(tǒng)一、可擴(kuò)展的框架，用于收集、分析和觀察分布式系統(tǒng)的性能數(shù)據(jù)。它包括一組API、庫(kù)、代理和收集器，這些組件可以跨多種編程語(yǔ)言和平臺(tái)實(shí)現(xiàn)對(duì)應(yīng)用程序的監(jiān)控。
OpenTelemetry 整合 OpenTracing 和 OpenCensus。
2019年，兩個(gè)社區(qū)進(jìn)行了合并。
同時(shí) OTel 具備以下特征：
- 統(tǒng)一性：OpenTelemetry 提供了一個(gè)統(tǒng)一的API，使得開(kāi)發(fā)者可以在不同的編程語(yǔ)言和框架中以一致的方式實(shí)現(xiàn)監(jiān)控。
- 可擴(kuò)展性：可以編寫(xiě)自己的擴(kuò)展來(lái)滿足個(gè)性化需要
- 跨平臺(tái)：OpenTelemetry 支持多種編程語(yǔ)言，如 Java、Python、Go、.NET 等，以及多種云服務(wù)和容器平臺(tái)。
- 社區(qū)驅(qū)動(dòng)：作為一個(gè)開(kāi)源項(xiàng)目，OpenTelemetry 由一個(gè)活躍的社區(qū)支持，社區(qū)成員貢獻(xiàn)代碼、文檔和最佳實(shí)踐。
- 與現(xiàn)有工具的兼容性：OpenTelemetry 設(shè)計(jì)時(shí)考慮了與現(xiàn)有監(jiān)控工具的兼容性，如 Prometheus、Jaeger、Zipkin 等，這使得它可以輕松地集成到現(xiàn)有的監(jiān)控基礎(chǔ)設(shè)施中。
提供了一種名為：OTLP（OpenTelemetry Protocol）的通訊協(xié)議，基于 gRPC。
使用該協(xié)議用于客戶端與 Collector 采集器進(jìn)行交互。
Collector 是 OpenTelemetry 架構(gòu)中的一個(gè)關(guān)鍵組件，它負(fù)責(zé)接收、處理和導(dǎo)出數(shù)據(jù)(Trace/log/metrics)。
它可以接受從客戶端發(fā)出的數(shù)據(jù)進(jìn)行處理，同時(shí)可以導(dǎo)出為不同格式的數(shù)據(jù)。
總的來(lái)說(shuō) OTel 是可觀測(cè)系統(tǒng)的新標(biāo)準(zhǔn)，基于它可以兼容以前使用的 Prometheus、 victoriametrics、skywalking 等系統(tǒng)，同時(shí)還可以靈活擴(kuò)展，不用與任何但一生態(tài)或技術(shù)棧進(jìn)行綁定。
Popular git config options
本文總結(jié)了一些常用的 git 配置
- pull.ff only 或 pull.rebase true：這兩個(gè)選項(xiàng)都可以避免在執(zhí)行g(shù)it pull時(shí)意外創(chuàng)建合并提交，特別是當(dāng)上游分支已經(jīng)發(fā)生了變化的時(shí)候。
- merge.conflictstyle diff3：這個(gè)選項(xiàng)使得合并沖突更易于閱讀，通過(guò)在沖突中顯示原始代碼版本，幫助用戶更好地解決沖突。
- rebase.autosquash true 和 rebase.autostash true：這些選項(xiàng)使得修改舊提交變得更容易，并且自動(dòng)處理stash。
- push.default simple 或 push.default current：這些選項(xiàng)告訴git push自動(dòng)推送當(dāng)前分支到同名的遠(yuǎn)程分支。
- init.defaultBranch main：創(chuàng)建新倉(cāng)庫(kù)時(shí)，默認(rèn)創(chuàng)建main分支而不是master分支。
- commit.verbose true：在提交時(shí)顯示整個(gè)提交差異。
- rerere.enabled true：?jiǎn)⒂胷erere功能，自動(dòng)解決沖突
- help.autocorrect：設(shè)置自動(dòng)矯正的級(jí)別，以自動(dòng)運(yùn)行建議的命令。
- core.pager delta：設(shè)置Git使用的分頁(yè)器，例如使用delta來(lái)查看帶有語(yǔ)法高亮的diff。
- diff.algorithm histogram：設(shè)置Git的diff算法，以改善函數(shù)重排時(shí)的diff顯示。
文章鏈接：
責(zé)任編輯：武曉燕
來(lái)源：
crossoverJie
