Skip to content

Added tests for thread-local caches cleanup. #362

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 4 commits into from
Jul 31, 2023
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1 change: 1 addition & 0 deletions BUILD
Original file line number Diff line number Diff line change
Expand Up @@ -76,6 +76,7 @@ cc_library(
"src/signature_util.cc",
"src/vm_id_handle.cc",
"src/wasm.cc",
"src/wasm.h",
],
hdrs = [
"include/proxy-wasm/bytecode_util.h",
Expand Down
20 changes: 20 additions & 0 deletions src/wasm.cc
Original file line number Diff line number Diff line change
Expand Up @@ -670,4 +670,24 @@ void clearWasmCachesForTesting() {
}
}

std::vector<std::string> staleLocalPluginsKeysForTesting() {
std::vector<std::string> keys;
for (const auto &kv : local_plugins) {
if (kv.second.expired()) {
keys.push_back(kv.first);
}
}
return keys;
}

std::vector<std::string> staleLocalWasmsKeysForTesting() {
std::vector<std::string> keys;
for (const auto &kv : local_wasms) {
if (kv.second.expired()) {
keys.push_back(kv.first);
}
}
return keys;
}

} // namespace proxy_wasm
25 changes: 25 additions & 0 deletions src/wasm.h
Original file line number Diff line number Diff line change
@@ -0,0 +1,25 @@
// Copyright 2023 Google LLC
//
// 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.

#pragma once

#include <string>
#include <vector>

namespace proxy_wasm {

std::vector<std::string> staleLocalWasmsKeysForTesting();
std::vector<std::string> staleLocalPluginsKeysForTesting();

} // namespace proxy_wasm
82 changes: 82 additions & 0 deletions test/wasm_test.cc
Original file line number Diff line number Diff line change
Expand Up @@ -20,6 +20,8 @@

#include "test/utility.h"

#include "src/wasm.h"

namespace proxy_wasm {

INSTANTIATE_TEST_SUITE_P(WasmEngines, TestVm, testing::ValuesIn(getWasmEngines()),
Expand Down Expand Up @@ -242,4 +244,84 @@ TEST_P(TestVm, AlwaysApplyCanary) {
}
}

// Check that there are no stale thread-local cache keys (eventually)
TEST_P(TestVm, CleanupThreadLocalCacheKeys) {
const auto *const plugin_name = "plugin_name";
const auto *const root_id = "root_id";
const auto *const vm_id = "vm_id";
const auto *const vm_config = "vm_config";
const auto *const plugin_config = "plugin_config";
const auto fail_open = false;

WasmHandleFactory wasm_handle_factory =
[this, vm_id, vm_config](std::string_view vm_key) -> std::shared_ptr<WasmHandleBase> {
auto base_wasm = std::make_shared<WasmBase>(makeVm(engine_), vm_id, vm_config, vm_key,
std::unordered_map<std::string, std::string>{},
AllowedCapabilitiesMap{});
return std::make_shared<WasmHandleBase>(base_wasm);
};

WasmHandleCloneFactory wasm_handle_clone_factory =
[this](const std::shared_ptr<WasmHandleBase> &base_wasm_handle)
-> std::shared_ptr<WasmHandleBase> {
auto wasm = std::make_shared<WasmBase>(
base_wasm_handle, [this]() -> std::unique_ptr<WasmVm> { return makeVm(engine_); });
return std::make_shared<WasmHandleBase>(wasm);
};

PluginHandleFactory plugin_handle_factory =
[](const std::shared_ptr<WasmHandleBase> &base_wasm,
const std::shared_ptr<PluginBase> &plugin) -> std::shared_ptr<PluginHandleBase> {
return std::make_shared<PluginHandleBase>(base_wasm, plugin);
};

// Read the minimal loadable binary.
auto source = readTestWasmFile("abi_export.wasm");

// Simulate a plugin lifetime.
const auto plugin1 = std::make_shared<PluginBase>(plugin_name, root_id, vm_id, engine_,
plugin_config, fail_open, "plugin_1");
auto base_wasm_handle1 =
createWasm("vm_1", source, plugin1, wasm_handle_factory, wasm_handle_clone_factory, false);
ASSERT_TRUE(base_wasm_handle1 && base_wasm_handle1->wasm());

auto local_plugin1 = getOrCreateThreadLocalPlugin(
base_wasm_handle1, plugin1, wasm_handle_clone_factory, plugin_handle_factory);
ASSERT_TRUE(local_plugin1 && local_plugin1->plugin());
local_plugin1.reset();

auto stale_plugins_keys = staleLocalPluginsKeysForTesting();
EXPECT_EQ(1, stale_plugins_keys.size());

// Now we create another plugin with a slightly different key and expect that there are no stale
// thread-local cache entries.
const auto plugin2 = std::make_shared<PluginBase>(plugin_name, root_id, vm_id, engine_,
plugin_config, fail_open, "plugin_2");
auto local_plugin2 = getOrCreateThreadLocalPlugin(
base_wasm_handle1, plugin2, wasm_handle_clone_factory, plugin_handle_factory);
ASSERT_TRUE(local_plugin2 && local_plugin2->plugin());

stale_plugins_keys = staleLocalPluginsKeysForTesting();
EXPECT_TRUE(stale_plugins_keys.empty());

// Trigger deletion of the thread-local WasmVM cloned from base_wasm_handle1 by freeing objects
// referencing it.
local_plugin2.reset();

auto stale_wasms_keys = staleLocalWasmsKeysForTesting();
EXPECT_EQ(1, stale_wasms_keys.size());

// Create another base WASM handle and invoke WASM thread-local cache key cleanup.
auto base_wasm_handle2 =
createWasm("vm_2", source, plugin2, wasm_handle_factory, wasm_handle_clone_factory, false);
ASSERT_TRUE(base_wasm_handle2 && base_wasm_handle2->wasm());

auto local_plugin3 = getOrCreateThreadLocalPlugin(
base_wasm_handle2, plugin2, wasm_handle_clone_factory, plugin_handle_factory);
ASSERT_TRUE(local_plugin3 && local_plugin3->plugin());

stale_wasms_keys = staleLocalWasmsKeysForTesting();
EXPECT_TRUE(stale_wasms_keys.empty());
}

} // namespace proxy_wasm