Attaching a Workload to a Roving Edge Infrastructure Device Node

Describes how to attach a workload to a Roving Edge Infrastructure device node in Oracle Cloud Infrastructure.

Note

Attach workloads after creating the node.

Workloads determine the Oracle Cloud Infrastructure-based content that is included when a Roving Edge Infrastructure device node is provisioned. When you request a Roving Edge Infrastructure device node for provisioning, you attach the available workloads associated with that Roving Edge Infrastructure device node for inclusion. When your device arrives, it contains the content from the workloads you specified at the time of provisioning.

Note

  • Attach at least one image workload and at least one object storage bucket workload when creating a Roving Edge Infrastructure device node.

  • The maximum size of an object you can use with Roving Edge Infrastructure devices is 5 TB. Any objects in your object store workload or any custom images greater than 5 TB in size are not be provisioned onto your Roving Edge Infrastructure device.

Workloads are managed as a resource within the Roving Edge Infrastructure device node, and you can attach, edit, and delete them. Each node's Details page contains a link for viewing the associated workloads. The workloads are displayed in tabular form, and you can view the details of each workload, and perform tasks on them.

When you attach a workload to your Roving Edge Infrastructure device node, you specify the Oracle Cloud Infrastructure compartment and object storage bucket in which the content you want resides within your tenancy. You can also specify filters that ensure only the files you want are included.

    1. Open the navigation menu. Under Hybrid Cloud, go to Roving Edge Infrastructure > Nodes.

    2. Select the Compartment from the list.

      All nodes in that compartment are listed in tabular form.

    3. (optional) Select a State from the list to limit the nodes displayed to that state.

    4. Click the link for the node for which you are attaching the workload.

      The Node Details dialog box appears.

    5. Click Workloads under Resources. A list of workloads appears.

    6. Click Select Workload at the top of the workloads list.

      The Select Workload dialog box appears.

    7. Provide the following information:

      • Type: Select one of the following options:

        • Bucket

          Complete the following:

          • Compartment: Select the compartment in your tenancy containing your object storage bucket.

          • Bucket Name: Enter the name of the bucket where the files for the selected workload reside. The bucket name is what appears under the Name column in the Workload list.

          • Prefix: Enter a string to use for matching against the start of object names in a list query.

          • Range Start: Enter a value to which object names returned by a list query must be greater or equal.

          • Range End: Enter a value to which object names returned by a list query must be less.

        • Compute

          Complete the following:

          • Compartment: Select the compartment in your tenancy containing your virtual machine (VM) image.

          • VM Image: Select one of the VM images available in the compartment.

    8. Click Attach Workload.

      The selected workload appears in the Workload list.

  • Use the oci rover node add-workload command and required parameters to attach a workload to a Roving Edge Infrastructure device node in Oracle Cloud Infrastructure:

    oci rover node add-workload --compartment-id compartment-id --node-id node_id --type "bucket" [OPTIONS]

    For a complete list of flags and variable options for CLI commands, see the Command Line Reference.

  • Run the RoverWorkload definition with the CreateRoverNode endpoint to attach a workload to a Roving Edge Infrastructure device node in Oracle Cloud Infrastructure.

    RoverWorkload:
        description: Rover workload
        type: object
        required:
          - id
          - compartmentId
          - workloadType
        properties:
          name:
            description: Name of the Rover Workload
            type: string
          compartmentId:
            description: The OCID of the compartment containing the workload.
            type: string
          id:
            description: The Unique Oracle ID (OCID) that is immutable on creation.
            type: string
          size:
            description: Size of the workload.
            type: string
          objectCount:
            description: Number of objects in a workload.
            type: string
          prefix:
            description: Prefix to filter objects in case it is a bucket.
            type: string
          rangeStart:
            description: Start of the range in a bucket.
            type: string
          rangeEnd:
            description: End of the range in a bucket.
            type: string
          workloadType:
            description: The type of workload
            type: string