|TensorFlow 1 version||View source on GitHub|
ClusterResolver for Kubernetes.
Compat aliases for migration
See Migration guide for more details.
tf.distribute.cluster_resolver.KubernetesClusterResolver( job_to_label_mapping=None, tf_server_port=8470, rpc_layer='grpc', override_client=None )
This is an implementation of cluster resolvers for Kubernetes. When given the the Kubernetes namespace and label selector for pods, we will retrieve the pod IP addresses of all running pods matching the selector, and return a ClusterSpec based on that information.
A mapping of TensorFlow jobs to label selectors.
This allows users to specify many TensorFlow jobs in one Cluster
Resolver, and each job can have pods belong with different label
selectors. For example, a sample mapping might be
||The port the TensorFlow server is listening on.|
||(Optional) The RPC layer TensorFlow should use to communicate between tasks in Kubernetes. Defaults to 'grpc'.|
The Kubernetes client (usually automatically retrieved
If the Kubernetes Python client is not installed and no
||If autoresolve_task is not a boolean or a callable.|
Returns the current environment which TensorFlow is running in.
There are two possible return values, "google" (when TensorFlow is running in a Google-internal environment) or an empty string (when TensorFlow is running elsewhere).
If you are implementing a ClusterResolver that works in both the Google environment and the open-source world (for instance, a TPU ClusterResolver or similar), you will have to return the appropriate string depending on the environment, which you will have to detect.
Otherwise, if you are implementing a ClusterResolver that will only work in open-source TensorFlow, you do not need to implement this property.
Returns a ClusterSpec object based on the latest info from Kubernetes.
We retrieve the information from the Kubernetes master every time this method is called.
|A ClusterSpec containing host information returned from Kubernetes.|
If any of the pods returned by the master is not in the
master( task_type=None, task_id=None, rpc_layer=None )
Returns the master address to use when creating a session.
You must have set the task_type and task_id object properties before
calling this function, or pass in the
parameters when using this function. If you do both, the function parameters
will override the object properties.
||(Optional) The type of the TensorFlow task of the master.|
||(Optional) The index of the TensorFlow task of the master.|
||(Optional) The RPC protocol for the given cluster.|
|The name or URL of the session master.|
num_accelerators( task_type=None, task_id=None, config_proto=None )
Returns the number of accelerator cores per worker.
This returns the number of accelerator cores (such as GPUs and TPUs) available per worker.
Optionally, we allow callers to specify the task_type, and task_id, for if they want to target a specific TensorFlow process to query the number of accelerators. This is to support heterogenous environments, where the number of accelerators cores per host is different.
||(Optional) The type of the TensorFlow task of the machine we want to query.|
||(Optional) The index of the TensorFlow task of the machine we want to query.|
||(Optional) Configuration for starting a new session to query how many accelerator cores it has.|
|A map of accelerator types to number of cores.|