org.apache.flink.runtime.jobmaster.slotpool

接口 SlotPool

所有超级接口:

AllocatedSlotActions, AutoCloseable

所有已知实现类:

DeclarativeSlotPoolBridge

public interface SlotPool
extends AllocatedSlotActions, AutoCloseable

The Interface of a slot pool that manages slots.

方法概要

限定符和类型	方法和说明
Optional<PhysicalSlot>	allocateAvailableSlot(SlotRequestId slotRequestId, AllocationID allocationID, ResourceProfile requirementProfile) Allocates the available slot with the given allocation id under the given request id for the given requirement profile.
void	close()
void	connectToResourceManager(ResourceManagerGateway resourceManagerGateway) Connects the SlotPool to the given ResourceManager.
AllocatedSlotReport	createAllocatedSlotReport(ResourceID taskManagerId) Create report about the allocated slots belonging to the specified task manager.
void	disableBatchSlotRequestTimeoutCheck() Disables batch slot request timeout check.
void	disconnectResourceManager() Disconnects the slot pool from its current Resource Manager.
Collection<SlotInfo>	getAllocatedSlotsInformation() Returns a list of SlotInfo objects about all slots that are currently allocated in the slot pool.
Collection<SlotInfoWithUtilization>	getAvailableSlotsInformation() Returns a list of SlotInfoWithUtilization objects about all slots that are currently available in the slot pool.
Collection<SlotOffer>	offerSlots(TaskManagerLocation taskManagerLocation, TaskManagerGateway taskManagerGateway, Collection<SlotOffer> offers) Offers multiple slots to the SlotPool.
boolean	registerTaskManager(ResourceID resourceID) Registers a TaskExecutor with the given ResourceID at SlotPool.
boolean	releaseTaskManager(ResourceID resourceId, Exception cause) Releases a TaskExecutor with the given ResourceID from the SlotPool.
CompletableFuture<PhysicalSlot>	requestNewAllocatedBatchSlot(SlotRequestId slotRequestId, ResourceProfile resourceProfile) Requests the allocation of a new batch slot from the resource manager.
CompletableFuture<PhysicalSlot>	requestNewAllocatedSlot(SlotRequestId slotRequestId, ResourceProfile resourceProfile, org.apache.flink.api.common.time.Time timeout) Request the allocation of a new slot from the resource manager.
void	start(JobMasterId jobMasterId, String newJobManagerAddress, org.apache.flink.runtime.concurrent.ComponentMainThreadExecutor jmMainThreadScheduledExecutor)

从接口继承的方法 org.apache.flink.runtime.jobmaster.slotpool.AllocatedSlotActions

releaseSlot

方法详细资料

start

void start(JobMasterId jobMasterId,
           String newJobManagerAddress,
           org.apache.flink.runtime.concurrent.ComponentMainThreadExecutor jmMainThreadScheduledExecutor)
    throws Exception

抛出:

Exception

close

void close()

指定者:

close 在接口中 AutoCloseable

connectToResourceManager

void connectToResourceManager(ResourceManagerGateway resourceManagerGateway)

Connects the SlotPool to the given ResourceManager. After this method is called, the SlotPool will be able to request resources from the given ResourceManager.

参数:

resourceManagerGateway - The RPC gateway for the resource manager.

disconnectResourceManager

void disconnectResourceManager()

Disconnects the slot pool from its current Resource Manager. After this call, the pool will not be able to request further slots from the Resource Manager, and all currently pending requests to the resource manager will be canceled.

The slot pool will still be able to serve slots from its internal pool.

registerTaskManager

boolean registerTaskManager(ResourceID resourceID)

Registers a TaskExecutor with the given ResourceID at SlotPool.

参数:

resourceID - identifying the TaskExecutor to register

返回:

true iff a new resource id was registered

releaseTaskManager

boolean releaseTaskManager(ResourceID resourceId,
                           Exception cause)

