Docs update for 1.2 (screenshots, guides and topics)

frontend/app/tests/e2e/form/multi-select.spec.ts

@@ -41,7 +41,7 @@ test.describe("Verify multi select behaviour", () => {
       await page.getByRole("button", { name: "+ Add new Tag" }).click();
       await page.getByTestId("new-object-form").getByLabel("Name *").fill("new tag");
       await page.getByRole("button", { name: "Save" }).click();
-      await expect(page.getByText("blue×green×new tag×")).toBeVisible();
+      await expect(page.getByText("new tag×")).toBeVisible();
     });
   });
 });

frontend/app/tests/e2e/guide/resource_manager_guide.spec.ts

@@ -0,0 +1,143 @@
+import { expect, test } from "@playwright/test";
+import { ACCOUNT_STATE_PATH } from "../../constants";
+import { saveScreenshotForDocs } from "../../utils";
+
+test.describe("Resource Managers guide", () => {
+  test.describe.configure({ mode: "parallel" });
+  test.slow();
+  test.use({ storageState: ACCOUNT_STATE_PATH.ADMIN });
+
+  test("IP Address Pool", async ({ page }) => {
+    await test.step("Create prefix 10.100.0.0/24", async () => {
+      await page.goto("/ipam");
+      await page.getByTestId("create-object-button").click();
+      await page.getByLabel("Prefix *").fill("10.100.0.0/24");
+      await saveScreenshotForDocs(page, "guides/resource_manager_rss_prefix_10_100_0");
+      await page.getByRole("button", { name: "Save" }).click();
+      await page.getByText("IPPrefix created").waitFor({ state: "visible" });
+    });
+
+    await test.step("Create IP Pool - 10.100.0.0/24", async () => {
+      await page.goto("/resource-manager");
+      await page.getByTestId("create-object-button").click();
+      await page.getByLabel("Select an object type").click();
+      await page.getByRole("option", { name: "IP Address Pool Core" }).click();
+
+      await page.getByRole("textbox", { name: "Name *" }).fill("My IP address pool");
+      await page.getByRole("spinbutton", { name: "Default Prefix Length" }).fill("24");
+      await page
+        .getByTestId("side-panel-container")
+        .locator("div")
+        .filter({ hasText: "Resources *" })
+        .nth(1)
+        .click();
+      await page.locator("form").getByPlaceholder("Filter...").fill("10.100.0");
+      await page.getByRole("option", { name: "10.100.0.0/" }).click();
+      await page
+        .locator("div")
+        .filter({ hasText: /^Resources \*$/ })
+        .click();
+
+      await page.getByRole("combobox", { name: "IPAM Namespace *" }).click();
+      await page.getByRole("option", { name: "default" }).click();
+
+      await saveScreenshotForDocs(page, "guides/resource_manager_pool_ip");
+      await page.getByRole("button", { name: "Save" }).click();
+    });
+
+    await test.step("Use Pool to allocate IP on Device", async () => {
+      await page.goto("/objects/InfraDevice");
+      await page.getByTestId("create-object-button").click();
+      await page.getByRole("combobox", { name: "Site" }).click();
+      await page.getByRole("option", { name: "atl1" }).click();
+      await page.getByRole("textbox", { name: "Name *" }).fill("dev-123");
+      await page.getByRole("textbox", { name: "Type *" }).fill("MX204");
+      await page.getByTestId("select-open-pool-option-button").click();
+      await page.getByRole("option", { name: "My IP address pool" }).waitFor({ state: "visible" });
+      await saveScreenshotForDocs(page, "guides/resource_manager_pool_device_before");
+      await page.getByRole("option", { name: "My IP address pool" }).click();
+      await saveScreenshotForDocs(page, "guides/resource_manager_pool_device_after");
+      await page.getByRole("button", { name: "Save" }).click();
+    });
+  });
+
+  test("IP Prefix Pool", async ({ page }) => {
+    await test.step("Create prefix 10.100.1.0/24", async () => {
+      await page.goto("/ipam");
+      await page.getByTestId("create-object-button").click();
+      await page.getByLabel("Prefix *").fill("10.100.1.0/24");
+      await page.getByRole("combobox", { name: "Member Type" }).click();
+      await page
+        .locator("div")
+        .filter({ hasText: /^Prefix$/ })
+        .click();
+      await saveScreenshotForDocs(page, "guides/resource_manager_rss_prefix_10_100_1");
+      await page.getByRole("button", { name: "Save" }).click();
+      await page.getByText("IPPrefix created").waitFor({ state: "visible" });
+    });
+
+    await test.step("Create Prefix Pool - 10.100.1.0/24", async () => {
+      await page.goto("/resource-manager");
+      await page.getByTestId("create-object-button").click();
+      await page.getByLabel("Select an object type").click();
+      await page.getByRole("option", { name: "IP Prefix Pool Core" }).click();
+
+      await page.getByRole("textbox", { name: "Name *" }).fill("Customer Service Pool");
+      await page.getByLabel("Default Prefix Length").fill("31");
+
+      await page
+        .getByTestId("side-panel-container")
+        .locator("div")
+        .filter({ hasText: "Resources *" })
+        .first()
+        .click();
+      await page.locator("form").getByPlaceholder("Filter...").fill("10.100.1");
+      await page.getByRole("option", { name: "10.100.1.0/" }).click();
+      await page
+        .locator("div")
+        .filter({ hasText: /^Resources \*$/ })
+        .click();
+
+      await page.getByRole("combobox", { name: "IPAM Namespace *" }).click();
+      await page.getByRole("option", { name: "default" }).click();
+
+      await saveScreenshotForDocs(page, "guides/resource_manager_pool_prefix");
+      await page.getByRole("button", { name: "Save" }).click();
+    });
+
+    // TODO: Allocating an IP prefix to a relationship of a node - Need #5888
+  });
+
+  test("Number Pool", async ({ page }) => {
+    await test.step("Create Number Pool - VLAN ID", async () => {
+      await page.goto("/resource-manager");
+      await page.getByTestId("create-object-button").click();
+      await page.getByLabel("Select an object type").click();
+      await page.getByRole("option", { name: "Number Pool Core" }).click();
+      await page.getByLabel("Name *").fill("My VLAN ID Pool");
+      await page.getByLabel("Node *").click();
+      const filterInput = page.getByPlaceholder("Filter...").nth(1);
+      await filterInput.fill("VLAN");
+      await page.getByText("VLAN Infra").waitFor({ state: "visible" });
+      await page.getByText("VLAN Infra").click();
+      await expect(page.getByLabel("Number Attribute *")).toContainText("Vlan Id");
+      await page.getByRole("spinbutton", { name: "Start range *" }).fill("100");
+      await page.getByRole("spinbutton", { name: "End range *" }).fill("1000");
+      await saveScreenshotForDocs(page, "guides/resource_manager_pool_vlan");
+      await page.getByRole("button", { name: "Save" }).click();
+      await page.getByText("Number pool created").waitFor({ state: "visible" });
+    });
+
+    await test.step("Use Pool to allocate ID to VLAN", async () => {
+      await page.goto("/objects/InfraVLAN");
+      await page.getByTestId("create-object-button").click();
+      await page.getByRole("textbox", { name: "Name *" }).fill("My vlan");
+      await page.getByTestId("number-pool-button").click();
+      await page.getByRole("option", { name: "My VLAN ID Pool" }).waitFor({ state: "visible" });
+      await saveScreenshotForDocs(page, "guides/resource_manager_pool_vlan_before");
+      await page.getByRole("option", { name: "My VLAN ID Pool" }).click();
+      await saveScreenshotForDocs(page, "guides/resource_manager_pool_vlan_after");
+      await page.getByRole("button", { name: "Save" }).click();
+    });
+  });
+});

