package peloton.private.hostmgr.v1alpha.hostmgr

Get desktop application:
View/edit binary Protocol Buffers messages

FilterHint includes hints provided to host manager to decide which hosts to return for filtering hosts. The hint is provided as an optimization and host manager can ignore them if hint cannot be satisfied.

Used in: HostFilter

• repeated FilterHint.Host host_hint = 1

Hint for which host to return.

Used in: FilterHint

• string hostname = 1

  Return the host if it satisfies constraints.

• optional api.v1alpha.peloton.PodID pod_id = 2

  Indicates for which pod the host is for.

HostFilter can be used to control whether a given host should be returned to placement engine to use.

Used in: svc.AcquireHostsRequest

• optional ResourceConstraint resource_constraint = 1

  Resource constraint which must be satisfied.

• optional api.v1alpha.pod.Constraint scheduling_constraint = 2

  Attribute based affinity/anti-affinity scheduling constraints. Only constraint with kind == HOST will be considered.

• uint32 max_hosts = 3

  Optional maximum number of hosts to return. Default zero value is no-op.

• optional FilterHint hint = 4

  Provides hint to about which hosts should return, host manager may ignore the hint.

HostFilterResult describes result of filtering hosts.

• HOST_FILTER_INVALID = 0

  Filter is invalid.

• HOST_FILTER_MATCH = 1

  Host is matched by filter and returned in HostLease.

• HOST_FILTER_INSUFFICIENT_RESOURCES = 2

  Host has enough total resources but offered resources is insufficient (signal for fragmentation).

• HOST_FILTER_MISMATCH_CONSTRAINTS = 3

  Host is filtered out because of mismatched pod -> host constraint.

• HOST_FILTER_MISMATCH_GPU = 4

  Host has GPU so reserved for GPU only pod.

• HOST_FILTER_MISMATCH_STATUS = 5

  Host is in mismatch status (i.e, another placement engine) has a hold of the host.

• HOST_FILTER_MISMATCH_MAX_HOST_LIMIT = 6

  Host is filtered out because maxHosts limit is reached.

The structure holding lease_id and corresponding host_summary.

Used in: svc.AcquireHostsResponse

• optional api.v1alpha.host.HostSummary host_summary = 1

  Summary of available host resources and metadata.

• optional LeaseID lease_id = 2

  The lease_id assigned to this host after it is locked for placement.

LaunchablePod describes the pod to be launched by host manager. It includes PodID and PodSpec.

Used in: svc.LaunchPodsRequest

• optional api.v1alpha.peloton.PodID pod_id = 1

  PodID for the pod to be launched.

• optional api.v1alpha.pod.PodSpec spec = 2

  PodSpec for the pod to be launched.

• map<string, uint32> ports = 3

  Ports allocated to this pod.

A unique lease ID created when a host is locked for placement.

Used in: HostLease, svc.LaunchPodsRequest, svc.TerminateLeasesRequest.LeasePair

• string value = 1

Resource allocation for a resource to be consumed by resmgr.

Used in: svc.ClusterCapacityResponse, svc.GetHostCacheResponse.Summary

• string kind = 1

  Type of the resource.

• double capacity = 2

  capacity of the resource.

ResourceConstraint describes a condition for which aggregated resources from a host must meet in order for it to be returned in `AcquireHosts`.

Minimum amount of resources. NOTE: gpu resources are specially protected in the following way: - if `gpuLimit` is specified, only hosts with enough gpu resources are returned. - if `gpuLimit` is not specified, only hosts without gpu resource will be returned.

Used in: HostFilter

• optional api.v1alpha.pod.ResourceSpec minimum = 1

• uint32 num_ports = 2

  Number of dynamic ports available.