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

Class NetworkPacketTaggingHandlerImpl

java.lang.Object

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

All Implemented Interfaces:

ResourceHandler

@Private
@Unstable
public class NetworkPacketTaggingHandlerImpl
extends java.lang.Object
implements ResourceHandler

The network packet tagging handler implementation.

Constructor Summary

Constructors

Constructor	Description
NetworkPacketTaggingHandlerImpl(PrivilegedOperationExecutor privilegedOperationExecutor, CGroupsHandler cGroupsHandler)

Method Summary

Modifier and Type	Method	Description
java.util.List<PrivilegedOperation>	bootstrap(org.apache.hadoop.conf.Configuration configuration)	Bootstrapping network-tagging-handler - mounts net_cls controller.
NetworkTagMappingManager	createNetworkTagMappingManager(org.apache.hadoop.conf.Configuration conf)
java.util.List<PrivilegedOperation>	postComplete(org.apache.hadoop.yarn.api.records.ContainerId containerId)	Cleanup operation once container is completed - deletes cgroup.
java.util.List<PrivilegedOperation>	preStart(Container container)	Pre-start hook for network-tagging-handler.
java.util.List<PrivilegedOperation>	reacquireContainer(org.apache.hadoop.yarn.api.records.ContainerId containerId)	Reacquires state for a container - reads the classid from the cgroup being used for the container being reacquired.
java.util.List<PrivilegedOperation>	teardown()	Teardown environment for resource subsystem if requested.
java.lang.String	toString()
java.util.List<PrivilegedOperation>	updateContainer(Container container)	Update state for container that was already launched

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Detail

NetworkPacketTaggingHandlerImpl

public NetworkPacketTaggingHandlerImpl(PrivilegedOperationExecutor privilegedOperationExecutor,
                                       CGroupsHandler cGroupsHandler)

Method Detail

bootstrap

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

Bootstrapping network-tagging-handler - mounts net_cls controller.

Specified by:

bootstrap in interface ResourceHandler

Parameters:

configuration - yarn configuration in use

Returns:

(potentially empty) list of privileged operations to execute.

Throws:

ResourceHandlerException

preStart

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

Pre-start hook for network-tagging-handler. A cgroup is created and a net_cls classid is generated and written to a cgroup file.

Specified by:

preStart in interface ResourceHandler

Parameters:

container - Container being launched

Returns:

privileged operations for some cgroups operations.

Throws:

ResourceHandlerException

reacquireContainer

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

Reacquires state for a container - reads the classid from the cgroup being used for the container being reacquired.

Specified by:

reacquireContainer in interface ResourceHandler

Parameters:

containerId - if of the container being reacquired.

Returns:

(potentially empty) list of privileged operations

Throws:

ResourceHandlerException

updateContainer

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

Description copied from interface: ResourceHandler

Update state for container that was already launched

Specified by:

updateContainer in interface ResourceHandler

Parameters:

container - the container being updated.

Returns:

(possibly empty) list of operations that require elevated privileges

Throws:

ResourceHandlerException

postComplete

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

Cleanup operation once container is completed - deletes cgroup.

Specified by:

postComplete in interface ResourceHandler

Parameters:

containerId - of the container that was completed.

Returns:

a list of PrivilegedOperations.

Throws:

ResourceHandlerException

teardown

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

Description copied from interface: ResourceHandler

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

Specified by:

teardown in interface ResourceHandler

Returns:

(possibly empty) list of operations that require elevated privileges

Throws:

ResourceHandlerException

createNetworkTagMappingManager

@Private
@VisibleForTesting
public NetworkTagMappingManager createNetworkTagMappingManager(org.apache.hadoop.conf.Configuration conf)

toString

public java.lang.String toString()

Overrides:

toString in class java.lang.Object