From 3f67b55adff3048696973b1d8f4e35864e938862 Mon Sep 17 00:00:00 2001 From: Branden Vandermoon <103541588+bvandermoon@users.noreply.github.com> Date: Thu, 26 Mar 2026 18:00:37 -0700 Subject: [PATCH] Document docker upload file path workaround --- docs/build_maxtext.md | 10 ++++++++-- 1 file changed, 8 insertions(+), 2 deletions(-) diff --git a/docs/build_maxtext.md b/docs/build_maxtext.md index ab1746d699..8ae5541fb3 100644 --- a/docs/build_maxtext.md +++ b/docs/build_maxtext.md @@ -128,10 +128,16 @@ build_maxtext_docker_image WORKFLOW=post-training ## Upload MaxText Docker Image to Artifact Registry -> **Note:** You will need the [**Artifact Registry Writer**](https://docs.cloud.google.com/artifact-registry/docs/access-control#permissions) role to push Docker images to your project's Artifact Registry and to allow the cluster to pull them during workload execution. If you don't have this permission, contact your project administrator to grant you this role through "Google Cloud Console -> IAM -> Grant access". - ```bash # Make sure to set `CLOUD_IMAGE_NAME` with your desired image name. export CLOUD_IMAGE_NAME= upload_maxtext_docker_image CLOUD_IMAGE_NAME=${CLOUD_IMAGE_NAME?} ``` + +> **Note:** You will need the [**Artifact Registry Writer**](https://docs.cloud.google.com/artifact-registry/docs/access-control#permissions) role to push Docker images to your project's Artifact Registry and to allow the cluster to pull them during workload execution. If you don't have this permission, contact your project administrator to grant you this role through "Google Cloud Console -> IAM -> Grant access". + +> **Note:** If you see the following error, try adding the listed file path to `.dockerignore`: +> ``` +> ERROR: Found symbolic links with absolute paths in the build context: +> ./ +> ```