Working with Resources

3 minute read

A resource is a host cluster container for both static hosts and cloud burst hosts that will participate in a build. For example, you might want your builds to run on specific agents if certain tools are installed only on those agents. Resources let you define groups of agents that you can specify when running builds to narrow down which agents can be used in those builds.

A resource can contain solely static hosts, solely cloud burst hosts, or a combination of each.

A static host is any system that is running Accelerator agents and is always (or effectively always) connected to the cluster. A static host could be hosted in the cloud (exactly as a cloud burst host would be) or on an on-premise physical or virtual machine.

A cloud burst host is any system that is running Accelerator agents and is provisioned automatically and dynamically as needed to satisfy demand (whereas a static host simply “exists”).

The Cluster Manager lets you perform resource management tasks such as creating, editing, or deleting resources. See the following topics for details about resources and resource management:

Creating Resources

A resource is a host cluster container for both static hosts and cloud burst hosts that will participate in a build. You can create a resource to contain solely static hosts, solely cloud burst hosts, or a combination of each. For more information about resources, the purpose of resources, and a description of static versus cloud burst hosts, see Working with Resources .

For cloud burst hosts, you need your cloud provider credentials and all details for your cloud instance. You must have set up your Amazon EC2 or Kubernetes containers in advance. For details, see the ElectricAccelerator Installation Guide and the ElectricAccelerator Configuration Guide.

  1. On the Resources page, click New Resource.

This opens an empty resource details page.

  1. Provide a unique name for your resource definition.

The name can contain numbers and letters. This is also the name that you specify in the --emake-resource=resourcename eMake command-line option or in the build class’s Resource Request field (on the web interface).

  1. (Optional) Add a description.

  2. Edit the remaining fields or keep their default values.

    See Create or Edit a Resource for field definitions.

  3. Click OK when all fields are completed.

When you return to the Resources page, you will see the new resource in the table.

include:partial$stalled-cloud-agents-note.adoc[]

Editing Resources

For more information about resources and how to perform resource management tasks such as creating or deleting resources, see Working with Resources .

  1. On the Resources page, click the Edit Resource icon in the Actions column.

or

On the Resource Details page, click Edit Resource.

This opens an Edit Resource page with the fields populated with the information you used to create the resource.

You cannot edit the name of the default resource.
  1. Retype or reselect the information that you want to change.

See Resources - Create or Edit a Resource for field definitions.

  1. Click OK.

Deleting Resources

For more information about resources and how to perform resource management tasks such as creating or editing resources, see Working with Resources .

You cannot delete the default resource.

Deleting a Single Resource

On the Resources page, click the Delete Resource link in the Action column for the resource you want to delete.

On the Resource Details page, click (Delete Resource) to delete that displayed resource.

Deleting Multiple Resources

  1. On the Resources page, select the checkboxes in the first column for the resources you want to delete.

  2. Click Delete Resources.

Viewing Defined Resources

See Resources.

Viewing Resource Details