feat(web_server_bin_cmd): add Web Service Binary Command Execution gRPC Server

BREAKING CHANGE: the `bifrost` gRPC server APIs have added `WebServerBinCMD`.`Exec` server

The `protobuf` of the `bifrost` gRPC server APIs has been added as follows:

Protocols of addition:

```protobuf
service WebServerBinCMD {
  rpc Exec(ExecuteRequest) returns (ExecuteResponse) {}
}

message ExecuteRequest {
  string ServerName = 1;
  repeated string Args = 2;
}

message ExecuteResponse {
  bool Successful = 1;
  bytes Stdout = 2;
  bytes Stderr = 3;
}
```

The `bifrost` gRPC server APIs client SDK has been added as follows:

Methods of addition to Client Service Factory:

```go
type Factory interface {
    ...
    WebServerBinCMD() WebServerBinCMDService
}
```

Interface of addition to Client Service:

```go
type WebServerBinCMDService interface {
    Exec(servername string, arg ...string) (isSuccessful bool, stdout, stderr string, err error)
}
```

Author: ClessLi

api/bifrost/v1/web_server_bin_cmd.go

@@ -0,0 +1,11 @@
+package v1
+
+type ExecuteRequest struct {
+	ServerName string   `json:"server_name"`
+	Args       []string `json:"args"`
+}
+type ExecuteResponse struct {
+	Successful     bool   `json:"successful"`
+	StandardOutput []byte `json:"stdout"`
+	StandardError  []byte `json:"stderr"`
+}

api/protobuf-spec/bifrostpb/v1/bifrost.pb.go

@@ -21,6 +21,10 @@ service WebServerLogWatcher {
   rpc Watch(LogWatchRequest) returns (stream Response) {}
 }
 
