122 lines
4.6 KiB
Rust
122 lines
4.6 KiB
Rust
//! Example usage of the buildah module
|
|
//!
|
|
//! This file demonstrates how to use the buildah module to perform
|
|
//! common container operations like creating containers, running commands,
|
|
//! and managing images.
|
|
|
|
use sal::virt::buildah::{BuildahError, Builder};
|
|
use std::collections::HashMap;
|
|
|
|
/// Run a complete buildah workflow example
|
|
pub fn run_buildah_example() -> Result<(), BuildahError> {
|
|
println!("Starting buildah example workflow...");
|
|
|
|
// Step 1: Create a container from an image using the Builder
|
|
println!("\n=== Creating container from fedora:latest ===");
|
|
let mut builder = Builder::new("my-fedora-container", "fedora:latest")?;
|
|
|
|
// Reset the builder to remove any existing container
|
|
println!("\n=== Resetting the builder to start fresh ===");
|
|
builder.reset()?;
|
|
|
|
// Create a new container (or continue with existing one)
|
|
println!("\n=== Creating container from fedora:latest ===");
|
|
builder = Builder::new("my-fedora-container", "fedora:latest")?;
|
|
println!("Created container: {}", builder.container_id().unwrap_or(&"unknown".to_string()));
|
|
|
|
// Step 2: Run a command in the container
|
|
println!("\n=== Installing nginx in container ===");
|
|
// Use chroot isolation to avoid BPF issues
|
|
let install_result = builder.run_with_isolation("dnf install -y nginx", "chroot")?;
|
|
println!("{:#?}", install_result);
|
|
println!("Installation output: {}", install_result.stdout);
|
|
|
|
// Step 3: Copy a file into the container
|
|
println!("\n=== Copying configuration file to container ===");
|
|
builder.copy("./example.conf", "/etc/example.conf")?;
|
|
|
|
// Step 4: Configure container metadata
|
|
println!("\n=== Configuring container metadata ===");
|
|
let mut config_options = HashMap::new();
|
|
config_options.insert("port".to_string(), "80".to_string());
|
|
config_options.insert("label".to_string(), "maintainer=example@example.com".to_string());
|
|
config_options.insert("entrypoint".to_string(), "/usr/sbin/nginx".to_string());
|
|
builder.config(config_options)?;
|
|
println!("Container configured");
|
|
|
|
// Step 5: Commit the container to create a new image
|
|
println!("\n=== Committing container to create image ===");
|
|
let image_name = "my-nginx:latest";
|
|
builder.commit(image_name)?;
|
|
println!("Created image: {}", image_name);
|
|
|
|
// Step 6: List images to verify our new image exists
|
|
println!("\n=== Listing images ===");
|
|
let images = Builder::images()?;
|
|
println!("Found {} images:", images.len());
|
|
for image in images {
|
|
println!(" ID: {}", image.id);
|
|
println!(" Names: {}", image.names.join(", "));
|
|
println!(" Size: {}", image.size);
|
|
println!(" Created: {}", image.created);
|
|
println!();
|
|
}
|
|
|
|
// Step 7: Clean up (optional in a real workflow)
|
|
println!("\n=== Cleaning up ===");
|
|
Builder::image_remove(image_name)?;
|
|
builder.remove()?;
|
|
|
|
println!("\nBuildah example workflow completed successfully!");
|
|
Ok(())
|
|
}
|
|
|
|
/// Demonstrate how to build an image from a Containerfile/Dockerfile
|
|
pub fn build_image_example() -> Result<(), BuildahError> {
|
|
println!("Building an image from a Containerfile...");
|
|
|
|
// Use the build function with tag, context directory, and isolation to avoid BPF issues
|
|
let result = Builder::build(Some("my-app:latest"), ".", "example_Dockerfile", Some("chroot"))?;
|
|
|
|
println!("Build output: {}", result.stdout);
|
|
println!("Image built successfully!");
|
|
|
|
Ok(())
|
|
}
|
|
|
|
/// Example of pulling and pushing images
|
|
pub fn registry_operations_example() -> Result<(), BuildahError> {
|
|
println!("Demonstrating registry operations...");
|
|
|
|
// Pull an image
|
|
println!("\n=== Pulling an image ===");
|
|
Builder::image_pull("docker.io/library/alpine:latest", true)?;
|
|
println!("Image pulled successfully");
|
|
|
|
// Tag the image
|
|
println!("\n=== Tagging the image ===");
|
|
Builder::image_tag("alpine:latest", "my-alpine:v1.0")?;
|
|
println!("Image tagged successfully");
|
|
|
|
// Push an image (this would typically go to a real registry)
|
|
// println!("\n=== Pushing an image (example only) ===");
|
|
// println!("In a real scenario, you would push to a registry with:");
|
|
// println!("Builder::image_push(\"my-alpine:v1.0\", \"docker://registry.example.com/my-alpine:v1.0\", true)");
|
|
|
|
Ok(())
|
|
}
|
|
|
|
/// Main function to run all examples
|
|
pub fn run_all_examples() -> Result<(), BuildahError> {
|
|
println!("=== BUILDAH MODULE EXAMPLES ===\n");
|
|
|
|
run_buildah_example()?;
|
|
build_image_example()?;
|
|
registry_operations_example()?;
|
|
|
|
Ok(())
|
|
}
|
|
|
|
fn main() {
|
|
let _ = run_all_examples().unwrap();
|
|
} |