pub struct KataBackend { /* private fields */ }Expand description
Kata Containers sandbox backend.
Implementations§
Source§impl KataBackend
impl KataBackend
pub fn new( image_config: ImageConfig, rafs_store: Arc<RafsStore>, ninep_decider: Arc<dyn AccessDecider>, ninep_monitor: Option<Arc<ReferenceMonitor>>, ) -> Self
Trait Implementations§
Source§impl Debug for KataBackend
impl Debug for KataBackend
Source§impl SandboxBackend for KataBackend
impl SandboxBackend for KataBackend
Source§fn update_resources<'life0, 'life1, 'life2, 'async_trait>(
&'life0 self,
sandbox: &'life1 PodSandbox,
resources: &'life2 LinuxContainerResources,
) -> Pin<Box<dyn Future<Output = Result<()>> + Send + 'async_trait>>where
Self: 'async_trait,
'life0: 'async_trait,
'life1: 'async_trait,
'life2: 'async_trait,
fn update_resources<'life0, 'life1, 'life2, 'async_trait>(
&'life0 self,
sandbox: &'life1 PodSandbox,
resources: &'life2 LinuxContainerResources,
) -> Pin<Box<dyn Future<Output = Result<()>> + Send + 'async_trait>>where
Self: 'async_trait,
'life0: 'async_trait,
'life1: 'async_trait,
'life2: 'async_trait,
Apply new CPU/memory limits to the sandbox’s running container by
driving the kata-agent UpdateContainer RPC (the CRI
UpdateContainerResources path). The CRI-shaped
LinuxContainerResources is mapped to the guest’s
[oci::LinuxResources] and the agent rewrites the in-guest cgroups.
Uses sandbox.id as the guest container id — the same single-workload
convention exec_sync uses (see there). Requires a started sandbox
with a live agent connection; without a backend handle this fails
rather than silently no-op’ing (unlike the trait default), because a
caller asking to resize an unstarted sandbox has made a mistake.
Source§fn container_stats<'life0, 'life1, 'async_trait>(
&'life0 self,
sandbox: &'life1 PodSandbox,
) -> Pin<Box<dyn Future<Output = Result<Option<(CpuUsage, MemoryUsage)>>> + Send + 'async_trait>>where
Self: 'async_trait,
'life0: 'async_trait,
'life1: 'async_trait,
fn container_stats<'life0, 'life1, 'async_trait>(
&'life0 self,
sandbox: &'life1 PodSandbox,
) -> Pin<Box<dyn Future<Output = Result<Option<(CpuUsage, MemoryUsage)>>> + Send + 'async_trait>>where
Self: 'async_trait,
'life0: 'async_trait,
'life1: 'async_trait,
Fetch live CPU/memory usage for the sandbox’s container from the guest
via the kata-agent StatsContainer RPC, mapped into the CRI
CpuUsage/MemoryUsage shape.
Returns Ok(None) when the sandbox has no backend handle yet (never
started) so the caller can fall back to placeholder stats rather than
erroring on a not-yet-running sandbox. A live agent that then fails the
RPC surfaces as Err.
Source§fn backend_type(&self) -> &'static str
fn backend_type(&self) -> &'static str
"kata", "nspawn").Source§fn is_available(&self) -> bool
fn is_available(&self) -> bool
Source§fn initialize<'life0, 'life1, 'async_trait>(
&'life0 self,
_config: &'life1 PoolConfig,
) -> Pin<Box<dyn Future<Output = Result<()>> + Send + 'async_trait>>where
Self: 'async_trait,
'life0: 'async_trait,
'life1: 'async_trait,
fn initialize<'life0, 'life1, 'async_trait>(
&'life0 self,
_config: &'life1 PoolConfig,
) -> Pin<Box<dyn Future<Output = Result<()>> + Send + 'async_trait>>where
Self: 'async_trait,
'life0: 'async_trait,
'life1: 'async_trait,
Source§fn start<'life0, 'life1, 'life2, 'life3, 'life4, 'async_trait>(
&'life0 self,
sandbox: &'life1 mut PodSandbox,
_config: &'life2 PodSandboxConfig,
pool_config: &'life3 PoolConfig,
annotations: &'life4 HashMap<String, String>,
) -> Pin<Box<dyn Future<Output = Result<Arc<dyn SandboxHandle>>> + Send + 'async_trait>>where
Self: 'async_trait,
'life0: 'async_trait,
'life1: 'async_trait,
'life2: 'async_trait,
'life3: 'async_trait,
'life4: 'async_trait,
fn start<'life0, 'life1, 'life2, 'life3, 'life4, 'async_trait>(
&'life0 self,
sandbox: &'life1 mut PodSandbox,
_config: &'life2 PodSandboxConfig,
pool_config: &'life3 PoolConfig,
annotations: &'life4 HashMap<String, String>,
) -> Pin<Box<dyn Future<Output = Result<Arc<dyn SandboxHandle>>> + Send + 'async_trait>>where
Self: 'async_trait,
'life0: 'async_trait,
'life1: 'async_trait,
'life2: 'async_trait,
'life3: 'async_trait,
'life4: 'async_trait,
Source§fn stop<'life0, 'life1, 'async_trait>(
&'life0 self,
sandbox: &'life1 PodSandbox,
) -> Pin<Box<dyn Future<Output = Result<()>> + Send + 'async_trait>>where
Self: 'async_trait,
'life0: 'async_trait,
'life1: 'async_trait,
fn stop<'life0, 'life1, 'async_trait>(
&'life0 self,
sandbox: &'life1 PodSandbox,
) -> Pin<Box<dyn Future<Output = Result<()>> + Send + 'async_trait>>where
Self: 'async_trait,
'life0: 'async_trait,
'life1: 'async_trait,
Source§fn destroy<'life0, 'life1, 'async_trait>(
&'life0 self,
sandbox: &'life1 PodSandbox,
) -> Pin<Box<dyn Future<Output = Result<()>> + Send + 'async_trait>>where
Self: 'async_trait,
'life0: 'async_trait,
'life1: 'async_trait,
fn destroy<'life0, 'life1, 'async_trait>(
&'life0 self,
sandbox: &'life1 PodSandbox,
) -> Pin<Box<dyn Future<Output = Result<()>> + Send + 'async_trait>>where
Self: 'async_trait,
'life0: 'async_trait,
'life1: 'async_trait,
Source§fn reset<'life0, 'life1, 'async_trait>(
&'life0 self,
sandbox: &'life1 mut PodSandbox,
) -> Pin<Box<dyn Future<Output = Result<bool>> + Send + 'async_trait>>where
Self: 'async_trait,
'life0: 'async_trait,
'life1: 'async_trait,
fn reset<'life0, 'life1, 'async_trait>(
&'life0 self,
sandbox: &'life1 mut PodSandbox,
) -> Pin<Box<dyn Future<Output = Result<bool>> + Send + 'async_trait>>where
Self: 'async_trait,
'life0: 'async_trait,
'life1: 'async_trait,
Source§fn get_pids<'life0, 'life1, 'async_trait>(
&'life0 self,
sandbox: &'life1 PodSandbox,
) -> Pin<Box<dyn Future<Output = Result<Vec<u32>>> + Send + 'async_trait>>where
Self: 'async_trait,
'life0: 'async_trait,
'life1: 'async_trait,
fn get_pids<'life0, 'life1, 'async_trait>(
&'life0 self,
sandbox: &'life1 PodSandbox,
) -> Pin<Box<dyn Future<Output = Result<Vec<u32>>> + Send + 'async_trait>>where
Self: 'async_trait,
'life0: 'async_trait,
'life1: 'async_trait,
Source§fn deliver_namespace<'life0, 'life1, 'async_trait>(
&'life0 self,
sandbox: &'life1 PodSandbox,
namespace: Namespace,
subject: Subject,
transport: NamespaceTransport,
) -> Pin<Box<dyn Future<Output = Result<NamespaceDelivery>> + Send + 'async_trait>>where
Self: 'async_trait,
'life0: 'async_trait,
'life1: 'async_trait,
fn deliver_namespace<'life0, 'life1, 'async_trait>(
&'life0 self,
sandbox: &'life1 PodSandbox,
namespace: Namespace,
subject: Subject,
transport: NamespaceTransport,
) -> Pin<Box<dyn Future<Output = Result<NamespaceDelivery>> + Send + 'async_trait>>where
Self: 'async_trait,
'life0: 'async_trait,
'life1: 'async_trait,
Source§fn supports_exec(&self) -> bool
fn supports_exec(&self) -> bool
exec_sync is supported.Source§fn exec_sync<'life0, 'life1, 'life2, 'async_trait>(
&'life0 self,
sandbox: &'life1 PodSandbox,
command: &'life2 [String],
timeout_secs: u64,
) -> Pin<Box<dyn Future<Output = Result<(i32, Vec<u8>, Vec<u8>)>> + Send + 'async_trait>>where
Self: 'async_trait,
'life0: 'async_trait,
'life1: 'async_trait,
'life2: 'async_trait,
fn exec_sync<'life0, 'life1, 'life2, 'async_trait>(
&'life0 self,
sandbox: &'life1 PodSandbox,
command: &'life2 [String],
timeout_secs: u64,
) -> Pin<Box<dyn Future<Output = Result<(i32, Vec<u8>, Vec<u8>)>> + Send + 'async_trait>>where
Self: 'async_trait,
'life0: 'async_trait,
'life1: 'async_trait,
'life2: 'async_trait,
Auto Trait Implementations§
impl Freeze for KataBackend
impl !RefUnwindSafe for KataBackend
impl Send for KataBackend
impl Sync for KataBackend
impl Unpin for KataBackend
impl UnsafeUnpin for KataBackend
impl !UnwindSafe for KataBackend
Blanket Implementations§
Source§impl<T> BorrowMut<T> for Twhere
T: ?Sized,
impl<T> BorrowMut<T> for Twhere
T: ?Sized,
Source§fn borrow_mut(&mut self) -> &mut T
fn borrow_mut(&mut self) -> &mut T
§impl<T> Instrument for T
impl<T> Instrument for T
§fn instrument(self, span: Span) -> Instrumented<Self>
fn instrument(self, span: Span) -> Instrumented<Self>
§fn in_current_span(self) -> Instrumented<Self>
fn in_current_span(self) -> Instrumented<Self>
Source§impl<T> IntoEither for T
impl<T> IntoEither for T
Source§fn into_either(self, into_left: bool) -> Either<Self, Self>
fn into_either(self, into_left: bool) -> Either<Self, Self>
self into a Left variant of Either<Self, Self>
if into_left is true.
Converts self into a Right variant of Either<Self, Self>
otherwise. Read moreSource§fn into_either_with<F>(self, into_left: F) -> Either<Self, Self>
fn into_either_with<F>(self, into_left: F) -> Either<Self, Self>
self into a Left variant of Either<Self, Self>
if into_left(&self) returns true.
Converts self into a Right variant of Either<Self, Self>
otherwise. Read more