Struct BuildahSidecarBackend 

pub struct BuildahSidecarBackend { /* private fields */ }

gRPC-client backend for the zlayer-buildd sidecar.

Construction does not connect or spawn — that happens lazily on the first call to BuildahSidecarBackend::lifecycle (or via is_available, which probes spawn-and-handshake). The backend:

• holds the resolved SidecarConfig (transport address, TLS dir, idle timeout),
• owns the SidecarLifecycle manager that spawns / dials the sidecar and caches the gRPC channel,
• returns BuildError::NotSupported from every trait method until tasks 3.3 / 3.4 wire the build flow through the gRPC channel.

Implementations

impl BuildahSidecarBackend

pub const NAME: &'static str = "buildah-sidecar"

Stable trait-level name. Mirrors BuildBackend::name.

pub fn new(config: SidecarConfig) -> Self

Create a new sidecar backend with the supplied configuration.

pub fn config(&self) -> &SidecarConfig

Borrow the underlying configuration.

pub fn lifecycle(&self) -> &Arc<SidecarLifecycle>

Access the lifecycle manager. Used by the RPC wiring landing in tasks 3.3 / 3.4 to acquire a live BuildServiceClient.

Trait Implementations

impl BuildBackend for BuildahSidecarBackend

fn build_image<'life0, 'life1, 'life2, 'life3, 'async_trait>( &'life0 self, context: &'life1 Path, dockerfile: &'life2 Dockerfile, options: &'life3 BuildOptions, event_tx: Option<Sender<BuildEvent>>, ) -> Pin<Box<dyn Future<Output = Result<BuiltImage>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait, 'life2: 'async_trait, 'life3: 'async_trait,

Build a container image from a parsed Dockerfile.

fn push_image<'life0, 'life1, 'life2, 'async_trait>( &'life0 self, tag: &'life1 str, auth: Option<&'life2 RegistryAuth>, ) -> Pin<Box<dyn Future<Output = Result<()>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait, 'life2: 'async_trait,

Push an image to a container registry.

fn tag_image<'life0, 'life1, 'life2, 'async_trait>( &'life0 self, image: &'life1 str, new_tag: &'life2 str, ) -> Pin<Box<dyn Future<Output = Result<()>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait, 'life2: 'async_trait,

Tag an existing image with a new name.

fn manifest_create<'life0, 'life1, 'async_trait>( &'life0 self, name: &'life1 str, ) -> Pin<Box<dyn Future<Output = Result<()>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Create a new (empty) manifest list.

fn manifest_add<'life0, 'life1, 'life2, 'async_trait>( &'life0 self, manifest: &'life1 str, image: &'life2 str, ) -> Pin<Box<dyn Future<Output = Result<()>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait, 'life2: 'async_trait,

Add an image to an existing manifest list.

fn manifest_push<'life0, 'life1, 'life2, 'life3, 'async_trait>( &'life0 self, name: &'life1 str, destination: &'life2 str, auth: Option<&'life3 RegistryAuth>, ) -> Pin<Box<dyn Future<Output = Result<()>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait, 'life2: 'async_trait, 'life3: 'async_trait,

Push a manifest list (and all referenced images) to a registry.

fn is_available<'life0, 'async_trait>( &'life0 self, ) -> Pin<Box<dyn Future<Output = bool> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

Returns true if the backend tooling is installed and functional.

fn name(&self) -> &'static str

Human-readable name for this backend (e.g. "buildah", "sandbox").

fn export_oci_archive<'life0, 'life1, 'life2, 'async_trait>( &'life0 self, tag: &'life1 str, dest: &'life2 Path, ) -> Pin<Box<dyn Future<Output = Result<bool>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait, 'life2: 'async_trait,

Export the built image tag to an OCI image-layout archive (tar) at dest, in the format [zlayer_registry::import_image] consumes (oci-layout + index.json + blobs/sha256/*).

impl Clone for BuildahSidecarBackend

fn clone(&self) -> BuildahSidecarBackend

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for BuildahSidecarBackend

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for BuildahSidecarBackend

fn default() -> Self

Returns the “default value” for a type.