Distributed TensorFlow Training#

When you need to scale up model training using TensorFlow, you can use Strategy to distribute your training across multiple devices. There are various strategies available under this API and you can use any of them. In this example, we will use MirroredStrategy to train an MNIST model using a convolutional network.

MirroredStrategy supports synchronous distributed training on multiple GPUs on one machine. To learn more about distributed training with TensorFlow, refer to the Distributed training with TensorFlow in the TensorFlow documentation.

Let’s get started with an example!

First, we load the libraries.

import os

from flytekitplugins.kftensorflow import TfJob
from flytekit import task, workflow, Resources

import tensorflow_datasets as tfds
import tensorflow as tf
from typing import NamedTuple, Tuple
from flytekit.types.directory import FlyteDirectory
from dataclasses import dataclass
from dataclasses_json import dataclass_json

We define MODEL_FILE_PATH indicating where to store the model file.

MODEL_FILE_PATH = "saved_model/"

We initialize a data class to store the hyperparameters.

class Hyperparameters(object):
    batch_size_per_replica: int = 64
    buffer_size: int = 10000
    epochs: int = 10

Loading the Data#

We use the MNIST dataset to train our model.

def load_data(
    hyperparameters: Hyperparameters,
) -> Tuple[tf.data.Dataset, tf.data.Dataset, tf.distribute.Strategy]:
    datasets, _ = tfds.load(name="mnist", with_info=True, as_supervised=True)
    mnist_train, mnist_test = datasets["train"], datasets["test"]

    strategy = tf.distribute.MirroredStrategy()
    print("Number of devices: {}".format(strategy.num_replicas_in_sync))

    # strategy.num_replicas_in_sync returns the number of replicas; helpful to utilize the extra compute power by increasing the batch size
    BATCH_SIZE = hyperparameters.batch_size_per_replica * strategy.num_replicas_in_sync

    def scale(image, label):
        image = tf.cast(image, tf.float32)
        image /= 255

        return image, label

    # fetch train and evaluation datasets
    train_dataset = (
    eval_dataset = mnist_test.map(scale).batch(BATCH_SIZE)

    return train_dataset, eval_dataset, strategy

Compiling the Model#

We create and compile a model in the context of Strategy.scope.

def get_compiled_model(strategy: tf.distribute.Strategy) -> tf.keras.Model:
    with strategy.scope():
        model = tf.keras.Sequential(
                    32, 3, activation="relu", input_shape=(28, 28, 1)
                tf.keras.layers.Dense(64, activation="relu"),


    return model


We define a function for decaying the learning rate.

def decay(epoch: int):
    if epoch < 3:
        return 1e-3
    elif epoch >= 3 and epoch < 7:
        return 1e-4
        return 1e-5

Next, we define train_model to train the model with three callbacks:

def train_model(
    model: tf.keras.Model,
    train_dataset: tf.data.Dataset,
    hyperparameters: Hyperparameters,
) -> Tuple[tf.keras.Model, str]:
    # define the checkpoint directory to store the checkpoints
    checkpoint_dir = "./training_checkpoints"

    # define the name of the checkpoint files
    checkpoint_prefix = os.path.join(checkpoint_dir, "ckpt_{epoch}")

    # define a callback for printing the learning rate at the end of each epoch
    class PrintLR(tf.keras.callbacks.Callback):
        def on_epoch_end(self, epoch, logs=None):
                "\nLearning rate for epoch {} is {}".format(
                    epoch + 1, model.optimizer.lr.numpy()

    # put all the callbacks together
    callbacks = [
            filepath=checkpoint_prefix, save_weights_only=True

    # train the model
    model.fit(train_dataset, epochs=hyperparameters.epochs, callbacks=callbacks)

    # save the model
    model.save(MODEL_FILE_PATH, save_format="tf")

    return model, checkpoint_dir


We define test_model to evaluate loss and accuracy on the test dataset.

def test_model(
    model: tf.keras.Model, checkpoint_dir: str, eval_dataset: tf.data.Dataset
) -> Tuple[float, float]:

    eval_loss, eval_acc = model.evaluate(eval_dataset)

    return eval_loss, eval_acc

Defining an MNIST TensorFlow Task#

We initialize compute requirements and task output signature. Next, we define a mnist_tensorflow_job to kick off the training and evaluation process. The task is initialized with TFJob with certain values set:

  • num_workers: integer determining the number of worker replicas to be spawned in the cluster for this job

  • num_ps_replicas: number of parameter server replicas to use

  • num_chief_replicas: number of chief replicas to use

MirroredStrategy uses an all-reduce algorithm to communicate the variable updates across the devices. Hence, num_ps_replicas is not useful in our example.


If you’d like to understand the various Tensorflow strategies in distributed training, refer to the Types of strategies section in the TensorFlow documentation.

training_outputs = NamedTuple(
    "TrainingOutputs", accuracy=float, loss=float, model_state=FlyteDirectory

if os.getenv("SANDBOX") != "":
    resources = Resources(
        gpu="0", mem="1000Mi", storage="500Mi", ephemeral_storage="500Mi"
    resources = Resources(
        gpu="2", mem="10Gi", storage="10Gi", ephemeral_storage="500Mi"

    task_config=TfJob(num_workers=2, num_ps_replicas=1, num_chief_replicas=1),
def mnist_tensorflow_job(hyperparameters: Hyperparameters) -> training_outputs:
    train_dataset, eval_dataset, strategy = load_data(hyperparameters=hyperparameters)
    model = get_compiled_model(strategy=strategy)
    model, checkpoint_dir = train_model(
        model=model, train_dataset=train_dataset, hyperparameters=hyperparameters
    eval_loss, eval_accuracy = test_model(
        model=model, checkpoint_dir=checkpoint_dir, eval_dataset=eval_dataset
    return training_outputs(
        accuracy=eval_accuracy, loss=eval_loss, model_state=MODEL_FILE_PATH


Finally we define a workflow to call the mnist_tensorflow_job task.

def mnist_tensorflow_workflow(
    hyperparameters: Hyperparameters = Hyperparameters(),
) -> training_outputs:
    return mnist_tensorflow_job(hyperparameters=hyperparameters)

We can also run the code locally.

if __name__ == "__main__":

Total running time of the script: ( 0 minutes 0.000 seconds)

Gallery generated by Sphinx-Gallery