Uploading an image

image_builder

This assumes you have taskgraph installed in a virtualenv, you have docker installed and are logged in via docker login, and you’ve already built the trusted docker image via a level 3 docker image task.

• load the image. Docker should be running; you should be logged into docker. Activate your taskgraph virtualenv and download+load the image:

  taskgraph load-image --task-id CDDoj06lSTSQ6qs5teT-CA
  

This will download public/image.tar.zst into docker.

• tag the image:

  docker tag image_builder mozillareleases/image_builder:5.0.0
  

• push the image:

  docker push mozillareleases/image_builder:5.0.0
  

• land the change in-tree. This will look like [this](https://searchfox.org/mozilla-central/rev/ce21a13035623c1d349980057d09000e70669802/taskcluster/taskgraph/transforms/docker_image.py#36-40): note that the format is <account>/<name>:<version>@sha256:<image_digest_sha256>.

decision images

At the time of writing, there are 2 decision images: a general one and mobile’s. Both are built against the taskgraph repo. They are only rebuilt whenever a change is detected by the decision task of taskgraph. You may want to upload them on DockerHub so that decision tasks that are using these images can load them. The procedure is similar to the one above.

1. Load the image (see above)

2. Tag the image. Remove -mobile in the following command if you’re dealing with the regular image:

   docker tag $IMAGE_ID mozillareleases/taskgraph:decision-mobile-$TC_INDEX_HASH
   

$IMAGE_ID is ``decision:latest or decision-mobile:latest depending on which you are updating.

$TC_INDEX_HASH is found in the routes of the taskcluster task that generated the image. Eg: $TC_INDEX_HASH is 5a222cefd6dd1397487a7b70f450a4ab16cf5eed71e126e34928b26d4ccf7577 when the route is index.taskgraph.cache.level-3.docker-images.v2.decision-mobile.hash.5a222cefd6dd1397487a7b70f450a4ab16cf5eed71e126e34928b26d4ccf7577

3. Push the image:

   docker push mozillareleases/taskgraph:decision-mobile-$TC_INDEX_HASH
   

4. Land the change in-tree. See this example

Warning

If uploading an image that bumps the version of Mercurial being used, make sure to bump the checkout cache version. See Missing Mercurial features when Cloning the Repo for more information.