Supporting deployments on zos4 nodes

packages/grid_client/docs/deployment_flow.md

@@ -0,0 +1,117 @@
+# Deployment Flow
+
+This document outlines the process for determining whether to deploy on a zos3 or zos4 node.
+
+## Machine Model Initialization
+
+The deployment process begins with initializing the machine model as follows:
+
+```ts
+const vms: MachinesModel = {
+  name: "newMY",
+  network: {
+    name: "hellotest",
+    ip_range: "10.249.0.0/16",
+    myceliumSeeds: [
+      {
+        nodeId: 168,
+        seed: "050d109829d8492d48bfb33b711056080571c69e46bfde6b4294c4c5bf468a76", //(HexSeed of length 32)
+      },
+    ],
+  },
+  machines: [
+    {
+      name: "testvmMY",
+      node_id: 168,
+      disks: [
+        {
+          name: "wedDisk",
+          size: 8,
+          mountpoint: "/testdisk",
+        },
+      ],
+      public_ip: false,
+      public_ip6: false,
+      planetary: true,
+      mycelium: true,
+      myceliumSeed: "1e1404279b3d", //(HexSeed of length 6)
+      cpu: 1,
+      memory: 1024 * 2,
+      rootfs_size: 0,
+      flist: "https://hub.grid.tf/tf-official-apps/base:latest.flist",
+      entrypoint: "/sbin/zinit init",
+      env: {
+        SSH_KEY: config.ssh_key,
+      },
+    },
+  ],
+  metadata: "",
+  description: "test deploying single VM with mycelium via ts grid3 client",
+};
+```
+
+## Deployment Execution
+
+- The next step is invoking the `deploy` function:
+  - Takes the `MachinesModel` object as a parameter
+  - Checks if a machine with the same name already exists and if so throws an error
+  - If not it calls the `_createDeployment` function along some othe functions
+  - Finally it returns the created contracts and the wiregaurd configuration
+
+```ts
+await client.machines.deploy(vms);
+```
+
+- The `_createDeployment` function:
+  - Takes the `MachinesModel` object as a parameter
+  - Retrieves the features of the node using: `await this.rmb.request([nodeTwinId], "zos.system.node_features_get", "", 20, 3);`
+  - Examines the retrieved features to determine the network's primitive type (`Network` or `ZNetworkLight`) and initializes it accordingly.
+  - Sets the contractMetadata based on the network type.
+  - Invokes the `create` function
+
+```ts
+await this._createDeployment(options);
+```
+
+- The `create` function
+  - Validates or assigns IP addresses based on the network type.
+  - Determines network type (`network` or `network-light`) based on node features.
+  - Adds access points and updates network configurations as necessary.
+  - Initialize the VM primitive (`VMPrimitive` or `VMLightPrimitive`) based on the network type
+  - Configures the VM with networking, storage, and environment variables.
+  - Generates a Mycelium seed if not provided.
+  - Generate the deployments
+  - Returns the deployments and wiregaurd configurations
+
+```ts
+await this.vm.create(
+  machine.name,
+  machine.node_id,
+  machine.flist,
+  machine.cpu,
+  machine.memory,
+  machine.rootfs_size,
+  machine.disks!,
+  machine.public_ip,
+  machine.public_ip6!,
+  machine.planetary,
+  machine.mycelium,
+  machine.myceliumSeed!,
+  network,
+  options.network.myceliumSeeds!,
+  machine.entrypoint,
+  machine.env,
+  contractMetadata,
+  options.metadata,
+  options.description,
+  machine.qsfs_disks,
+  this.config.projectName,
+  options.network.addAccess,
+  options.network.accessNodeId,
+  machine.ip,
+  machine.corex,
+  machine.solutionProviderId!,
+  machine.zlogsOutput,
+  machine.gpus,
+);
+```

packages/grid_client/scripts/single_vm_zos4.ts

