Sebastiaan van Stijn 4046ae5e2f Merge pull request #46787 from thaJeztah/update_golang_1.21.4 1 year ago
..
dockerfile 68e73ceb67 update containerd binary to v1.7.9 1 year ago
dockerfiles 862caf826c update to go1.21.5 1 year ago
make 08e4e88482 daemon: raise default minimum API version to v1.24 1 year ago
test 75097cf09a test: remove platform related timeout values 1 year ago
validate d60de4cafd Move the golangci-lint configuration file to the root dir 1 year ago
README.md 8086f40123 Dockerfile: use TARGETPLATFORM to build Docker 2 years ago
buildkit-ref 7310a7cd0c ci(buildkit): remove early-return from buildkit-ref 1 year ago
dind 65cfcc28ab hack/dind: update comments around AppArmor 1 year ago
dind-systemd cfb8ca520a hack/dind-systemd: make AppArmor work with systemd enabled 1 year ago
generate-authors.sh 5563b09ac2 hack: use Git-free ROOTDIR convention 1 year ago
generate-swagger-api.sh ec69501e94 api/types: move ServiceCreateResponse, and generate from swagger 1 year ago
generate-test-certs.sh 2fea30f146 hack: add script to regenerate certificates 4 years ago
generate-test-rogue-certs.sh 3b157dc3b6 integration-cli: fix test rogue certs 3 years ago
make.ps1 2aabd64477 hack: update link to GOPATH documentation 1 year ago
make.sh 12d1f4f385 hack: remove devicemapper leftovers and build-tags 1 year ago
vendor.sh a449f77774 hack: replace go-mod-prepare.sh with wrapper script 2 years ago
with-go-mod.sh 16063c7456 vendor.mod: bump go line to 1.20 1 year ago

README.md

About

This directory contains a collection of scripts used to build and manage this repository. If there are any issues regarding the intention of a particular script (or even part of a certain script), please reach out to us. It may help us either refine our current scripts, or add on new ones that are appropriate for a given use case.

DinD (dind.sh)

DinD is a wrapper script which allows Docker to be run inside a Docker container. DinD requires the container to be run with privileged mode enabled.

Generate Authors (generate-authors.sh)

Generates AUTHORS; a file with all the names and corresponding emails of individual contributors. AUTHORS can be found in the home directory of this repository.

Make

There are two make files, each with different extensions. Neither are supposed to be called directly; only invoke make. Both scripts run inside a Docker container.

make.ps1

  • The Windows native build script that uses PowerShell semantics; it is limited unlike hack\make.sh since it does not provide support for the full set of operations provided by the Linux counterpart, make.sh. However, make.ps1 does provide support for local Windows development and Windows to Windows CI. More information is found within make.ps1 by the author, @jhowardmsft

make.sh

  • Referenced via make test when running tests on a local machine, or directly referenced when running tests inside a Docker development container.
  • When running on a local machine, make test to run all tests found in test, test-unit, test-integration, and test-docker-py on your local machine. The default timeout is set in make.sh to 60 minutes (${TIMEOUT:=60m}), since it currently takes up to an hour to run all of the tests.
  • When running inside a Docker development container, hack/make.sh does not have a single target that runs all the tests. You need to provide a single command line with multiple targets that performs the same thing. An example referenced from Run targets inside a development container: root@5f8630b873fe:/go/src/github.com/moby/moby# hack/make.sh dynbinary binary test-unit test-integration test-docker-py
  • For more information related to testing outside the scope of this README, refer to Run tests and test documentation

Vendor (vendor.sh)

A shell script that is a wrapper around go mod vendor.