# Constants
This expresses the ability for the agent to automatically drain tasks in preparation for operator maintenance.
This expresses the ability of the agent to handle operation feedback for operations on agent default resources.
This expresses the ability for the agent to be able to launch tasks, reserve resources, and create volumes using resources allocated to a 'hierarchical-role'.
This expresses the ability for the agent to be able to launch tasks of a 'multi-role' framework.
This capability has three effects for an agent.
This expresses the capability for the agent to handle persistent volume resize operations safely.
This expresses the ability for the agent to handle resource provider related operations.
This expresses the ability for the agent to launch tasks which specify resource limits for CPU and/or memory.
This must be the first enum value in this list, to ensure that if 'type' is not set, the default value is UNKNOWN.
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
See 'Accept' below.
See 'AcceptInverseOffers' below.
See 'Acknowledge' below.
See message below.
See 'Decline' below.
See 'DeclineInverseOffers' below.
See 'Kill' below.
See 'Message' below.
See 'Reconcile' below.
See 'ReconcileOperations' below.
See 'Request' below.
Removes any previous filters set via ACCEPT or DECLINE.
See 'Shutdown' below.
See 'Subscribe' below.
Inform master to stop sending offers to the framework.
Shuts down all tasks/executors and removes framework.
See comments above on `Event::Type` for more details on this enum value.
See 'UpdateFramework' below.
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
Default values for AgentInfo fields.
Default values for CheckInfo fields.
Default values for CheckInfo fields.
Default values for CheckInfo fields.
Default values for CommandInfo fields.
Default values for CommandInfo_URI fields.
Default values for ContainerInfo_DockerInfo fields.
Default values for ContainerInfo_DockerInfo fields.
Default values for CSIPluginInfo fields.
Default values for DrainConfig fields.
Default values for Environment_Variable fields.
Default values for Filters fields.
Default values for FrameworkInfo fields.
Default values for FrameworkInfo fields.
Default values for FrameworkInfo fields.
Default values for HealthCheck fields.
Default values for HealthCheck fields.
Default values for HealthCheck fields.
Default values for HealthCheck_HTTPCheckInfo fields.
Default values for HealthCheck fields.
Default values for HealthCheck_TCPCheckInfo fields.
Default values for HealthCheck fields.
Default values for Image fields.
Default values for LinuxInfo fields.
Default values for MasterInfo fields.
Default values for NetworkInfo_IPAddress fields.
Default values for Resource fields.
No description provided by the author
No description provided by the author
No description provided by the author
The agent has been drained: all tasks have terminated, all terminal task status updates have been acknowledged by the frameworks, and all operations have finished and had their terminal updates acknowledged.
The agent is currently draining.
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
See 'Error' below.
See 'Failure' below.
Periodic message sent by the Mesos master according to 'Subscribed.heartbeat_interval_seconds'.
See 'InverseOffers' below.
See 'Message' below.
See 'Offers' below.
See 'Rescind' below.
See 'RescindInverseOffer' below.
See 'Subscribed' below.
This must be the first enum value in this list, to ensure that if 'type' is not set, the default value is UNKNOWN.
See 'Update' below.
See 'UpdateOperationStatus' below.
For frameworks that need custom functionality to run tasks, a `CUSTOM` executor can be used.
Mesos provides a simple built-in default executor that frameworks can leverage to run shell commands and containers.
No description provided by the author
Indicates whether the framework is aware of GPU resources.
This expresses the ability for the framework to be "multi-tenant" via using the newly introduced `roles` field, and examining `Offer.allocation_info` to determine which role the offers are being made to.
Indicates that (1) the framework is prepared to handle the following TaskStates: TASK_UNREACHABLE, TASK_DROPPED, TASK_GONE, TASK_GONE_BY_OPERATOR, and TASK_UNKNOWN, and (2) the framework will assume responsibility for managing partitioned tasks that reregister with the master.
Indicates that the framework is prepared to receive offers for agents whose region is different from the master's region.
EXPERIMENTAL.
Receive offers with revocable resources.
Receive offers with resources that are shared.
Receive the TASK_KILLING TaskState when a task is being killed by an executor.
This must be the first enum value in this list, to ensure that if 'type' is not set, the default value is UNKNOWN.
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
The container will have its own IPC namespace and /dev/shm, with a possibility to share them with its child containers.
The container will share the IPC namespace and /dev/shm from its parent.
No description provided by the author
In this mode, a machine is not running any tasks and will not offer any of its resources.
In this mode, all agents on the machine are expected to cooperate with frameworks to drain resources.
In this mode, a machine is behaving normally; offering resources, executing tasks, etc.
The master can drain or deactivate agents when requested via operator APIs.
The master can handle slaves whose state changes after reregistering.
The master can handle the new quota API, which supports setting limits separately from guarantees (introduced in Mesos 1.9).
No description provided by the author
The volume in a container will receive new mounts from the host or other containers, and its own mounts will be propagated from the container to the host or other containers.
The volume in a container will receive new mounts from the host or other containers, but filesystems mounted inside the container won't be propagated to the host or other containers.
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
EXPERIMENTAL.
No description provided by the author
EXPERIMENTAL.
EXPERIMENTAL.
No description provided by the author
No description provided by the author
No description provided by the author
EXPERIMENTAL.
No description provided by the author
No description provided by the author
TERMINAL: The operation was dropped due to a transient error.
TERMINAL: The operation description contains an error.
TERMINAL: The operation failed to apply.
TERMINAL: The operation was successfully applied.
The operation affected an agent that the master cannot contact; the operator has asserted that the agent has been shutdown, but this has not been directly confirmed by the master.
Initial state.
The operation affects an agent that the master recovered from its state, but that agent has not yet re-registered.
The master has no knowledge of the operation.
The operation affects an agent that has lost contact with the master, typically due to a network failure or partition.
Default value if the enum is not set.
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
DEPRECATED.
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
TERMINAL.
TERMINAL: The task description contains an error.
TERMINAL: The task failed to finish successfully.
TERMINAL.
TERMINAL.
The task was running on an agent that the master cannot contact; the operator has asserted that the agent has been shutdown, but this has not been directly confirmed by the master.
TERMINAL: The task was killed by the executor.
The task is being killed by the executor.
The task failed but can be rescheduled.
No description provided by the author
Initial state.
The task is being launched by the executor.
The master has no knowledge of the task.
The task was running on an agent that has lost contact with the master, typically due to a network failure or partition.
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
TODO(jieyu): The default value when a caller doesn't check for presence is 0 and so ideally the 0 reason is not a valid one.
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No longer used.
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
read-only.
read-write.
No description provided by the author
Can be published as read/write at multiple nodes simultaneously.
Can be published as readonly at multiple nodes simultaneously.
Can be published at multiple nodes simultaneously.
Can only be published once as readonly on a single node, at any given time.
Can only be published once as read/write on a single node, at any given time.
No description provided by the author
TODO(gyliu513): Add IMAGE as volume source type.
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
This must be the first enum value in this list, to ensure that if 'type' is not set, the default value is UNKNOWN.
# Variables
Enum value maps for AgentInfo_Capability_Type.
Enum value maps for AgentInfo_Capability_Type.
Enum value maps for AttributeConstraint_Selector_PseudoattributeType.
Enum value maps for AttributeConstraint_Selector_PseudoattributeType.
Enum value maps for Call_Type.
Enum value maps for Call_Type.
Enum value maps for CapabilityInfo_Capability.
Enum value maps for CapabilityInfo_Capability.
Enum value maps for CgroupInfo_Blkio_Operation.
Enum value maps for CgroupInfo_Blkio_Operation.
Enum value maps for CheckInfo_Type.
Enum value maps for CheckInfo_Type.
Enum value maps for ContainerInfo_DockerInfo_Network.
Enum value maps for ContainerInfo_DockerInfo_Network.
Enum value maps for ContainerInfo_Type.
Enum value maps for ContainerInfo_Type.
Enum value maps for CSIPluginContainerInfo_Service.
Enum value maps for CSIPluginContainerInfo_Service.
Enum value maps for DiscoveryInfo_Visibility.
Enum value maps for DiscoveryInfo_Visibility.
Enum value maps for DrainState.
Enum value maps for DrainState.
Enum value maps for Environment_Variable_Type.
Enum value maps for Environment_Variable_Type.
Enum value maps for Event_Type.
Enum value maps for Event_Type.
Enum value maps for ExecutorInfo_Type.
Enum value maps for ExecutorInfo_Type.
No description provided by the author
No description provided by the author
Enum value maps for FrameworkInfo_Capability_Type.
Enum value maps for FrameworkInfo_Capability_Type.
Enum value maps for HealthCheck_Type.
Enum value maps for HealthCheck_Type.
Enum value maps for Image_Type.
Enum value maps for Image_Type.
Enum value maps for LinuxInfo_IpcMode.
Enum value maps for LinuxInfo_IpcMode.
Enum value maps for MachineInfo_Mode.
Enum value maps for MachineInfo_Mode.
Enum value maps for MasterInfo_Capability_Type.
Enum value maps for MasterInfo_Capability_Type.
Enum value maps for MountPropagation_Mode.
Enum value maps for MountPropagation_Mode.
Enum value maps for NetworkInfo_Protocol.
Enum value maps for NetworkInfo_Protocol.
Enum value maps for Offer_Operation_Type.
Enum value maps for Offer_Operation_Type.
Enum value maps for OperationState.
Enum value maps for OperationState.
Enum value maps for Resource_DiskInfo_Source_Type.
Enum value maps for Resource_DiskInfo_Source_Type.
Enum value maps for Resource_ReservationInfo_Type.
Enum value maps for Resource_ReservationInfo_Type.
Enum value maps for Response_Type.
Enum value maps for Response_Type.
Enum value maps for RLimitInfo_RLimit_Type.
Enum value maps for RLimitInfo_RLimit_Type.
Enum value maps for Secret_Type.
Enum value maps for Secret_Type.
Enum value maps for Status.
Enum value maps for Status.
Enum value maps for TaskState.
Enum value maps for TaskState.
Enum value maps for TaskStatus_Reason.
Enum value maps for TaskStatus_Reason.
Enum value maps for TaskStatus_Source.
Enum value maps for TaskStatus_Source.
Enum value maps for Value_Type.
Enum value maps for Value_Type.
Enum value maps for Volume_Mode.
Enum value maps for Volume_Mode.
Enum value maps for Volume_Source_CSIVolume_VolumeCapability_AccessMode_Mode.
Enum value maps for Volume_Source_CSIVolume_VolumeCapability_AccessMode_Mode.
Enum value maps for Volume_Source_SandboxPath_Type.
Enum value maps for Volume_Source_SandboxPath_Type.
Enum value maps for Volume_Source_Type.
Enum value maps for Volume_Source_Type.
# Structs
* A network address.
* A unique ID assigned to an agent.
* Describes an agent.
No description provided by the author
* EXPERIMENTAL.
* Describes an attribute that can be set on a machine.
An attribute constraint consists of a Predicate: a boolean function of an attribute or an attribute-like property of an agent (a pseudoattribute), and a Selector: a rule for obtaining this (pseudo)attribute value from AgentInfo.
No description provided by the author
Yields `true` if the (pseudo)attribute exists.
No description provided by the author
Yields `true` if the (pseudo)attribute does not exist.
No description provided by the author
Yields `true` if the (pseudo)attribute exists and is a string/TEXT equal to the specified `value`.
No description provided by the author
Yields `true` if the (pseudo)attribute exists and is a TEXT/string matching the specified regex.
No description provided by the author
Yields `true` if the (pseudo)attribute does not exist or is a string/TEXT NOT equal to the specified `value`.
No description provided by the author
Yields `true` if the (pseudo)attribute either does not exists or is not a TEXT/string matching the specified regex.
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
* Scheduler call API.
Accepts an offer, performing the specified operations in a sequential manner.
Accepts an inverse offer.
Acknowledges the receipt of status update.
EXPERIMENTAL.
Declines an offer, signaling the master to potentially reoffer the resources to a different framework.
Declines an inverse offer.
Kills a specific task.
Sends arbitrary binary data to the executor.
Allows the scheduler to query the status for non-terminal tasks.
TODO(vinod): Support arbitrary queries than just state of tasks.
EXPERIMENTAL.
No description provided by the author
Requests a specific set of resources from Mesos's allocator.
Revive offers for the specified roles.
Shuts down a custom executor.
Subscribes the scheduler with the master to receive events.
Suppress offers for the specified roles.
Updates the FrameworkInfo.
* Encapsulation of `Capabilities` supported by Linux.
* Linux control group (cgroup) information.
Configuration of a blkio cgroup subsystem.
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
Describes a stat value without the device descriptor part.
Configuration of a net_cls cgroup subsystem.
* Describes a general non-interpreting non-killing check for a task or executor (or any arbitrary process/command).
Describes a command check.
Describes an HTTP check.
Describes a TCP check, i.e.
* Describes the status of a check.
No description provided by the author
No description provided by the author
No description provided by the author
* Describes a command, executed via: '/bin/sh -c value'.
No description provided by the author
* ID used to uniquely identify a container.
* Describes a container configuration and allows extensible configurations for different container implementations.
No description provided by the author
No description provided by the author
No description provided by the author
* Container related information that is resolved during container setup.
* Credential used in various places for authentication and authorization.
* Credentials used for framework authentication, HTTP authentication (where the common 'username' and 'password' are captured as 'principal' and 'secret' respectively), etc.
* Describes the container configuration to run a managed CSI plugin.
* Describes the endpoint of an unmanaged CSI plugin service.
* Describes a CSI plugin.
* Describes information about a device.
No description provided by the author
* Describes a device whitelist entry that expose from host to container.
No description provided by the author
No description provided by the author
* Service discovery information.
No description provided by the author
* Describes a domain.
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
* Represents duration in nanoseconds.
* Describes a collection of environment variables.
No description provided by the author
* Scheduler event API.
Received when there is an unrecoverable error in the scheduler (e.g., scheduler failed over, rate limiting, authorization errors etc.).
Received when an agent is removed from the cluster (e.g., failed health checks) or when an executor is terminated.
Received whenever there are resources requested back from the scheduler.
Received when a custom message generated by the executor is forwarded by the master.
Received whenever there are new resources that are offered to the scheduler.
Received when a particular offer is no longer valid (e.g., the agent corresponding to the offer has been removed) and hence needs to be rescinded.
Received when a particular inverse offer is no longer valid (e.g., the agent corresponding to the offer has been removed) and hence needs to be rescinded.
First event received when the scheduler subscribes.
Received whenever there is a status update that is generated by the executor or agent or master.
EXPERIMENTAL.
* A framework-generated ID to distinguish an executor.
* Describes information about an executor.
* Describes a File.
* Describes possible filters that can be applied to unused resources (see SchedulerDriver::launchTasks) to influence the allocator.
* Flag consists of a name and optionally its value.
* A unique ID assigned to a framework.
* Describes a framework.
No description provided by the author
* Describes a health check for a task or executor (or any arbitrary process/command).
Describes an HTTP health check.
Describes a TCP health check, i.e.
No description provided by the author
* Describe an image used by tasks or executors.
Protobuf for specifying an Appc container image.
No description provided by the author
* A request to return some resources occupied by a framework.
No description provided by the author
* Describes a kill policy for a task.
* Key, value pair used to store free form user-data.
* Collection of labels.
* Encapsulation for Linux specific configuration.
* Represents a single machine, which may hold one or more agents.
* Holds information about a single machine, its `mode`, and any other relevant information which may affect the behavior of the machine.
* Describes a master.
No description provided by the author
* Metric consists of a name and optionally its value.
* Describes how the mount will be propagated for a volume.
* Describes a network request from a framework as well as network resolution provided by Mesos.
Specifies a request for an IP address, or reports the assigned container IP address.
Specifies a port mapping request for the task on this network.
* Describes some resources available on an agent.
Defines an operation that can be performed against offers.
No description provided by the author
Create a `MOUNT` or `BLOCK` disk resource backed by a CSI volume from a `RAW` disk resource.
No description provided by the author
Destroy a disk resource backed by a CSI volume.
Grow a volume by an additional disk resource.
TODO(vinod): Deprecate this in favor of `LaunchGroup` below.
Unlike `Launch` above, all the tasks in a `task_group` are atomically delivered to an executor.
No description provided by the author
Shrink a volume by the size specified in the `subtract` field.
No description provided by the author
Frameworks can express offer constraints for their roles.
No description provided by the author
No description provided by the author
* Represents filters that allow a framework to control the shape of offers that will be sent to its role(s).
No description provided by the author
No description provided by the author
* A unique ID assigned to an offer.
* Describes an operation, similar to `Offer.Operation`, with some additional information.
* A framework-generated ID to distinguish an operation.
* Describes the current status of an operation.
* A generic (key, value) pair used in various places for parameters.
* Collection of Parameter.
* Describes a sample of events from "perf stat".
* Named port used for service discovery.
* Collection of ports.
* Rate (queries per second, QPS) limit for messages from a framework to master.
* Collection of RateLimit.
* Describes a request for resources that can be used by a framework to proactively influence the allocator.
* Describes a resource from a resource provider.
This was initially introduced to support MULTI_ROLE capable frameworks.
No description provided by the author
Describes a persistent disk volume.
Describes where a disk originates from.
A mounted file-system set up by the Agent administrator.
A folder that can be located on a separate disk device.
No description provided by the author
No description provided by the author
Allow the resource to be shared across tasks.
* A unique ID assigned to a resource provider.
* Describes a resource provider.
Storage resource provider related information.
* A snapshot of resource usage statistics.
No description provided by the author
Network rate statistics measured in bytes per second or packets per second.
* Describes a snapshot of the resource usage for executors.
No description provided by the author
No description provided by the author
* NOTE: After resolution of MESOS-9648, this message is not currently used by Mesos.
DEPRECATED.
* Encapsulation for POSIX rlimits, see http://pubs.opengroup.org/onlinepubs/009695399/functions/getrlimit.html.
No description provided by the author
* Describes a Role.
* Encapsulation for Seccomp configuration, which is Linux specific.
* Secret used to pass privileged information.
Can be used by modules to refer to a secret stored in a secure back-end.
Used to pass the value of a secret.
No description provided by the author
* Describes a task, similar to `TaskInfo`.
* Describes a group of tasks that belong to an executor.
* A framework-generated ID to distinguish a task.
* Describes a task.
* Describes a resource limitation that caused a task failure.
* Describes the current status of a task.
No description provided by the author
* Represents time since the epoch, in nanoseconds.
* When the network bandwidth caps are enabled and the container is over its limit, outbound packets may be either delayed or dropped completely either because it exceeds the maximum bandwidth allocation for a single container (the cap) or because the combined network traffic of multiple containers on the host exceeds the transmit capacity of the host (the share).
* Describes the information about (pseudo) TTY that can be attached to a process running in a container.
No description provided by the author
No description provided by the author
* Represents an interval, from a given start time over a given duration.
* Represents a URL.
* A 128 bit (16 byte) UUID, see RFC 4122.
* Describes an Attribute or Resource "value".
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
* Version information of a component.
* Describes a volume mapping either from host to container or vice versa.
Describes where a volume originates from.
A volume which will be handled by the `volume/csi` isolator.
Specifies the parameters used to stage/publish a pre-provisioned volume on an agent host.
Specifies a capability of a volume.
Specifies how a volume can be accessed.
No description provided by the author
Indicates that the volume will be accessed via the block device API.
No description provided by the author
Indicates that the volume will be accessed via the filesystem API.
No description provided by the author
Absolute path pointing to a directory or file on the host.
Describe a path from a container's sandbox.
* Named WeightInfo to indicate resource allocation priority between the different roles.
# Type aliases
No description provided by the author
No description provided by the author
Possible call types, followed by message definitions if applicable.
We start the actual values at an offset(1000) because Protobuf 2 uses the first value as the default one.
No description provided by the author
No description provided by the author
Network options.
All container implementation types.
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
Possible event types, followed by message definitions if applicable.
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
Describes the several states that a machine can be in.
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
* Describes possible operation states.
No description provided by the author
No description provided by the author
Each of the responses of type `FOO` corresponds to `Foo` message below.
No description provided by the author
No description provided by the author
* Status is used to indicate the state of the scheduler and executor driver after function calls.
* Describes possible task states.
Detailed reason for the task status update.
Describes the source of the task status update.
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author