forked from go-gitea/gitea
-
Notifications
You must be signed in to change notification settings - Fork 0
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Merge remote-tracking branch 'giteaofficial/main'
* giteaofficial/main: Add health check endpoint (go-gitea#18465) Only check for non-finished migrating task (go-gitea#19601) Make .cs highlighting legible on dark themes. (go-gitea#19604)
- Loading branch information
Showing
10 changed files
with
273 additions
and
25 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,143 @@ | ||
| // Copyright 2022 The Gitea Authors. All rights reserved. | ||
| // Use of this source code is governed by a MIT-style | ||
| // license that can be found in the LICENSE file. | ||
|
|
||
| package healthcheck | ||
|
|
||
| import ( | ||
| "net/http" | ||
| "os" | ||
| "time" | ||
|
|
||
| "code.gitea.io/gitea/models/db" | ||
| "code.gitea.io/gitea/modules/cache" | ||
| "code.gitea.io/gitea/modules/json" | ||
| "code.gitea.io/gitea/modules/log" | ||
| "code.gitea.io/gitea/modules/setting" | ||
| ) | ||
|
|
||
| type status string | ||
|
|
||
| const ( | ||
| // pass healthy (acceptable aliases: "ok" to support Node's Terminus and "up" for Java's SpringBoot) | ||
| // fail unhealthy (acceptable aliases: "error" to support Node's Terminus and "down" for Java's SpringBoot), and | ||
| // warn healthy, with some concerns. | ||
| // | ||
| // ref https://datatracker.ietf.org/doc/html/draft-inadarei-api-health-check#section-3.1 | ||
| // status: (required) indicates whether the service status is acceptable | ||
| // or not. API publishers SHOULD use following values for the field: | ||
| // The value of the status field is case-insensitive and is tightly | ||
| // related with the HTTP response code returned by the health endpoint. | ||
| // For "pass" status, HTTP response code in the 2xx-3xx range MUST be | ||
| // used. For "fail" status, HTTP response code in the 4xx-5xx range | ||
| // MUST be used. In case of the "warn" status, endpoints MUST return | ||
| // HTTP status in the 2xx-3xx range, and additional information SHOULD | ||
| // be provided, utilizing optional fields of the response. | ||
| pass status = "pass" | ||
| fail status = "fail" | ||
| warn status = "warn" | ||
| ) | ||
|
|
||
| func (s status) ToHTTPStatus() int { | ||
| if s == pass || s == warn { | ||
| return http.StatusOK | ||
| } | ||
| return http.StatusFailedDependency | ||
| } | ||
|
|
||
| type checks map[string][]componentStatus | ||
|
|
||
| // response is the data returned by the health endpoint, which will be marshaled to JSON format | ||
| type response struct { | ||
| Status status `json:"status"` | ||
| Description string `json:"description"` // a human-friendly description of the service | ||
| Checks checks `json:"checks,omitempty"` // The Checks Object, should be omitted on installation route | ||
| } | ||
|
|
||
| // componentStatus presents one status of a single check object | ||
| // an object that provides detailed health statuses of additional downstream systems and endpoints | ||
| // which can affect the overall health of the main API. | ||
| type componentStatus struct { | ||
| Status status `json:"status"` | ||
| Time string `json:"time"` // the date-time, in ISO8601 format | ||
| Output string `json:"output,omitempty"` // this field SHOULD be omitted for "pass" state. | ||
| } | ||
|
|
||
| // Check is the health check API handler | ||
| func Check(w http.ResponseWriter, r *http.Request) { | ||
| rsp := response{ | ||
| Status: pass, | ||
| Description: setting.AppName, | ||
| Checks: make(checks), | ||
| } | ||
|
|
||
| statuses := make([]status, 0) | ||
| if setting.InstallLock { | ||
| statuses = append(statuses, checkDatabase(rsp.Checks)) | ||
| statuses = append(statuses, checkCache(rsp.Checks)) | ||
| } | ||
| for _, s := range statuses { | ||
| if s != pass { | ||
| rsp.Status = fail | ||
| break | ||
| } | ||
| } | ||
|
|
||
| data, _ := json.MarshalIndent(rsp, "", " ") | ||
| w.Header().Set("Content-Type", "application/json") | ||
| w.WriteHeader(rsp.Status.ToHTTPStatus()) | ||
| _, _ = w.Write(data) | ||
| } | ||
|
|
||
| // database checks gitea database status | ||
| func checkDatabase(checks checks) status { | ||
| st := componentStatus{} | ||
| if err := db.GetEngine(db.DefaultContext).Ping(); err != nil { | ||
| st.Status = fail | ||
| st.Time = getCheckTime() | ||
| log.Error("database ping failed with error: %v", err) | ||
| } else { | ||
| st.Status = pass | ||
| st.Time = getCheckTime() | ||
| } | ||
|
|
||
| if setting.Database.UseSQLite3 && st.Status == pass { | ||
| if !setting.EnableSQLite3 { | ||
| st.Status = fail | ||
| st.Time = getCheckTime() | ||
| log.Error("SQLite3 health check failed with error: %v", "this Gitea binary is built without SQLite3 enabled") | ||
| } else { | ||
| if _, err := os.Stat(setting.Database.Path); err != nil { | ||
| st.Status = fail | ||
| st.Time = getCheckTime() | ||
| log.Error("SQLite3 file exists check failed with error: %v", err) | ||
| } | ||
| } | ||
| } | ||
|
|
||
| checks["database:ping"] = []componentStatus{st} | ||
| return st.Status | ||
| } | ||
|
|
||
| // cache checks gitea cache status | ||
| func checkCache(checks checks) status { | ||
| if !setting.CacheService.Enabled { | ||
| return pass | ||
| } | ||
|
|
||
| st := componentStatus{} | ||
| if err := cache.Ping(); err != nil { | ||
| st.Status = fail | ||
| st.Time = getCheckTime() | ||
| log.Error("cache ping failed with error: %v", err) | ||
| } else { | ||
| st.Status = pass | ||
| st.Time = getCheckTime() | ||
| } | ||
| checks["cache:ping"] = []componentStatus{st} | ||
| return st.Status | ||
| } | ||
|
|
||
| func getCheckTime() string { | ||
| return time.Now().UTC().Format(time.RFC3339) | ||
| } |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters