// // // Copyright 2016 gRPC authors. // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. // You may obtain a copy of the License at // // http://www.apache.org/licenses/LICENSE-2.0 // // Unless required by applicable law or agreed to in writing, software // distributed under the License is distributed on an "AS IS" BASIS, // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. // // #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include "src/core/lib/gprpp/crash.h" #include "src/proto/grpc/health/v1/health.grpc.pb.h" #include "src/proto/grpc/testing/duplicate/echo_duplicate.grpc.pb.h" #include "src/proto/grpc/testing/echo.grpc.pb.h" #include "test/core/util/port.h" #include "test/core/util/test_config.h" #include "test/cpp/end2end/test_health_check_service_impl.h" #include "test/cpp/end2end/test_service_impl.h" using grpc::health::v1::Health; using grpc::health::v1::HealthCheckRequest; using grpc::health::v1::HealthCheckResponse; namespace grpc { namespace testing { namespace { // A custom implementation of the health checking service interface. This is // used to test that it prevents the server from creating a default service and // also serves as an example of how to override the default service. class CustomHealthCheckService : public HealthCheckServiceInterface { public: explicit CustomHealthCheckService(HealthCheckServiceImpl* impl) : impl_(impl) { impl_->SetStatus("", HealthCheckResponse::SERVING); } void SetServingStatus(const std::string& service_name, bool serving) override { impl_->SetStatus(service_name, serving ? HealthCheckResponse::SERVING : HealthCheckResponse::NOT_SERVING); } void SetServingStatus(bool serving) override { impl_->SetAll(serving ? HealthCheckResponse::SERVING : HealthCheckResponse::NOT_SERVING); } void Shutdown() override { impl_->Shutdown(); } private: HealthCheckServiceImpl* impl_; // not owned }; class HealthServiceEnd2endTest : public ::testing::Test { protected: HealthServiceEnd2endTest() {} void SetUpServer(bool register_sync_test_service, bool add_async_cq, bool explicit_health_service, std::unique_ptr service) { int port = grpc_pick_unused_port_or_die(); server_address_ << "localhost:" << port; bool register_sync_health_service_impl = explicit_health_service && service != nullptr; // Setup server ServerBuilder builder; if (explicit_health_service) { std::unique_ptr option( new HealthCheckServiceServerBuilderOption(std::move(service))); builder.SetOption(std::move(option)); } builder.AddListeningPort(server_address_.str(), grpc::InsecureServerCredentials()); if (register_sync_test_service) { // Register a sync service. builder.RegisterService(&echo_test_service_); } if (register_sync_health_service_impl) { builder.RegisterService(&health_check_service_impl_); } if (add_async_cq) { cq_ = builder.AddCompletionQueue(); } server_ = builder.BuildAndStart(); } void TearDown() override { if (server_) { server_->Shutdown(); if (cq_ != nullptr) { cq_->Shutdown(); } if (cq_thread_.joinable()) { cq_thread_.join(); } } } void ResetStubs() { std::shared_ptr channel = grpc::CreateChannel( server_address_.str(), InsecureChannelCredentials()); hc_stub_ = grpc::health::v1::Health::NewStub(channel); } // When the expected_status is NOT OK, we do not care about the response. void SendHealthCheckRpc(const std::string& service_name, const Status& expected_status) { EXPECT_FALSE(expected_status.ok()); SendHealthCheckRpc(service_name, expected_status, HealthCheckResponse::UNKNOWN); } void SendHealthCheckRpc( const std::string& service_name, const Status& expected_status, HealthCheckResponse::ServingStatus expected_serving_status) { HealthCheckRequest request; request.set_service(service_name); HealthCheckResponse response; ClientContext context; Status s = hc_stub_->Check(&context, request, &response); EXPECT_EQ(expected_status.error_code(), s.error_code()); if (s.ok()) { EXPECT_EQ(expected_serving_status, response.status()); } } void VerifyHealthCheckService() { HealthCheckServiceInterface* service = server_->GetHealthCheckService(); EXPECT_TRUE(service != nullptr); const std::string kHealthyService("healthy_service"); const std::string kUnhealthyService("unhealthy_service"); const std::string kNotRegisteredService("not_registered"); service->SetServingStatus(kHealthyService, true); service->SetServingStatus(kUnhealthyService, false); ResetStubs(); SendHealthCheckRpc("", Status::OK, HealthCheckResponse::SERVING); SendHealthCheckRpc(kHealthyService, Status::OK, HealthCheckResponse::SERVING); SendHealthCheckRpc(kUnhealthyService, Status::OK, HealthCheckResponse::NOT_SERVING); SendHealthCheckRpc(kNotRegisteredService, Status(StatusCode::NOT_FOUND, "")); service->SetServingStatus(false); SendHealthCheckRpc("", Status::OK, HealthCheckResponse::NOT_SERVING); SendHealthCheckRpc(kHealthyService, Status::OK, HealthCheckResponse::NOT_SERVING); SendHealthCheckRpc(kUnhealthyService, Status::OK, HealthCheckResponse::NOT_SERVING); SendHealthCheckRpc(kNotRegisteredService, Status(StatusCode::NOT_FOUND, "")); } void VerifyHealthCheckServiceStreaming() { const std::string kServiceName("service_name"); HealthCheckServiceInterface* service = server_->GetHealthCheckService(); // Start Watch for service. ClientContext context; HealthCheckRequest request; request.set_service(kServiceName); std::unique_ptr> reader = hc_stub_->Watch(&context, request); // Initial response will be SERVICE_UNKNOWN. HealthCheckResponse response; EXPECT_TRUE(reader->Read(&response)); EXPECT_EQ(response.SERVICE_UNKNOWN, response.status()); response.Clear(); // Now set service to NOT_SERVING and make sure we get an update. service->SetServingStatus(kServiceName, false); EXPECT_TRUE(reader->Read(&response)); EXPECT_EQ(response.NOT_SERVING, response.status()); response.Clear(); // Now set service to SERVING and make sure we get another update. service->SetServingStatus(kServiceName, true); EXPECT_TRUE(reader->Read(&response)); EXPECT_EQ(response.SERVING, response.status()); // Finish call. context.TryCancel(); } // Verify that after HealthCheckServiceInterface::Shutdown is called // 1. unary client will see NOT_SERVING. // 2. unary client still sees NOT_SERVING after a SetServing(true) is called. // 3. streaming (Watch) client will see an update. // 4. setting a new service to serving after shutdown will add the service // name but return NOT_SERVING to client. // This has to be called last. void VerifyHealthCheckServiceShutdown() { HealthCheckServiceInterface* service = server_->GetHealthCheckService(); EXPECT_TRUE(service != nullptr); const std::string kHealthyService("healthy_service"); const std::string kUnhealthyService("unhealthy_service"); const std::string kNotRegisteredService("not_registered"); const std::string kNewService("add_after_shutdown"); service->SetServingStatus(kHealthyService, true); service->SetServingStatus(kUnhealthyService, false); ResetStubs(); // Start Watch for service. ClientContext context; HealthCheckRequest request; request.set_service(kHealthyService); std::unique_ptr> reader = hc_stub_->Watch(&context, request); HealthCheckResponse response; EXPECT_TRUE(reader->Read(&response)); EXPECT_EQ(response.SERVING, response.status()); SendHealthCheckRpc("", Status::OK, HealthCheckResponse::SERVING); SendHealthCheckRpc(kHealthyService, Status::OK, HealthCheckResponse::SERVING); SendHealthCheckRpc(kUnhealthyService, Status::OK, HealthCheckResponse::NOT_SERVING); SendHealthCheckRpc(kNotRegisteredService, Status(StatusCode::NOT_FOUND, "")); SendHealthCheckRpc(kNewService, Status(StatusCode::NOT_FOUND, "")); // Shutdown health check service. service->Shutdown(); // Watch client gets another update. EXPECT_TRUE(reader->Read(&response)); EXPECT_EQ(response.NOT_SERVING, response.status()); // Finish Watch call. context.TryCancel(); SendHealthCheckRpc("", Status::OK, HealthCheckResponse::NOT_SERVING); SendHealthCheckRpc(kHealthyService, Status::OK, HealthCheckResponse::NOT_SERVING); SendHealthCheckRpc(kUnhealthyService, Status::OK, HealthCheckResponse::NOT_SERVING); SendHealthCheckRpc(kNotRegisteredService, Status(StatusCode::NOT_FOUND, "")); // Setting status after Shutdown has no effect. service->SetServingStatus(kHealthyService, true); SendHealthCheckRpc(kHealthyService, Status::OK, HealthCheckResponse::NOT_SERVING); // Adding serving status for a new service after shutdown will return // NOT_SERVING. service->SetServingStatus(kNewService, true); SendHealthCheckRpc(kNewService, Status::OK, HealthCheckResponse::NOT_SERVING); } TestServiceImpl echo_test_service_; HealthCheckServiceImpl health_check_service_impl_; std::unique_ptr hc_stub_; std::unique_ptr cq_; std::unique_ptr server_; std::ostringstream server_address_; std::thread cq_thread_; }; TEST_F(HealthServiceEnd2endTest, DefaultHealthServiceDisabled) { EnableDefaultHealthCheckService(false); EXPECT_FALSE(DefaultHealthCheckServiceEnabled()); SetUpServer(true, false, false, nullptr); HealthCheckServiceInterface* default_service = server_->GetHealthCheckService(); EXPECT_TRUE(default_service == nullptr); ResetStubs(); SendHealthCheckRpc("", Status(StatusCode::UNIMPLEMENTED, "")); } TEST_F(HealthServiceEnd2endTest, DefaultHealthService) { EnableDefaultHealthCheckService(true); EXPECT_TRUE(DefaultHealthCheckServiceEnabled()); SetUpServer(true, false, false, nullptr); VerifyHealthCheckService(); VerifyHealthCheckServiceStreaming(); // The default service has a size limit of the service name. const std::string kTooLongServiceName(201, 'x'); SendHealthCheckRpc(kTooLongServiceName, Status(StatusCode::INVALID_ARGUMENT, "")); } TEST_F(HealthServiceEnd2endTest, DefaultHealthServiceShutdown) { EnableDefaultHealthCheckService(true); EXPECT_TRUE(DefaultHealthCheckServiceEnabled()); SetUpServer(true, false, false, nullptr); VerifyHealthCheckServiceShutdown(); } // Provide an empty service to disable the default service. TEST_F(HealthServiceEnd2endTest, ExplicitlyDisableViaOverride) { EnableDefaultHealthCheckService(true); EXPECT_TRUE(DefaultHealthCheckServiceEnabled()); std::unique_ptr empty_service; SetUpServer(true, false, true, std::move(empty_service)); HealthCheckServiceInterface* service = server_->GetHealthCheckService(); EXPECT_TRUE(service == nullptr); ResetStubs(); SendHealthCheckRpc("", Status(StatusCode::UNIMPLEMENTED, "")); } // Provide an explicit override of health checking service interface. TEST_F(HealthServiceEnd2endTest, ExplicitlyOverride) { EnableDefaultHealthCheckService(true); EXPECT_TRUE(DefaultHealthCheckServiceEnabled()); std::unique_ptr override_service( new CustomHealthCheckService(&health_check_service_impl_)); HealthCheckServiceInterface* underlying_service = override_service.get(); SetUpServer(false, false, true, std::move(override_service)); HealthCheckServiceInterface* service = server_->GetHealthCheckService(); EXPECT_TRUE(service == underlying_service); ResetStubs(); VerifyHealthCheckService(); VerifyHealthCheckServiceStreaming(); } TEST_F(HealthServiceEnd2endTest, ExplicitlyHealthServiceShutdown) { EnableDefaultHealthCheckService(true); EXPECT_TRUE(DefaultHealthCheckServiceEnabled()); std::unique_ptr override_service( new CustomHealthCheckService(&health_check_service_impl_)); HealthCheckServiceInterface* underlying_service = override_service.get(); SetUpServer(false, false, true, std::move(override_service)); HealthCheckServiceInterface* service = server_->GetHealthCheckService(); EXPECT_TRUE(service == underlying_service); ResetStubs(); VerifyHealthCheckServiceShutdown(); } } // namespace } // namespace testing } // namespace grpc int main(int argc, char** argv) { grpc::testing::TestEnvironment env(&argc, argv); ::testing::InitGoogleTest(&argc, argv); return RUN_ALL_TESTS(); }