wip

examples/scripts/_archive/instructions_grpc.md

@@ -0,0 +1,124 @@
+
+
+## ✅ Step-by-step: Connect Rust to containerd via gRPC
+
+
+CREATE A rhai script executing the following instructions below
+use all rhai script features we have + give priority to what functions we have defined in /src/docs/docs/sal in this repo
+
+
+---
+
+### 1. 🧱 Install Dependencies
+
+Add this to your `Cargo.toml`:
+
+```toml
+[dependencies]
+tonic = "0.11"
+prost = "0.12"
+tokio = { version = "1", features = ["full"] }
+
+[build-dependencies]
+tonic-build = "0.11"
+```
+
+---
+
+### 2. 📁 Clone containerd's gRPC proto files
+
+```bash
+git clone https://github.com/containerd/containerd.git
+cd containerd
+```
+
+Containerd's API protos are in:  
+```
+api/services/         # gRPC service definitions
+api/types/            # message types
+```
+
+---
+
+### 3. 📦 Set up `build.rs` to compile protos
+
+In your Rust project root, create a `build.rs` file:
+
+```rust
+fn main() {
+    tonic_build::configure()
+        .build_server(false)
+        .compile(
+            &[
+                "containerd/api/services/images/v1/images.proto", 
+                "containerd/api/services/containers/v1/containers.proto",
+                // Add more proto files as needed
+            ],
+            &[
+                "containerd/api", 
+                "containerd/api/types"
+            ],
+        )
+        .unwrap();
+}
+```
+
+Make sure to place the `containerd` directory somewhere your build can see — for example, symlink it or move it into your project as `proto/containerd`.
+
+---
+
+### 4. 🧪 Example: Connect to containerd's image service
+
+After `build.rs` compiles the protos, your code can access them like this:
+
+```rust
+use tonic::transport::Channel;
+use containerd::services::images::v1::{
+    images_client::ImagesClient,
+    GetImageRequest,
+};
+
+#[tokio::main]
+async fn main() -> Result<(), Box<dyn std::error::Error>> {
+    // Connect to containerd's gRPC socket (default path)
+    let channel = Channel::from_static("http://[::]:50051") // placeholder
+        .connect()
+        .await?;
+
+    let mut client = ImagesClient::new(channel);
+
+    let response = client.get(GetImageRequest {
+        name: "docker.io/library/ubuntu:latest".to_string(),
+    }).await?;
+
+    println!("Image: {:?}", response.into_inner());
+    Ok(())
+}
+```
+
+🔧 Note: containerd uses a **Unix socket**, so replace the channel connection with:
+
+```rust
+use tonic::transport::{Endpoint, Uri};
+use tower::service_fn;
+use hyper_unix_connector::UnixConnector;
+
+let uds = tokio::net::UnixStream::connect("/run/containerd/containerd.sock").await?;
+let channel = Endpoint::try_from("http://[::]:50051")?
+    .connect_with_connector(service_fn(move |_| async move {
+        Ok::<_, std::io::Error>(uds)
+    }))
+    .await?;
+```
+
+(We can wrap that part into a helper if you want.)
+
+---
+
+### 5. 🔁 Rebuild the project
+
+Each time you add or change a `.proto`, rebuild to regenerate code:
+
+```bash
+cargo clean && cargo build
+```