7839ff2244
With the Moby/Docker split, no decisions have been made yet how, and when to bump the API version. Although these decisions should not be lead by Docker releases, I'm bumping the API version to not complicate things for now; after this bump we should make a plan how to handle this in future (for example, using SemVer for the REST api, and bump with every change). Signed-off-by: Sebastiaan van Stijn <github@gone.nl> |
||
---|---|---|
.. | ||
dockerfile | ||
integration-cli-on-swarm | ||
Jenkins | ||
make | ||
validate | ||
dind | ||
generate-authors.sh | ||
generate-swagger-api.sh | ||
install.sh | ||
make.ps1 | ||
make.sh | ||
README.md | ||
release.sh | ||
vendor.sh |
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.
Install (install.sh)
Executable install script for installing Docker. If updates to this are desired, please use hack/release.sh during a normal release. The following one-liner may be used for script hotfixes:
aws s3 cp --acl public-read hack/install.sh s3://get.docker.com/index
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 withinmake.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 intest
,test-unit
,test-integration-cli
, andtest-docker-py
on your local machine. The default timeout is set inmake.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 cross test-unit test-integration-cli test-docker-py
- For more information related to testing outside the scope of this README, refer to Run tests and test documentation
Release (release.sh)
Releases any bundles built by make
on a public AWS S3 bucket.
For information regarding configuration, please view release.sh
.
Vendor (vendor.sh)
A shell script that is a wrapper around Vndr. For information on how to use this, please refer to vndr's README