While you may pull an image directly from Docker Hub, here are our legacy instructions for pushing a Docker image to GCP Artifact Registry:

  1. Create a repository on GCP Artifact Registry by clicking the + CREATE REPOSITORY button.

    • Fill in the Name
    • Choose Docker as the Format
    • Choose any Location type
    • Choose any Encryption
    • Click CREATE

  2. Click on the newly created repository (e.g. mage-docker).

  3. Near the top of the page, click the link SETUP INSTRUCTIONS or read these instructions to set up authentication for Docker.

    • Run the following command in your terminal:

      gcloud auth configure-docker [region]-docker.pkg.dev

    • An example command could look like this:

      gcloud auth configure-docker us-west2-docker.pkg.dev

  4. Pull the Mage Docker image:

    docker pull mageai/mageai:latest

    • If your local workstation is using macOS and a silicon chip (e.g. M1, M2, etc), then run this command instead:

      docker pull --platform linux/amd64 mageai/mageai:latest

  5. Tag the pulled Mage docker image or use a previously tagged Docker image you built when following this CI/CD guide:

    • Sample commands if using vanilla Mage Docker image:

      docker tag mageai/mageai:latest [region]-docker.pkg.dev/[project_id]/[repository]/mageai:latest

      • An example command could look like this:

        docker tag mageai/mageai:latest us-west2-docker.pkg.dev/materia-284023/mage-docker/mageai:latest

    • Sample commands if using previously tagged a custom Docker image using the tag mageprod:latest:

      docker tag mageprod:latest [region]-docker.pkg.dev/[project_id]/[repository]/mageai:latest

      • An example command could look like this if you previously tagged your custom Docker image with the tag mageprod:latest:

        docker tag mageprod:latest us-west2-docker.pkg.dev/materia-284023/mage-docker/mageai:latest

  6. Push the local Docker image to GCP Artifact Registry:

    docker push [region]-docker.pkg.dev/[project_id]/[repository]/mageai:latest

    • An example command could look like this:

      docker push us-west2-docker.pkg.dev/materia-284023/mage-docker/mageai:latest