Method resolve_local_container_image

crates/openshell-driver-vm/src/driver.rs:1953–2024

(
        &self,
        image_ref: &str,
    )

    }

    async fn resolve_local_container_image(
        &self,
        image_ref: &str,
    ) -> Result<Option<(Docker, String)>, Status> {
        let required_local_image = is_openshell_local_build_image_ref(image_ref);
        let engine = match connect_local_container_engine().await {
            Some(engine) => engine,
            None if required_local_image => {
                return Err(Status::failed_precondition(format!(
                    "no container engine (Docker/Podman) available for locally built sandbox image '{image_ref}'"
                )));
            }
            None => {
                warn!(
                    image_ref = %image_ref,
                    "vm driver: no local container engine available, falling back to registry"
                );
                return Ok(None);
            }
        };

        match engine.inspect_image(image_ref).await {
            Ok(inspect) => {
                if let Some(message) = local_image_platform_mismatch(
                    image_ref,
                    inspect.os.as_deref(),
                    inspect.architecture.as_deref(),
                ) {
                    if required_local_image {
                        return Err(Status::failed_precondition(message));
                    }
                    warn!(
                        image_ref = %image_ref,
                        %message,
                        "vm driver: local container image platform mismatch, falling back to registry"
                    );
                    return Ok(None);
                }

                let image_identity = inspect.id.filter(|id| !id.trim().is_empty()).ok_or_else(
                    || {
                        Status::failed_precondition(format!(
                            "local container image '{image_ref}' inspect response has no image ID"
                        ))
                    },
                )?;
                info!(
                    image_ref = %image_ref,
                    image_identity = %image_identity,
                    "vm driver: resolved image from local container engine"
                );
                Ok(Some((engine, image_identity)))
            }
            Err(err) if is_docker_not_found_error(&err) && required_local_image => {
                Err(Status::failed_precondition(format!(
                    "locally built sandbox image '{image_ref}' is not present in the local container engine"
                )))
            }