Here are some useful tips and tricks related to running Metaflow on Kubernetes. See our engineering resources for additional information about setting up and operating Kubernetes for Metaflow.
What value of
@timeout should I set?
Metaflow sets a default timeout of 5 days so that you tasks don't get stuck infinitely
while running on Kubernetes. For more details on how to use
@timeout please read
@resources can I request?
Here are the current defaults for different resource types:
memory: 4096 (4GB)
disk: 10240 (10GB)
@resources, keep in mind the configuration of your Kubernetes cluster.
Your pod will be stuck in an unschedulable state if Kubernetes is unable to provision
the requested resources. Additionally, as a good measure, don't request more resources
than what your workflow actually needs. On the other hand, never optimize resources
You can place your Kubernetes pod in a specific namespace by using the
argument. By default, all pods execute on a vanilla python docker
image corresponding to the version of Python
interpreter used to launch the flow and can be overridden using the
You can also specify the resource requirements on command line as well:
$ python BigSum.py run --with kubernetes:cpu=4,memory=10000,namespace=foo,image=ubuntu:latest
Accessing Kubernetes logs
As a convenience feature, you can also see the logs of any past step as follows:
$ python bigsum.py logs 15/end
You can request higher disk space for pods by using the
disk attribute of