Skip to content

Build Nightly Docker Images #19

Build Nightly Docker Images

Build Nightly Docker Images #19

# Copyright 2023–2026 Google LLC
#
# Licensed under the Apache License, Version 2.0 (the "License");
# you may not use this file except in compliance with the License.
# You may obtain a copy of the License at
#
# https://www.apache.org/licenses/LICENSE-2.0
#
# Unless required by applicable law or agreed to in writing, software
# distributed under the License is distributed on an "AS IS" BASIS,
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
# See the License for the specific language governing permissions and
# limitations under the License.
# This workflow builds and pushes MaxText images for both TPU and GPU devices.
# It runs automatically daily at 12am UTC, or manually via Workflow Dispatch.
name: Build Nightly Docker Images
on:
schedule:
# Run the job daily at 12AM UTC
- cron: '0 0 * * *'
workflow_dispatch:
inputs:
target_device:
description: 'Specify target device (all, tpu, or gpu)'
required: true
type: choice
default: 'all'
options:
- all
- tpu
- gpu
image_suffix:
description: 'An image suffix can be provided to add to the image name'
required: false
type: string
default: ""
permissions:
contents: read
jobs:
build_maxtext_package:
name: Build MaxText Package
uses: ./.github/workflows/build_package.yml
with:
device_type: tpu
device_name: v4-8
cloud_runner: linux-x86-n2-16-buildkit
build_and_push_docker_image:
name: Build ${{ matrix.name }} Docker Image
needs: build_maxtext_package
strategy:
fail-fast: false
matrix:
include:
- name: "TPU Pre-Training Stable"
device: tpu
build_mode: stable
workflow: pre-training
image_name: maxtext_jax_stable
dockerfile: maxtext_tpu_dependencies.Dockerfile
- name: "TPU Pre-Training Nightly"
device: tpu
build_mode: nightly
workflow: pre-training
image_name: maxtext_jax_nightly
dockerfile: maxtext_tpu_dependencies.Dockerfile
- name: "TPU Post-Training Nightly"
device: tpu
build_mode: nightly
workflow: post-training
image_name: maxtext_post_training_nightly
dockerfile: maxtext_tpu_dependencies.Dockerfile
- name: "GPU Pre-Training Stable"
device: gpu
build_mode: stable
workflow: pre-training
image_name: maxtext_gpu_jax_stable
dockerfile: maxtext_gpu_dependencies.Dockerfile
- name: "GPU Pre-Training Nightly"
device: gpu
build_mode: nightly
workflow: pre-training
image_name: maxtext_gpu_jax_nightly
dockerfile: maxtext_gpu_dependencies.Dockerfile
uses: ./.github/workflows/build_and_push_docker_image.yml
with:
image_name: ${{ inputs.image_suffix != '' && format('{0}_{1}', matrix.image_name, inputs.image_suffix) || matrix.image_name }}
device: ${{ matrix.device }}
build_mode: ${{ matrix.build_mode }}
workflow: ${{ matrix.workflow }}
dockerfile: ${{ matrix.dockerfile }}
maxtext_sha: ${{ needs.build_and_upload_maxtext_package.outputs.maxtext_sha }}
include_test_assets: true
secrets:
HF_TOKEN: ${{ secrets.HF_TOKEN }}
run_e2e_tests:
name: Run E2E tests
needs: build_and_push_docker_image
uses: ./.github/workflows/run_e2e_tests.yml
with:
mode: ${{ inputs.image_suffix != '' && format('{0}_{1}', 'nightly', inputs.image_suffix) || 'nightly' }}
run_id: ${{ github.run_id }}
maxtext_sha: ${{ github.sha }}
secrets: inherit
notify_failure:
name: Notify failed build
needs: [build_and_push_docker_image, run_e2e_tests]
if: ${{ failure() && inputs.image_suffix == '' }}
runs-on: ubuntu-latest
permissions:
issues: write
steps:
- name: Create issue on failure
uses: jayqi/failed-build-issue-action@1a893bbf43ef1c2a8705e2b115cd4f0fe3c5649b
with:
github-token: ${{ secrets.GITHUB_TOKEN }}
title-template: "MaxText Docker Image Build Failure"
label-name: "docker-image-build-failure"