@@ -0,0 +1,108 @@
+import { generateRandomHexSeed, GridClient, MachinesDeleteModel, MachinesModel } from "../src";
+import { config, getClient } from "./client_loader";
+import { log } from "./utils";
+
+async function deploy(client: GridClient, vms: MachinesModel) {
+  const res = await client.machines.deploy(vms);
+  log("================= Deploying VM =================");
+  log(res);
+  log("================= Deploying VM =================");
+}
+
+async function getDeployment(client: GridClient, name: string) {
+  const res = await client.machines.getObj(name);
+  log("================= Getting deployment information =================");
+  log(res);
+  log("================= Getting deployment information =================");
+}
+
+async function cancel(client: GridClient, options: MachinesDeleteModel) {
+  const res = await client.machines.delete(options);
+  log("================= Canceling the deployment =================");
+  log(res);
+  log("================= Canceling the deployment =================");
+}
+
+async function main() {
+  const name = "newMY";
+  const grid3 = await getClient(`vm/${name}`);
+
+  const vms: MachinesModel = {
+    name,
+    network: {
+      name: "hellotest",
+      ip_range: "10.249.0.0/16",
+      myceliumSeeds: [
+        {
+          nodeId: 255,
+          /**
+           * ### Mycelium Network Seed:
+           * - The `seed` is an optional field used to provide a specific seed for the Mycelium network.
+           * - If not provided, the `GridClient` will generate a seed automatically when the `mycelium` flag is enabled.
+           * - **Use Case:** If you need the new machine to have the same IP address as a previously deleted machine, set the `seed` field to the old seed value.
+           */
+          seed: generateRandomHexSeed(32),
+        },
+      ],
+    },
+    machines: [
+      {
+        name: "testvmMY",
+        node_id: 255,
+        disks: [
+          {
+            name: "wedDisk",
+            size: 8,
+            mountpoint: "/testdisk",
+          },
+        ],
+        public_ip: false,
+        public_ip6: false,
+        planetary: true,
+        /**
+         * ### Mycelium Flag Behavior:
+         * - When the `mycelium` flag is enabled, there’s no need to manually provide the `myceliumSeed` flag.
+         * - The `GridClient` will automatically generate the necessary seed for you.
+         * - **However**, if you have **an existing seed** from a previously deleted machine and wish to deploy a new machine that retains the same IP address,
+         * - **you can simply pass in the old seed during deployment instead of calling the `generateRandomHexSeed()` function**.
+         */
+        mycelium: true,
+        /**
+         * ### Mycelium Seed:
+         * - The `myceliumSeed` is an optional field used to provide a specific seed for the Mycelium network.
+         * - If not provided, the `GridClient` will generate a seed automatically when the `mycelium` flag is enabled.
+         * - **Use Case:** If you need the new machine to have the same IP address as a previously deleted machine, set the `seed` field to the old seed value.         */
+        myceliumSeed: generateRandomHexSeed(6), // (HexSeed of length 6)
+        cpu: 1,
+        memory: 265,
+        rootfs_size: 0,
+        flist: "https://hub.grid.tf/tf-official-apps/base:latest.flist",
+        entrypoint: "/sbin/zinit init",
+        env: {
+          SSH_KEY: config.ssh_key,
+        },
+        /**
+         * ### Features:
+         * - The `features` is an optional field used to provide a specific feature to the node.
+         * - If not provided, The deploy method will used the get feature zos call to get node's features and deploy according to that.
+         */
+        features: ["zmachine-light"],
+      },
+    ],
+    metadata: "",
+    description: "test deploying single ZOS4 VM with mycelium via ts grid3 client",
+  };
+
+  //Deploy VMs
+  await deploy(grid3, vms);
+
+  //Get the deployment
+  await getDeployment(grid3, name);
+
+  //Uncomment the line below to cancel the deployment
+  // await cancel(grid3, { name });
+
+  await grid3.disconnect();
+}
+
+main();

packages/grid_client/src/high_level/kubernetes.ts

@@ -2,6 +2,7 @@ import { events } from "../helpers/events";
 import { VMHL } from "../high_level//machine";
 import { MyceliumNetworkModel, QSFSDiskModel } from "../modules/models";
 import { Network } from "../primitives/network";
+import { ZNetworkLight } from "../primitives/networklight";
 import { Deployment } from "../zos/deployment";
 import { WorkloadTypes } from "../zos/workload";
 import { HighLevelBase } from "./base";
@@ -22,7 +23,7 @@ class KubernetesHL extends HighLevelBase {
     planetary: boolean,
     mycelium: boolean,
     myceliumSeed: string,
-    network: Network,
+    network: Network | ZNetworkLight,
     myceliumNetworkSeeds: MyceliumNetworkModel[] = [],
     sshKey: string,
     contractMetadata: string,
@@ -100,7 +101,7 @@ class KubernetesHL extends HighLevelBase {
     planetary: boolean,
     mycelium: boolean,
     myceliumSeed: string,
-    network: Network,
+    network: Network | ZNetworkLight,
     myceliumNetworkSeeds: MyceliumNetworkModel[] = [],
     sshKey: string,
     contractMetadata,