mirror of https://github.com/docker/docs.git
Clean-up "convenience install script" include
Rephrasing some of this section, and try to make it look less "cluttered". It's not perfect yet (some other changes may be needed), but can be addressed in a follow-up. Signed-off-by: Sebastiaan van Stijn <github@gone.nl>
This commit is contained in:
Sebastiaan van Stijn
parent
7f7c60fcbc
commit
fa5e6189fe
|
|
@ -2,54 +2,86 @@
|
|||
|
||||
### Install using the convenience script
|
||||
|
||||
Docker provides convenience scripts at [get.docker.com](https://get.docker.com/)
|
||||
and [test.docker.com](https://test.docker.com/) for installing edge and
|
||||
testing versions of Docker Engine - Community into development environments quickly and
|
||||
non-interactively. The source code for the scripts is in the
|
||||
[`docker-install` repository](https://github.com/docker/docker-install).
|
||||
**Using these scripts is not recommended for production
|
||||
environments**, and you should understand the potential risks before you use
|
||||
them:
|
||||
Docker provides a convenience script at [get.docker.com](https://get.docker.com/)
|
||||
to install Docker into development environments quickly and non-interactively.
|
||||
The convenience script is not recommended for production environments, but can be
|
||||
used as an example to create a provisioning script that is tailored to your needs.
|
||||
Also refer to the [install using the repository](#install-using-the-repository)
|
||||
steps to learn about installation steps to install using the package repository.
|
||||
The source code for the script is open source, and can be found in the
|
||||
[`docker-install` repository on GitHub](https://github.com/docker/docker-install){:target="_blank" rel="noopener" class="_"}.
|
||||
|
||||
- The scripts require `root` or `sudo` privileges to run. Therefore,
|
||||
you should carefully examine and audit the scripts before running them.
|
||||
- The scripts attempt to detect your Linux distribution and version and
|
||||
configure your package management system for you. In addition, the scripts do
|
||||
not allow you to customize any installation parameters. This may lead to an
|
||||
unsupported configuration, either from Docker's point of view or from your own
|
||||
organization's guidelines and standards.
|
||||
- The scripts install all dependencies and recommendations of the package
|
||||
manager without asking for confirmation. This may install a large number of
|
||||
packages, depending on the current configuration of your host machine.
|
||||
- The script does not provide options to specify which version of Docker to install,
|
||||
and installs the latest version that is released in the "edge" channel.
|
||||
- Do not use the convenience script if Docker has already been installed on the
|
||||
host machine using another mechanism.
|
||||
|
||||
This example uses the script at [get.docker.com](https://get.docker.com/) to
|
||||
install the latest release of Docker Engine - Community on Linux. To install the latest
|
||||
testing version, use [test.docker.com](https://test.docker.com/) instead. In
|
||||
each of the commands below, replace each occurrence of `get` with `test`.
|
||||
|
||||
> **Warning**:
|
||||
>
|
||||
Always examine scripts downloaded from the internet before
|
||||
> running them locally.
|
||||
Always examine scripts downloaded from the internet before running them locally.
|
||||
Before installing, make yourself familiar with potential risks and limitations
|
||||
of the convenience script:
|
||||
{:.warning}
|
||||
|
||||
- The script requires `root` or `sudo` privileges to run.
|
||||
- The script attempts to detect your Linux distribution and version and
|
||||
configure your package management system for you, and does not allow you to
|
||||
customize most installation parameters.
|
||||
- The script installs dependencies and recommendations without asking for
|
||||
confirmation. This may install a large number of packages, depending on the
|
||||
current configuration of your host machine.
|
||||
- By default, the script installs the latest stable release of Docker, containerd,
|
||||
and runc. When using this script to provision a machine, this may result in
|
||||
unexpected major version upgrades of Docker. Always test (major) upgrades in
|
||||
a test environment before deploying to your production systems.
|
||||
- The script is not designed to upgrade an existing Docker installation. When
|
||||
using the script to update an existing installation, dependencies may not be
|
||||
updated to the expected version, causing outdated versions to be used.
|
||||
|
||||
> Tip: preview script steps before running
|
||||
>
|
||||
> You can run the script with the `DRY_RUN=1` option to learn what steps the
|
||||
> script will execute during installation:
|
||||
>
|
||||
> ```console
|
||||
> $ curl -fsSL https://get.docker.com -o get-docker.sh
|
||||
> $ DRY_RUN=1 sh ./get-docker.sh
|
||||
> ```
|
||||
|
||||
This example downloads the script from [get.docker.com](https://get.docker.com/)
|
||||
and runs it to install the latest stable release of Docker on Linux:
|
||||
|
||||
```console
|
||||
$ curl -fsSL https://get.docker.com -o get-docker.sh
|
||||
$ sudo sh get-docker.sh
|
||||
Executing docker install script, commit: 7cae5f8b0decc17d6571f9f52eb840fbc13b2737
|
||||
<...>
|
||||
```
|
||||
|
||||
If you would like to use Docker as a non-root user please see the
|
||||
[post-installation steps for Linux](../linux-postinstall#manage-docker-as-a-non-root-user).
|
||||
Docker is installed. The `docker` service starts automatically on Debian based
|
||||
distributions. On `RPM` based distributions, such as CentOS or Fedora, you need
|
||||
to start it manually using the appropriate `systemctl` or `service` command.
|
||||
As the message indicates, non-root users cannot run Docker commands by default.
|
||||
|
||||
Docker Engine - Community is installed. It starts automatically on `DEB`-based distributions. On
|
||||
`RPM`-based distributions, you need to start it manually using the appropriate
|
||||
`systemctl` or `service` command. As the message indicates, non-root users can't
|
||||
run Docker commands by default.
|
||||
> **Use Docker as a non-privileged user, or install in rootless mode?**
|
||||
>
|
||||
> The installation script requires `root` or `sudo` privileges to install and
|
||||
> use Docker. If you want to grant non-root users access to Docker, refer to the
|
||||
> [post-installation steps for Linux](/engine/install/linux-postinstall/#manage-docker-as-a-non-root-user).
|
||||
> Docker can also be installed without `root` privileges, or configured to run
|
||||
> in rootless mode. For instructions on running Docker in rootless mode, refer to
|
||||
> [run the Docker daemon as a non-root user (rootless mode)](/engine/security/rootless/).
|
||||
|
||||
#### Install pre-releases
|
||||
|
||||
Docker also provides a convenience script at [test.docker.com](https://test.docker.com/)
|
||||
to install pre-releases of Docker on Linux. This script is equivalent to the
|
||||
script at `get.docker.com`, but configures your package manager to enable the
|
||||
"test" channel from our package repository, which includes both stable and
|
||||
pre-releases (beta versions, release-candidates) of Docker. Use this script to
|
||||
get early access to new releases, and to evaluate them in a testing environment
|
||||
before they are released as stable.
|
||||
|
||||
To install the latest version of Docker on Linux from the "test" channel, run:
|
||||
|
||||
```console
|
||||
$ curl -fsSL https://test.docker.com -o test-docker.sh
|
||||
$ sudo sh test-docker.sh
|
||||
<...>
|
||||
```
|
||||
|
||||
#### Upgrade Docker after using the convenience script
|
||||
|
||||
|
|
|
|||
Loading…
Reference in New Issue