Releases a TaskExecutor with the given ResourceID from the SlotPool.

参数:

resourceId - identifying the TaskExecutor which shall be released from the SlotPool

cause - for the releasing of the TaskManager

返回:

true iff a given registered resource id was removed

offerSlots

Collection<SlotOffer> offerSlots(TaskManagerLocation taskManagerLocation,
                                 TaskManagerGateway taskManagerGateway,
                                 Collection<SlotOffer> offers)

Offers multiple slots to the SlotPool. The slot offerings can be individually accepted or rejected by returning the collection of accepted slot offers.

参数:

taskManagerLocation - from which the slot offers originate

taskManagerGateway - to talk to the slot offerer

offers - slot offers which are offered to the SlotPool

返回:

A collection of accepted slot offers. The remaining slot offers are implicitly rejected.

getAvailableSlotsInformation

@Nonnull
Collection<SlotInfoWithUtilization> getAvailableSlotsInformation()

Returns a list of SlotInfoWithUtilization objects about all slots that are currently available in the slot pool.

返回:

a list of SlotInfoWithUtilization objects about all slots that are currently available in the slot pool.

getAllocatedSlotsInformation

Collection<SlotInfo> getAllocatedSlotsInformation()

Returns a list of SlotInfo objects about all slots that are currently allocated in the slot pool.

返回:

a list of SlotInfo objects about all slots that are currently allocated in the slot pool.

allocateAvailableSlot

Optional<PhysicalSlot> allocateAvailableSlot(@Nonnull
                                             SlotRequestId slotRequestId,
                                             @Nonnull
                                             AllocationID allocationID,
                                             @Nonnull
                                             ResourceProfile requirementProfile)

Allocates the available slot with the given allocation id under the given request id for the given requirement profile. The slot must be able to fulfill the requirement profile, otherwise an IllegalStateException will be thrown.

参数:

slotRequestId - identifying the requested slot

allocationID - the allocation id of the requested available slot

requirementProfile - resource profile of the requirement for which to allocate the slot

返回:

the previously available slot with the given allocation id, if a slot with this allocation id exists

requestNewAllocatedSlot

@Nonnull
CompletableFuture<PhysicalSlot> requestNewAllocatedSlot(@Nonnull
                                                                 SlotRequestId slotRequestId,
                                                                 @Nonnull
                                                                 ResourceProfile resourceProfile,
                                                                 @Nullable
                                                                 org.apache.flink.api.common.time.Time timeout)

Request the allocation of a new slot from the resource manager. This method will not return a slot from the already available slots from the pool, but instead will add a new slot to that pool that is immediately allocated and returned.

参数:

slotRequestId - identifying the requested slot

resourceProfile - resource profile that specifies the resource requirements for the requested slot

timeout - timeout for the allocation procedure

返回:

a newly allocated slot that was previously not available.

requestNewAllocatedBatchSlot

@Nonnull
CompletableFuture<PhysicalSlot> requestNewAllocatedBatchSlot(@Nonnull
                                                                      SlotRequestId slotRequestId,
                                                                      @Nonnull
                                                                      ResourceProfile resourceProfile)

Requests the allocation of a new batch slot from the resource manager. Unlike the normal slot, a batch slot will only time out if the slot pool does not contain a suitable slot. Moreover, it won't react to failure signals from the resource manager.

参数:

slotRequestId - identifying the requested slot

resourceProfile - resource profile that specifies the resource requirements for the requested batch slot

返回:

a future which is completed with newly allocated batch slot

disableBatchSlotRequestTimeoutCheck

void disableBatchSlotRequestTimeoutCheck()

Disables batch slot request timeout check. Invoked when someone else wants to take over the timeout check responsibility.

createAllocatedSlotReport

AllocatedSlotReport createAllocatedSlotReport(ResourceID taskManagerId)

Create report about the allocated slots belonging to the specified task manager.

参数:

taskManagerId - identifies the task manager

返回:

the allocated slots on the task manager