Creating Resources

2 minute read

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 Azure Services Platform, Amazon EC2, Google Cloud Platform, or Kubernetes containers in advance. For details, see the CloudBees Accelerator Installation Guide and the CloudBees Accelerator Configuration Guide.

  1. On the Resources page, click New Resource.

    This opens an empty resource details page.

  2. 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’ Resource Request field (on the web interface).

  3. (Optional) Add a description.

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

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

  5. Click OK when all fields are completed.

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

If agents on Amazon EC2 do not connect to the Cluster Manager after an instance runs for four minutes, they are considered to be stalled. Upon a subsequent agent request, if the instance is stalled for the resource, the instance is terminated, and the agent request returns an error (which kills the build). If you kill a build manually, the instance is also terminated once it is recognized as stalled.