+service WebServerBinCMD {
+  rpc Exec(ExecuteRequest) returns (ExecuteResponse) {}
+}
+
 message Null {}
 
 message ServerNames {
@@ -52,4 +56,15 @@ message LogWatchRequest {
   string ServerName = 1;
   string LogName = 2;
   string FilterRule =3;
+}
+
+message ExecuteRequest {
+  string ServerName = 1;
+  repeated string Args = 2;
+}
+
+message ExecuteResponse {
+  bool Successful = 1;
+  bytes Stdout = 2;
+  bytes Stderr = 3;
 }

api/protobuf-spec/bifrostpb/v1/bifrost.proto

@@ -7,6 +7,8 @@
 | web_server_status      | bifrost 中 WebServerStatus 模块相关的变更     |
 | web_server_statistics  | bifrost 中 WebServerStatistics 模块相关的变更 |
 | web_server_log_watcher | bifrost 中 WebServerLogWatcher 模块相关的变更 |
+| web_server_bin_cmd     | bifrost 中 WebServerBinCMD 模块相关的变更     |
+| resolv                 | bifrost 中 web服务配置解析库相关的变更             |
 | client                 | 组件gRPC客户端相关的变更                        |
 | pkg                    | pkg 包的变更                              |
 | docs                   | 文档类变更                                 |

docs/devel/zh-CN/scope.md

@@ -46,18 +46,20 @@ Bifrost 系统支持的错误码列表如下：
 | ErrSameConfigFingerprints      | 110003 | 500       | Same config fingerprint between files and configuration          |
 | ErrConfigManagerIsRunning      | 110004 | 500       | Config manager is running                                        |
 | ErrConfigManagerIsNotRunning   | 110005 | 500       | Config manager is not running                                    |
-| ErrConfigurationNotFound       | 110006 | 400       | Web server configuration not found                               |
-| ErrParserNotFound              | 110007 | 500       | Parser not found                                                 |
-| ErrUnknownKeywordString        | 110008 | 500       | Unknown keyword string                                           |
-| ErrInvalidConfig               | 110009 | 500       | Invalid parser.Config                                            |
-| ErrParseFailed                 | 110010 | 500       | Config parse failed                                              |
-| ErrV3ContextIndexOutOfRange    | 110011 | 500       | Index of the Context's children is out of range                  |
-| ErrV3NullContextPosition       | 110012 | 500       | Null Context position                                            |
-| ErrV3SetFatherContextFailed    | 110013 | 500       | Set father Context failed                                        |
-| ErrV3OperationOnErrorContext   | 110014 | 500       | Performing operations on Error Context                           |
-| ErrV3InvalidContext            | 110015 | 500       | Invalid Context                                                  |
-| ErrV3InvalidOperation          | 110016 | 500       | Invalid operation                                                |
-| ErrV3ContextNotFound           | 110017 | 500       | Queried context not found                                        |
+| ErrWebServerNotFound           | 110006 | 400       | Web server not found                                             |
+| ErrConfigurationNotFound       | 110007 | 400       | Web server configuration not found                               |
+| ErrParserNotFound              | 110008 | 500       | Parser not found                                                 |
+| ErrUnknownKeywordString        | 110009 | 500       | Unknown keyword string                                           |
+| ErrInvalidConfig               | 110010 | 500       | Invalid parser.Config                                            |
+| ErrParseFailed                 | 110011 | 500       | Config parse failed                                              |
+| ErrV3ContextIndexOutOfRange    | 110012 | 500       | Index of the Context's children is out of range                  |
+| ErrV3NullContextPosition       | 110013 | 500       | Null Context position                                            |
+| ErrV3SetFatherContextFailed    | 110014 | 500       | Set father Context failed                                        |
+| ErrV3OperationOnErrorContext   | 110015 | 500       | Performing operations on Error Context                           |
+| ErrV3InvalidContext            | 110016 | 500       | Invalid Context                                                  |
+| ErrV3InvalidOperation          | 110017 | 500       | Invalid operation                                                |
+| ErrV3ContextNotFound           | 110018 | 500       | Queried context not found                                        |
+| ErrV3ConversionToContextFailed | 110019 | 500       | Conversion to context failed                                     |
 | ErrStopMonitoringTimeout       | 110201 | 500       | Stop monitoring timeout                                          |
 | ErrMonitoringServiceSuspension | 110202 | 500       | Monitoring service suspension                                    |
 | ErrMonitoringStarted           | 110203 | 500       | Monitoring is already started                                    |

docs/guide/zh-CN/api/error_code_generated.md

@@ -1,6 +1,7 @@
 package v1
 
 import (
+	"github.com/ClessLi/bifrost/internal/bifrost/endpoint/v1/web_server_bin_cmd"
 	"github.com/ClessLi/bifrost/internal/bifrost/endpoint/v1/web_server_config"
 	"github.com/ClessLi/bifrost/internal/bifrost/endpoint/v1/web_server_log_watcher"
 	"github.com/ClessLi/bifrost/internal/bifrost/endpoint/v1/web_server_statistics"
@@ -13,6 +14,7 @@ type EndpointsFactory interface {
 	WebServerStatistics() WebServerStatisticsEndpoints
 	WebServerStatus() WebServerStatusEndpoints
 	WebServerLogWatcher() WebServerLogWatcherEndpoints
+	WebServerBinCMD() WebServerBinCMDEndpoints
 }
 
 var _ EndpointsFactory = &endpoints{}
@@ -40,3 +42,7 @@ func (e *endpoints) WebServerStatus() WebServerStatusEndpoints {
 func (e *endpoints) WebServerLogWatcher() WebServerLogWatcherEndpoints {
 	return web_server_log_watcher.NewWebServerLogWatcherEndpoints(e.svc)
 }
+
+func (e *endpoints) WebServerBinCMD() WebServerBinCMDEndpoints {
+	return web_server_bin_cmd.NewWebServerBinCMDEndpoints(e.svc)
+}

internal/bifrost/endpoint/v1/endpoints.go

@@ -0,0 +1,7 @@
+package v1
+
+import "github.com/go-kit/kit/endpoint"
+
+type WebServerBinCMDEndpoints interface {
+	EndpointExec() endpoint.Endpoint
+}

internal/bifrost/endpoint/v1/web_server_bin_cmd.go

@@ -0,0 +1,19 @@
+package web_server_bin_cmd
+
+import (
+	"context"
+	v1 "github.com/ClessLi/bifrost/api/bifrost/v1"
+
+	"github.com/go-kit/kit/endpoint"
+	"github.com/marmotedu/errors"
+)
+
+func (w *webServerBinCMDEndpoints) EndpointExec() endpoint.Endpoint {
+	return func(ctx context.Context, request interface{}) (response interface{}, err error) {
+		if req, ok := request.(*v1.ExecuteRequest); ok {
+			return w.svc.WebServerBinCMD().Exec(ctx, req)
+		}
+
+		return nil, errors.Errorf("invalid get request, need *pbv1.ExecuteRequest, not %T", request)
+	}
+}

internal/bifrost/endpoint/v1/web_server_bin_cmd/exec.go

@@ -0,0 +1,11 @@
+package web_server_bin_cmd
+
+import svcv1 "github.com/ClessLi/bifrost/internal/bifrost/service/v1"
+
+type webServerBinCMDEndpoints struct {
+	svc svcv1.ServiceFactory
+}
+
+func NewWebServerBinCMDEndpoints(svc svcv1.ServiceFactory) *webServerBinCMDEndpoints {
+	return &webServerBinCMDEndpoints{svc: svc}
+}

internal/bifrost/endpoint/v1/web_server_bin_cmd/web_server_status.go

@@ -35,6 +35,10 @@ func (l *loggingService) WebServerLogWatcher() svcv1.WebServerLogWatcherService
 	return newWebServerLogWatcherMiddleware(l.svc)
 }
 
+func (l *loggingService) WebServerBinCMD() svcv1.WebServerBinCMDService {
+	return newWebServerBinCMDMiddleware(l.svc)
+}
+
 func New(svc svcv1.ServiceFactory) svcv1.ServiceFactory {
 	once.Do(func() {
 		logger = logV1.K()