frontend/app/tests/e2e/ipam/ipam-tree.spec.ts

@@ -52,8 +52,8 @@ test.describe("/ipam - Ipam Tree", () => {
 
   test("verify tree count", async ({ page }) => {
     await page.goto("/ipam/prefixes/");
-    await expect(page.getByRole("link", { name: "/8 19" })).toBeVisible();
-    await page.getByRole("treeitem", { name: "/8 19" }).getByTestId("tree-item-toggle").click();
+    await expect(page.getByRole("link", { name: "/8 21" })).toBeVisible();
+    await page.getByRole("treeitem", { name: "/8 21" }).getByTestId("tree-item-toggle").click();
     await expect(page.getByRole("link", { name: "/16 16" })).toBeVisible();
     await expect(page.getByRole("link", { name: "10.0.0.0/16" })).toBeVisible();
     await expect(page.getByRole("link", { name: "10.2.0.0/" })).toBeVisible();

frontend/app/tests/e2e/objects/object-hierarchical.spec.ts

@@ -49,7 +49,7 @@ test.describe("Object hierarchical view", () => {
     });
 
     await test.step("open site selection and verify All tab", async () => {
-      await page.getByLabel("Site *").click();
+      await page.getByLabel("Site").click();
       await expect(page.getByRole("tab", { name: "All" })).toBeVisible();
       await expect(page.getByRole("option", { name: "atl1" })).toBeVisible();
     });
@@ -62,7 +62,7 @@ test.describe("Object hierarchical view", () => {
     });
 
     await test.step("verify selected site", async () => {
-      await expect(page.getByLabel("Site *")).toContainText("atl1");
+      await expect(page.getByLabel("Site")).toContainText("atl1");
     });
   });
 });

models/base/dcim.yml

@@ -247,7 +247,7 @@ nodes:
       - name: site
         label: Site
         peer: LocationSite
-        optional: false
+        optional: true
         cardinality: one
         kind: Attribute
         order_weight: 1

models/base/ipam.yml

@@ -65,6 +65,7 @@ nodes:
             label: Drained
             description: "Temporarily taken out of service"
             color: "#bfbfbf"
+        default_value: "provisioning"
       - name: role
         kind: Dropdown
         choices:
@@ -80,6 +81,7 @@ nodes:
             label: User
             description: "Segments designed for end-user access and activities"
             color: "#a0b78d"
+        default_value: "server"
     relationships:
       - name: site
         label: "Site"

models/base/service.yml

@@ -59,3 +59,18 @@ nodes:
         identifier: infrabackboneservice__location_site_b
         kind: Attribute
         order_weight: 5
+
+  - name: Service
+    namespace: Customer
+    description: "A Customer service"
+    icon: "carbon:ibm-cloud-internet-services"
+    label: "Customer Service"
+    inherit_from:
+      - InfraService
+    relationships:
+      - name: assigned_prefix
+        label: "Assigned prefix"
+        peer: IpamIPPrefix
+        optional: false
+        kind: Attribute
+        cardinality: one