Skip to main content
Version: 1.15.0

Workspace Operations

This topic describes how to manage workspaces in EGS. You can create a workspace for an individual user or team in your organization based on the requirements.

Overview

A workspace is a logical boundary for a user or a team workspace. The workspace can be viewed as the workspace where users can deploy their AI workloads. A workspace can span multiple clusters, and the clusters can be located in different regions.

On the Portal, the Workspace page provides operations for viewing, organizing, configuring, and managing all workspaces in a multi-cluster environment.

Under Workspaces, a nested submenu appears showing:

  • All Workspaces (selected)
  • Current selected workspace context which allows navigation to workspace-specific resources:
    • Namespaces
    • Inference Endpoints
    • GPU Requests
    • GPR Templates
    • AI Workloads
    • Policies
    • Replicate
    • Cost Management

Create a Workspace

  1. Go to Workspace on the left sidebar.

    alt

  2. Under All Workspaces, click the + Add Workspace button on the top right.

  3. On the Add Workspace panel, under the Details tab, enter the following information:

    1. Add a name for the workspace in the Name text box. For example, my-workspace is the name of the workspace.
    2. Select the workspace overlay network type from the Network Type text box. The available network types are:
      • No Network: Select this option if your distributed applications do not require extended-cluster communication.
      • Single Network: Select this option if your applications benefit from communication through a dedicated overlay network.
  4. If you select No Network from the Network type drop-down list, you can skip the Subnet and QoS configuration.

    workspace

  5. If you select Single Network you must:

    • Enter the workspace subnet in the Subnet text box.
    • Select the QoS profile from the drop-down list.
      • For Default QoS, the QoS Dscp Class is AF11, and the QoS Bandwidth ceiling is 10000000 Kbps (10Gbps). The default values are immutable.
      • For Custom QoS, you must enter the QoS Dscp Class and QoS Bandwidth ceiling values in the Show advanced options section.

    workspace

  6. (Optional) Add the description to define the workspace in the Description text box.

  7. Expand the Show advanced options section and enter the following information:

    • Enter the maximum number of clusters to connect to this workspace in the Maximum Clusters text box. The minimum value is 2, and the maximum value is 32. The default value is 16.
    • For Custom QoS, enter DSCP class for the workspace traffic in the QoS Dscp Class text box and enter the maximum bandwidth in Kbps allowed for the workspace traffic in the QoS Bandwidth ceiling text box.
    • Select the Overlay Type from the drop-down list. The available gateway types are:
      • OpenVPN: This is the default gateway type.
      • WireGuard: This is a modern, high-performance VPN that utilizes state-of-the-art cryptography. It is designed to be faster and simpler than traditional VPNs like OpenVPN and IPsec.
  8. Click Next.

  9. To connect your cluster to your workspace that is being created, click the + sign against the cluster.

    alt

  10. Click the Create Workspace button to complete the workspace setup.

info

After creating the workspace, you can see the newly created workspace in the Workspaces page. The workspace policies are created automatically based on the workspace configuration.

View Workspaces

To view all the workspaces:

  1. Go to Workspace on the left sidebar.

  2. Select All Workspaces on the top left to view all the workspaces created in your organization.

    alt

View Workspace Details

To view the details of a specific workspace:

  1. On the Workspaces page, select the workspace you want to view.

  2. On the selected workspace page, you see the following tabs:

    • Info: Displays the workspace health and details such as name, network type, subnet, description, maximum clusters, QoS Dscp Class, QoS Bandwidth ceiling, overlay type, creation date, and status.
    • Gateways": Displays the list of gateways connected to the workspace.
    • Services: Displays the list of services connected to the workspace.
    • Clusters: Displays the list of clusters connected to the workspace along with their status.
    • Namespaces: Displays the list of namespaces onboarded onto the workspace.

Edit a Workspace

  1. Go to Workspace on the left sidebar

  2. Select All Workspaces on the top left.

  3. On the Workspaces page, select the workspace you want to edit.

  4. On the selected workspace page, click the Edit button on the top right.

  5. On the Edit Workspace pane, you can modify the following details under the Details tab:

    • Name
    • Network Type, you can change the network type from No Network to Single Network but cannot change from Single Network to No Network.
    • Subnet
    • Description
    • Maximum Clusters
    • QoS Dscp Class
    • QoS Bandwidth ceiling
    • Overlay Type
  6. In the Connect Clusters tab, you can perform the following:

    • Under All Clusters, to connect more clusters to the workspace, click the plus icon next to each worker cluster in the list.

      • Under Workspace Clusters, unselect the cluster to detach it from the workspace. Click the minus icon against a worker cluster to detach it from the workspace, enter the text DETACH to confirm, and click the Detach Cluster button.
  7. Click the Edit Workspace button to save the changes.

Delete a Workspace

warning

Be sure to detach clusters from a workspace before deleting it.

To delete a workspace:

  1. Go to Workspace on the left sidebar

  2. Select All Workspaces on the top left.

  3. On the Workspaces page, select the workspace you want to delete.

  4. On the selected workspace page, click the Delete button on the top right.

  5. On the confirm delete dialog, enter DELETE to confirm and click the Delete Workspace button.