You can configure your custom training jobs to mount Network File System (NFS) shares to the container where your code is running. This allows your jobs to access remote files as though they are local with high throughput and low latency.
This guide shows how to mount an NFS share when running a custom training job.
Before you begin
Create an NFS share in a Virtual Private Cloud (VPC). Your share must be accessible without authentication.
You can use a Filestore instance as your NFS share. If you are using Filestore, select private service access as the connect mode when you create an instance. For an example, see Creating instances in the Filestore documentation.
Follow the instructions in Set up VPC Network Peering to peer Vertex AI with the VPC that hosts your NFS share.
NFS information for custom training
When you create a custom training job that mounts an NFS share, you must specify the following:
The name of the network for Vertex AI to access. The way that you specify the network name differs depending on the type of custom training job. For details, see Perform custom training.
Your NFS configuration in the WorkerPoolSpec field. Include the following fields:
The IP address of your NFS server. This must be a private address in your VPC.
The NFS share path. This must be an absolute path that begins with
The local mount point. This must be a valid UNIX directory name. For example, if the local mount point is
sourceData, then specify the path
/mnt/nfs/sourceDatafrom your training VM instance.
For more information, see Where to specify compute resources.
Example: create a custom job using the gcloud CLI
Follow the steps in Create a Python training application for a pre-built container to build a training application to run on Vertex AI.
Create a file named
config.yamlthat describes the network and NFS mount settings for your training job. Use the following format:
network: projects/PROJECT_NUMBER/global/networks/NETWORK_NAME workerPoolSpecs: - machineSpec: machineType: MACHINE_TYPE replicaCount: 1 pythonPackageSpec: executorImageUri: PYTHON_PACKAGE_EXECUTOR_IMAGE_URI or PRE_BUILT_CONTAINER_IMAGE_URI packageUris: - PYTHON_PACKAGE_URIS pythonModule: PYTHON_MODULE nfsMounts: - server: NFS_SERVER_IP path: NFS_SHARE_NAME mountPoint: LOCAL_FOLDER
Replace the following:
PROJECT_NUMBER: The project ID of your Cloud project.
NETWORK_NAME: The name of your private or shared VPC.
MACHINE_TYPE: The identifier of your virtual machine type.
PYTHON_PACKAGE_EXECUTOR_IMAGE_URI or PRE_BUILT_CONTAINER_IMAGE_URI: The URI of a container image inArtifact Registry that will run the provided Python package. Vertex AI provides a wide range of executor images with pre-installed packages to meet users' various use cases.
PYTHON_PACKAGE_URIS: A comma-separated list of Cloud Storage URIs that specify the Python package files that make up the training program and its dependent packages. The maximum number of package URIs is 100.
PYTHON_MODULE: The Python module name to run after installing the packages.
NFS_SERVER_IP: The IP address of your NFS server.
NFS_SHARE_NAME: The NFS share path, which is an absolute path that begins with
LOCAL_FOLDER: The local mount point (UNIX directory name).
Make sure that your network name is formatted correctly and that your NFS share exists in the specified network.
Create your custom job and pass your
config.yamlfile to the
gcloud ai custom-jobs create \ --region=LOCATION \ --display-name=JOB_NAME \ --config=config.yaml
Replace the following:
LOCATION: Create the job in this region.
JOB_NAME: A name for the custom job.
You must mount your NFS share using an IP address that is internal to your VPC; using public URLs is not allowed.
Training jobs mount NFS shares without authentication, and will fail if a username and password are required.
To secure your data, set permissions on your NFS share. If you are using Filestore, see access control in the Filestore documentation.
You can not run two training jobs that mount NFS shares from different VPC networks at the same time. This is due to the network peering restriction.