跳转至

通用 API

启动 Common API。

概述#

通用 API 内嵌到了启动器里,不需要额外的实现。

路径 描述
/rk/v1/alive 主要用于 K8S liveness。
/rk/v1/ready 主要用于 K8S readiness。
/rk/v1/info 返回 Application 信息。
/rk/v1/gc 触发 GC。

安装#

go get github.com/rookie-ninja/rk-boot/v2
go get github.com/rookie-ninja/rk-mux

通用 API 选项#

名字 描述 类型 默认值
mux.commonService.enabled 启动 Common API boolean false
mux.commonService.pathPrefix Common API 路径前缀 string /rk/v1

快速开始#

1.创建 boot.yaml#

---
mux:
  - name: greeter
    port: 8080
    enabled: true
    commonService:
      enabled: true
#      pathPrefix: ""

2.创建 main.go#

package main

import (
  "context"
  "github.com/rookie-ninja/rk-boot/v2"
  _ "github.com/rookie-ninja/rk-mux/boot"
)

// Application entrance.
func main() {
  // Create a new boot instance.
  boot := rkboot.NewBoot()

  // Bootstrap
  boot.Bootstrap(context.Background())

  // Wait for shutdown sig
  boot.WaitForShutdownSig(context.Background())
}

3.验证#

$ curl localhost:8080/rk/v1/ready
{
  "ready": true
}

Cheers#

4.启动 swagger UI#

---
mux:
  - name: greeter
    port: 8080
    enabled: true
    commonService:
      enabled: true
    sw:
      enabled: true

验证

http://localhost:8080/sw

sw-common

Cheers#