server_component.hpp

Go to the documentation of this file.

#pragma once
 
/// @file userver/ugrpc/server/server_component.hpp
/// @brief @copybrief ugrpc::server::ServerComponent
 
#include <userver/components/component_base.hpp>
 
#include <userver/ugrpc/server/server.hpp>
 
USERVER_NAMESPACE_BEGIN
 
namespace ugrpc::server {
 
namespace impl {
struct ServiceDefaults;
}  // namespace impl
 
// clang-format off
 
/// @ingroup userver_components
///
/// @brief Component that configures and manages the gRPC server.
///
/// ## Static options:
/// The component name for static config is `"grpc-server"`.
///
/// Name | Description | Default value
/// ---- | ----------- | -------------
/// access-tskv-logger | logger name for access-tskv.log | -
/// port | the port to use for all gRPC services, or 0 to pick any available | -
/// unix-socket-path | unix socket absolute path to listen to, instead of listening on `port` | -
/// completion-queue-count | count of completion queues to create | 2
/// channel-args | a map of channel arguments, see gRPC Core docs | {}
/// native-log-level | min log level for the native gRPC library | 'error'
/// enable-channelz | initialize service with runtime info about gRPC connections | false
/// service-defaults | default config values for gRPC services, see config schema | {}
/// tls.cert | path to file with server TLS certificate | -
/// tls.key | path to file with secret key from server TLS certificate | -
/// tls.ca | path to TLS client CA certificate | -
///
/// @see https://grpc.github.io/grpc/core/group__grpc__arg__keys.html
 
// clang-format on
class ServerComponent final : public components::ComponentBase {
public:
    /// @ingroup userver_component_names
    /// @brief The default name of ugrpc::server::ServerComponent
    static constexpr std::string_view kName = "grpc-server";
 
    ServerComponent(const components::ComponentConfig& config, const components::ComponentContext& context);
 
    ~ServerComponent() override;
 
    /// @returns The contained Server instance
    /// @note All configuration must be performed at the components loading stage
    Server& GetServer() noexcept;
 
    /// @cond
    ServiceConfig
    ParseServiceConfig(const components::ComponentConfig& config, const components::ComponentContext& context);
    /// @endcond
 
    static yaml_config::Schema GetStaticConfigSchema();
 
private:
    void OnAllComponentsLoaded() override;
 
    void OnAllComponentsAreStopping() override;
 
    Server server_;
    std::unique_ptr<impl::ServiceDefaults> service_defaults_;
};
 
}  // namespace ugrpc::server
 
template <>
inline constexpr bool components::kHasValidate<ugrpc::server::ServerComponent> = true;
 
USERVER_NAMESPACE_END