mirror of
https://github.com/mozilla/gecko-dev.git
synced 2024-10-17 15:25:52 +00:00
f3e89595f1
--HG-- rename : taskcluster/docker/README.md => testing/docker/README.md rename : taskcluster/docker/REGISTRY => testing/docker/REGISTRY rename : taskcluster/docker/android-gradle-build/Dockerfile => testing/docker/android-gradle-build/Dockerfile rename : taskcluster/docker/android-gradle-build/README.md => testing/docker/android-gradle-build/README.md rename : taskcluster/docker/android-gradle-build/REGISTRY => testing/docker/android-gradle-build/REGISTRY rename : taskcluster/docker/android-gradle-build/VERSION => testing/docker/android-gradle-build/VERSION rename : taskcluster/docker/android-gradle-build/bin/after.sh => testing/docker/android-gradle-build/bin/after.sh rename : taskcluster/docker/android-gradle-build/bin/before.sh => testing/docker/android-gradle-build/bin/before.sh rename : taskcluster/docker/android-gradle-build/bin/build.sh => testing/docker/android-gradle-build/bin/build.sh rename : taskcluster/docker/android-gradle-build/bin/checkout-script.sh => testing/docker/android-gradle-build/bin/checkout-script.sh rename : taskcluster/docker/android-gradle-build/bin/checkout-sources.sh => testing/docker/android-gradle-build/bin/checkout-sources.sh rename : taskcluster/docker/android-gradle-build/buildprops.json => testing/docker/android-gradle-build/buildprops.json rename : taskcluster/docker/android-gradle-build/dot-config/pip/pip.conf => testing/docker/android-gradle-build/dot-config/pip/pip.conf rename : taskcluster/docker/android-gradle-build/oauth.txt => testing/docker/android-gradle-build/oauth.txt rename : taskcluster/docker/base-build/Dockerfile => testing/docker/base-build/Dockerfile rename : taskcluster/docker/base-build/VERSION => testing/docker/base-build/VERSION rename : taskcluster/docker/base-build/system-setup.sh => testing/docker/base-build/system-setup.sh rename : taskcluster/docker/base-test/Dockerfile => testing/docker/base-test/Dockerfile rename : taskcluster/docker/base-test/REGISTRY => testing/docker/base-test/REGISTRY rename : taskcluster/docker/base-test/VERSION => testing/docker/base-test/VERSION rename : taskcluster/docker/base-test/sources.list => testing/docker/base-test/sources.list rename : taskcluster/docker/centos6-build-upd/Dockerfile => testing/docker/centos6-build-upd/Dockerfile rename : taskcluster/docker/centos6-build-upd/REGISTRY => testing/docker/centos6-build-upd/REGISTRY rename : taskcluster/docker/centos6-build-upd/VERSION => testing/docker/centos6-build-upd/VERSION rename : taskcluster/docker/centos6-build/Dockerfile => testing/docker/centos6-build/Dockerfile rename : taskcluster/docker/centos6-build/REGISTRY => testing/docker/centos6-build/REGISTRY rename : taskcluster/docker/centos6-build/VERSION => testing/docker/centos6-build/VERSION rename : taskcluster/docker/centos6-build/hgrc => testing/docker/centos6-build/hgrc rename : taskcluster/docker/centos6-build/system-setup.sh => testing/docker/centos6-build/system-setup.sh rename : taskcluster/docker/decision/Dockerfile => testing/docker/decision/Dockerfile rename : taskcluster/docker/decision/README.md => testing/docker/decision/README.md rename : taskcluster/docker/decision/REGISTRY => testing/docker/decision/REGISTRY rename : taskcluster/docker/decision/VERSION => testing/docker/decision/VERSION rename : taskcluster/docker/decision/system-setup.sh => testing/docker/decision/system-setup.sh rename : taskcluster/docker/desktop-build/Dockerfile => testing/docker/desktop-build/Dockerfile rename : taskcluster/docker/desktop-build/bin/build.sh => testing/docker/desktop-build/bin/build.sh rename : taskcluster/docker/desktop-build/bin/checkout-script.sh => testing/docker/desktop-build/bin/checkout-script.sh rename : taskcluster/docker/desktop-build/bin/checkout-sources.sh => testing/docker/desktop-build/bin/checkout-sources.sh rename : taskcluster/docker/desktop-build/buildprops.json => testing/docker/desktop-build/buildprops.json rename : taskcluster/docker/desktop-build/dot-config/pip/pip.conf => testing/docker/desktop-build/dot-config/pip/pip.conf rename : taskcluster/docker/desktop-build/oauth.txt => testing/docker/desktop-build/oauth.txt rename : taskcluster/docker/desktop-test/Dockerfile => testing/docker/desktop-test/Dockerfile rename : taskcluster/docker/desktop-test/apport => testing/docker/desktop-test/apport rename : taskcluster/docker/desktop-test/buildprops.json => testing/docker/desktop-test/buildprops.json rename : taskcluster/docker/desktop-test/deja-dup-monitor.desktop => testing/docker/desktop-test/deja-dup-monitor.desktop rename : taskcluster/docker/desktop-test/dot-files/config/pip/pip.conf => testing/docker/desktop-test/dot-files/config/pip/pip.conf rename : taskcluster/docker/desktop-test/dot-files/config/user-dirs.dirs => testing/docker/desktop-test/dot-files/config/user-dirs.dirs rename : taskcluster/docker/desktop-test/dot-files/config/user-dirs.locale => testing/docker/desktop-test/dot-files/config/user-dirs.locale rename : taskcluster/docker/desktop-test/dot-files/pulse/default.pa => testing/docker/desktop-test/dot-files/pulse/default.pa rename : taskcluster/docker/desktop-test/fonts.conf => testing/docker/desktop-test/fonts.conf rename : taskcluster/docker/desktop-test/jockey-gtk.desktop => testing/docker/desktop-test/jockey-gtk.desktop rename : taskcluster/docker/desktop-test/motd => testing/docker/desktop-test/motd rename : taskcluster/docker/desktop-test/release-upgrades => testing/docker/desktop-test/release-upgrades rename : taskcluster/docker/desktop-test/taskcluster-interactive-shell => testing/docker/desktop-test/taskcluster-interactive-shell rename : taskcluster/docker/desktop-test/tc-vcs-config.yml => testing/docker/desktop-test/tc-vcs-config.yml rename : taskcluster/docker/desktop-test/tester.env => testing/docker/desktop-test/tester.env rename : taskcluster/docker/desktop1604-test/Dockerfile => testing/docker/desktop1604-test/Dockerfile rename : taskcluster/docker/desktop1604-test/apport => testing/docker/desktop1604-test/apport rename : taskcluster/docker/desktop1604-test/buildprops.json => testing/docker/desktop1604-test/buildprops.json rename : taskcluster/docker/desktop1604-test/deja-dup-monitor.desktop => testing/docker/desktop1604-test/deja-dup-monitor.desktop rename : taskcluster/docker/desktop1604-test/dot-files/config/pip/pip.conf => testing/docker/desktop1604-test/dot-files/config/pip/pip.conf rename : taskcluster/docker/desktop1604-test/dot-files/config/user-dirs.dirs => testing/docker/desktop1604-test/dot-files/config/user-dirs.dirs rename : taskcluster/docker/desktop1604-test/dot-files/config/user-dirs.locale => testing/docker/desktop1604-test/dot-files/config/user-dirs.locale rename : taskcluster/docker/desktop1604-test/dot-files/pulse/default.pa => testing/docker/desktop1604-test/dot-files/pulse/default.pa rename : taskcluster/docker/desktop1604-test/fonts.conf => testing/docker/desktop1604-test/fonts.conf rename : taskcluster/docker/desktop1604-test/jockey-gtk.desktop => testing/docker/desktop1604-test/jockey-gtk.desktop rename : taskcluster/docker/desktop1604-test/motd => testing/docker/desktop1604-test/motd rename : taskcluster/docker/desktop1604-test/release-upgrades => testing/docker/desktop1604-test/release-upgrades rename : taskcluster/docker/desktop1604-test/taskcluster-interactive-shell => testing/docker/desktop1604-test/taskcluster-interactive-shell rename : taskcluster/docker/desktop1604-test/tc-vcs-config.yml => testing/docker/desktop1604-test/tc-vcs-config.yml rename : taskcluster/docker/desktop1604-test/tester.env => testing/docker/desktop1604-test/tester.env rename : taskcluster/docker/image_builder/Dockerfile => testing/docker/image_builder/Dockerfile rename : taskcluster/docker/image_builder/REGISTRY => testing/docker/image_builder/REGISTRY rename : taskcluster/docker/image_builder/VERSION => testing/docker/image_builder/VERSION rename : taskcluster/docker/image_builder/build-image.sh => testing/docker/image_builder/build-image.sh rename : taskcluster/docker/image_builder/setup.sh => testing/docker/image_builder/setup.sh rename : taskcluster/docker/lint/Dockerfile => testing/docker/lint/Dockerfile rename : taskcluster/docker/lint/system-setup.sh => testing/docker/lint/system-setup.sh rename : taskcluster/docker/recipes/centos6-build-system-setup.sh => testing/docker/recipes/centos6-build-system-setup.sh rename : taskcluster/docker/recipes/common.sh => testing/docker/recipes/common.sh rename : taskcluster/docker/recipes/install-mercurial.sh => testing/docker/recipes/install-mercurial.sh rename : taskcluster/docker/recipes/run-task => testing/docker/recipes/run-task rename : taskcluster/docker/recipes/tooltool.py => testing/docker/recipes/tooltool.py rename : taskcluster/docker/recipes/ubuntu1204-test-system-setup.sh => testing/docker/recipes/ubuntu1204-test-system-setup.sh rename : taskcluster/docker/recipes/ubuntu1604-test-system-setup.sh => testing/docker/recipes/ubuntu1604-test-system-setup.sh rename : taskcluster/docker/recipes/xvfb.sh => testing/docker/recipes/xvfb.sh rename : taskcluster/docker/rust-build/Dockerfile => testing/docker/rust-build/Dockerfile rename : taskcluster/docker/rust-build/README.md => testing/docker/rust-build/README.md rename : taskcluster/docker/rust-build/REGISTRY => testing/docker/rust-build/REGISTRY rename : taskcluster/docker/rust-build/VERSION => testing/docker/rust-build/VERSION rename : taskcluster/docker/rust-build/build_cargo.sh => testing/docker/rust-build/build_cargo.sh rename : taskcluster/docker/rust-build/build_rust.sh => testing/docker/rust-build/build_rust.sh rename : taskcluster/docker/rust-build/build_rust_mac.sh => testing/docker/rust-build/build_rust_mac.sh rename : taskcluster/docker/rust-build/fetch_cargo.sh => testing/docker/rust-build/fetch_cargo.sh rename : taskcluster/docker/rust-build/fetch_rust.sh => testing/docker/rust-build/fetch_rust.sh rename : taskcluster/docker/rust-build/package_rust.sh => testing/docker/rust-build/package_rust.sh rename : taskcluster/docker/rust-build/repack_rust.py => testing/docker/rust-build/repack_rust.py rename : taskcluster/docker/rust-build/splat_rust.py => testing/docker/rust-build/splat_rust.py rename : taskcluster/docker/rust-build/task.json => testing/docker/rust-build/task.json rename : taskcluster/docker/rust-build/tcbuild.py => testing/docker/rust-build/tcbuild.py rename : taskcluster/docker/rust-build/upload_rust.sh => testing/docker/rust-build/upload_rust.sh rename : taskcluster/docker/tester/Dockerfile => testing/docker/tester/Dockerfile rename : taskcluster/docker/tester/REGISTRY => testing/docker/tester/REGISTRY rename : taskcluster/docker/tester/VERSION => testing/docker/tester/VERSION rename : taskcluster/docker/tester/bin/test.sh => testing/docker/tester/bin/test.sh rename : taskcluster/docker/tester/dot-config/pip/pip.conf => testing/docker/tester/dot-config/pip/pip.conf rename : taskcluster/docker/tester/dot-config/user-dirs.dirs => testing/docker/tester/dot-config/user-dirs.dirs rename : taskcluster/docker/tester/dot-config/user-dirs.locale => testing/docker/tester/dot-config/user-dirs.locale rename : taskcluster/docker/tester/dot-pulse/default.pa => testing/docker/tester/dot-pulse/default.pa rename : taskcluster/docker/tester/tc-vcs-config.yml => testing/docker/tester/tc-vcs-config.yml rename : taskcluster/docker/tester/tester.env => testing/docker/tester/tester.env rename : taskcluster/docker/upload-symbols/Dockerfile => testing/docker/upload-symbols/Dockerfile rename : taskcluster/docker/upload-symbols/README.md => testing/docker/upload-symbols/README.md rename : taskcluster/docker/upload-symbols/bin/checkout-script.sh => testing/docker/upload-symbols/bin/checkout-script.sh rename : taskcluster/docker/upload-symbols/bin/upload.sh => testing/docker/upload-symbols/bin/upload.sh rename : taskcluster/docker/upload-symbols/test_exports.sh => testing/docker/upload-symbols/test_exports.sh
43 lines
1.3 KiB
ReStructuredText
43 lines
1.3 KiB
ReStructuredText
.. taskcluster_dockerimages:
|
|
|
|
=============
|
|
Docker Images
|
|
=============
|
|
|
|
TaskCluster Docker images are defined in the source directory under
|
|
``taskcluster/docker``. Each directory therein contains the name of an
|
|
image used as part of the task graph.
|
|
|
|
Adding Extra Files to Images
|
|
============================
|
|
|
|
Dockerfile syntax has been extended to allow *any* file from the
|
|
source checkout to be added to the image build *context*. (Traditionally
|
|
you can only ``ADD`` files from the same directory as the Dockerfile.)
|
|
|
|
Simply add the following syntax as a comment in a Dockerfile::
|
|
|
|
# %include <path>
|
|
|
|
e.g.
|
|
|
|
# %include mach
|
|
# %include testing/mozharness
|
|
|
|
The argument to ``# %include`` is a relative path from the root level of
|
|
the source directory. It can be a file or a directory. If a file, only that
|
|
file will be added. If a directory, every file under that directory will be
|
|
added (even files that are untracked or ignored by version control).
|
|
|
|
Files added using ``# %include`` syntax are available inside the build
|
|
context under the ``topsrcdir/`` path.
|
|
|
|
Files are added as they exist on disk. e.g. executable flags should be
|
|
preserved. However, the file owner/group is changed to ``root`` and the
|
|
``mtime`` of the file is normalized.
|
|
|
|
Here is an example Dockerfile snippet::
|
|
|
|
# %include mach
|
|
ADD topsrcdir/mach /home/worker/mach
|