Package org.apache.hadoop.yarn.server.nodemanager.containermanager.linux.resources

Interface ResourceHandler

All Known Subinterfaces:

CpuResourceHandler, DiskResourceHandler, MemoryResourceHandler, OutboundBandwidthResourceHandler

All Known Implementing Classes:

CGroupsBlkioResourceHandlerImpl, CGroupsCpuResourceHandlerImpl, CGroupsMemoryResourceHandlerImpl, DeviceResourceHandlerImpl, FpgaResourceHandlerImpl, GpuResourceHandlerImpl, NetworkPacketTaggingHandlerImpl, NumaResourceHandlerImpl, ResourceHandlerChain, TrafficControlBandwidthHandlerImpl

@Private
@Unstable
public interface ResourceHandler

Handler interface for resource subsystems' isolation and enforcement. e.g cpu, memory, network, disks etc

Method Summary

Modifier and Type	Method	Description
java.util.List<PrivilegedOperation>	bootstrap(org.apache.hadoop.conf.Configuration configuration)	Bootstrap resource susbsystem.
java.util.List<PrivilegedOperation>	postComplete(org.apache.hadoop.yarn.api.records.ContainerId containerId)	Perform any tasks necessary after container completion.
java.util.List<PrivilegedOperation>	preStart(Container container)	Prepare a resource environment for container launch
java.util.List<PrivilegedOperation>	reacquireContainer(org.apache.hadoop.yarn.api.records.ContainerId containerId)	Require state for container that was already launched
java.util.List<PrivilegedOperation>	teardown()	Teardown environment for resource subsystem if requested.
java.util.List<PrivilegedOperation>	updateContainer(Container container)	Update state for container that was already launched

Method Detail

bootstrap

java.util.List<PrivilegedOperation> bootstrap(org.apache.hadoop.conf.Configuration configuration)
                                       throws ResourceHandlerException

Bootstrap resource susbsystem.

Returns:

(possibly empty) list of operations that require elevated privileges

Throws:

ResourceHandlerException

preStart

java.util.List<PrivilegedOperation> preStart(Container container)
                                      throws ResourceHandlerException

Prepare a resource environment for container launch

Parameters:

container - Container being launched

Returns:

(possibly empty) list of operations that require elevated privileges e.g a) create a custom cgroup b) add pid for container to tasks file for a cgroup.

Throws:

ResourceHandlerException

reacquireContainer

java.util.List<PrivilegedOperation> reacquireContainer(org.apache.hadoop.yarn.api.records.ContainerId containerId)
                                                throws ResourceHandlerException

Require state for container that was already launched

Parameters:

containerId - id of the container being reacquired.

Returns:

(possibly empty) list of operations that require elevated privileges

Throws:

ResourceHandlerException

updateContainer

java.util.List<PrivilegedOperation> updateContainer(Container container)
                                             throws ResourceHandlerException

Update state for container that was already launched

Parameters:

container - the container being updated.

Returns:

(possibly empty) list of operations that require elevated privileges

Throws:

ResourceHandlerException

postComplete

java.util.List<PrivilegedOperation> postComplete(org.apache.hadoop.yarn.api.records.ContainerId containerId)
                                          throws ResourceHandlerException

Perform any tasks necessary after container completion.

Parameters:

containerId - of the container that was completed.

Returns:

(possibly empty) list of operations that require elevated privileges

Throws:

ResourceHandlerException

teardown

java.util.List<PrivilegedOperation> teardown()
                                      throws ResourceHandlerException

Teardown environment for resource subsystem if requested. This method needs to be used with care since it could impact running containers.

Returns:

(possibly empty) list of operations that require elevated privileges

Throws:

ResourceHandlerException