TensorFlow Serving C++ API Documentation
resource_preserving_policy_test.cc
1 /* Copyright 2016 Google Inc. All Rights Reserved.
2 
3 Licensed under the Apache License, Version 2.0 (the "License");
4 you may not use this file except in compliance with the License.
5 You may obtain a copy of the License at
6 
7  http://www.apache.org/licenses/LICENSE-2.0
8 
9 Unless required by applicable law or agreed to in writing, software
10 distributed under the License is distributed on an "AS IS" BASIS,
11 WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
12 See the License for the specific language governing permissions and
13 limitations under the License.
14 ==============================================================================*/
15 
16 #include "tensorflow_serving/core/resource_preserving_policy.h"
17 
18 #include <vector>
19 
20 #include <gtest/gtest.h>
21 #include "tensorflow_serving/core/servable_id.h"
22 
23 namespace tensorflow {
24 namespace serving {
25 namespace {
26 
27 // Test that the first ready and non-aspired version is unloaded first.
28 TEST(ResourcePreservingPolicyTest, UnloadsFirstNonAspired) {
29  std::vector<AspiredServableStateSnapshot> versions;
30  versions.push_back({{"test", 1}, LoaderHarness::State::kUnloading, false});
31  versions.push_back({{"test", 2}, LoaderHarness::State::kReady, true});
32  versions.push_back({{"test", 3}, LoaderHarness::State::kReady, false});
33  versions.push_back({{"test", 4}, LoaderHarness::State::kNew, true});
34  versions.push_back({{"test", 5}, LoaderHarness::State::kReady, false});
35 
36  ResourcePreservingPolicy policy;
37  const auto action = policy.GetNextAction(versions);
38  ASSERT_TRUE(action);
39  EXPECT_EQ(AspiredVersionPolicy::Action::kUnload, action->action);
40  EXPECT_EQ(3, action->id.version);
41 }
42 
43 // Test that the aspired new version with the highest version is loaded when
44 // there are none to unload.
45 TEST(ResourcePreservingPolicyTest, LoadsFirstAspiredWhenNoneToUnload) {
46  std::vector<AspiredServableStateSnapshot> versions;
47  versions.push_back({{"test", 1}, LoaderHarness::State::kReady, true});
48  versions.push_back({{"test", 2}, LoaderHarness::State::kLoading, true});
49  versions.push_back({{"test", 3}, LoaderHarness::State::kNew, true});
50  versions.push_back({{"test", 4}, LoaderHarness::State::kDisabled, false});
51  versions.push_back({{"test", 5}, LoaderHarness::State::kNew, true});
52 
53  ResourcePreservingPolicy policy;
54  const auto action = policy.GetNextAction(versions);
55  ASSERT_TRUE(action);
56  EXPECT_EQ(AspiredVersionPolicy::Action::kLoad, action->action);
57  EXPECT_EQ(5, action->id.version);
58 }
59 
60 // Test that no action is returned (empty optional) when there are no versions
61 // needing loading or unloading.
62 TEST(ResourcePreservingPolicyTest, ReturnsNoActionWhenNone) {
63  std::vector<AspiredServableStateSnapshot> versions;
64  versions.push_back({{"test", 1}, LoaderHarness::State::kReady, true});
65  versions.push_back({{"test", 2}, LoaderHarness::State::kError, true});
66  versions.push_back({{"test", 3}, LoaderHarness::State::kLoading, true});
67  versions.push_back({{"test", 4}, LoaderHarness::State::kUnloading, false});
68  versions.push_back({{"test", 5}, LoaderHarness::State::kDisabled, false});
69 
70  ResourcePreservingPolicy policy;
71  const auto action = policy.GetNextAction(versions);
72  EXPECT_FALSE(action);
73 }
74 
75 TEST(ResourcePreservingPolicyTest, DoesNotLoadWhenOthersStillUnloading) {
76  std::vector<AspiredServableStateSnapshot> versions;
77  versions.push_back(
78  {{"test", 1}, LoaderHarness::State::kUnloadRequested, false});
79  versions.push_back({{"test", 2}, LoaderHarness::State::kNew, true});
80 
81  ResourcePreservingPolicy policy;
82  const auto action = policy.GetNextAction(versions);
83  EXPECT_FALSE(action);
84 }
85 
86 TEST(ResourcePreservingPolicyTest, LoadIfUnaspiredIsError) {
87  std::vector<AspiredServableStateSnapshot> versions;
88  versions.push_back({{"test", 1}, LoaderHarness::State::kError, false});
89  versions.push_back({{"test", 2}, LoaderHarness::State::kNew, true});
90 
91  ResourcePreservingPolicy policy;
92  const auto action = policy.GetNextAction(versions);
93  ASSERT_TRUE(action);
94  EXPECT_EQ(AspiredVersionPolicy::Action::kLoad, action->action);
95  EXPECT_EQ(2, action->id.version);
96 }
97 
98 TEST(ResourcePreservingPolicyTest, ErrorAndUnloadRequestedPreventLoading) {
99  std::vector<AspiredServableStateSnapshot> versions;
100  versions.push_back({{"test", 1}, LoaderHarness::State::kError, false});
101  versions.push_back(
102  {{"test", 2}, LoaderHarness::State::kUnloadRequested, false});
103  versions.push_back({{"test", 3}, LoaderHarness::State::kNew, true});
104 
105  ResourcePreservingPolicy policy;
106  const auto action = policy.GetNextAction(versions);
107  EXPECT_FALSE(action);
108 }
109 
110 TEST(ResourcePreservingPolicyTest, ErrorAndDisabledAllowLoading) {
111  std::vector<AspiredServableStateSnapshot> versions;
112  versions.push_back({{"test", 1}, LoaderHarness::State::kError, false});
113  versions.push_back({{"test", 2}, LoaderHarness::State::kDisabled, false});
114  versions.push_back({{"test", 3}, LoaderHarness::State::kNew, true});
115 
116  ResourcePreservingPolicy policy;
117  const auto action = policy.GetNextAction(versions);
118  ASSERT_TRUE(action);
119  EXPECT_EQ(AspiredVersionPolicy::Action::kLoad, action->action);
120  EXPECT_EQ(3, action->id.version);
121 }
122 
123 } // namespace
124 } // namespace serving
125 } // namespace tensorflow
@ kReady
'loader_->Load()' has succeeded.
@ kUnloadRequested
The manager has been requested to unload this servable.
@ kDisabled
'loader_->Unload()' has finished.
@ kLoading
'loader_->Load()' has been called.
@ kUnloading
'loader_->Unload()' has been called.