mirror of https://github.com/docker/docs.git
Merge pull request #12740 from thaJeztah/carry_rootless_install
Clean-up "convenience install script" include
This commit is contained in:
Usha Mandya
GitHub
commit
0cd9aed7b7
|
|
@ -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