Oracle Cloud Infrastructure Documentation

Attaching a Workload to a Roving Edge Infrastructure Device Node

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's included when a Roving Edge Infrastructure device node is provisioned. When you request a Roving Edge Infrastructure device node for provisioning, you can 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. Or, you can attach workloads after your device node is provisioned.

Note

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 and click Hybrid. Under Roving Edge Infrastructure, click Nodes. The Nodes page appears.

    2. Select the Compartment from the list under List scope. All device nodes in that compartment are listed in tabular form.

    3. Select a State from the list under Tag filters to limit the device nodes displayed to that state.

    4. Click the link for the node for which you are attaching the workload. The node's Details page appears.

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

    6. Click Attach workload at the top of the workloads list. The Attach workload dialog box appears.

    7. Provide the following information:

      • Type: Select one of the following options:

        • Bucket: Complete the following:

          • Bucket in <compartment>: 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.

        • Image: Complete the following:

          • VM Image in <compartment>: Select one of the VM images available in the compartment. Click Change Compartment to select a different compartment.

    8. Click Attach workload.

    The workload you attached appears in the Workload list of the device node.

  • 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_ocid --node-id node_ocid --type "bucket" [OPTIONS]

    To determine your Roving Edge Infrastructure device compartment OCID, see Compartments.

    For a complete list of parameters and values for CLI commands, see the CLI Command 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