engine: simplify apt-based installation for rpi

Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
This commit is contained in:
David Karlsson 2023-09-04 17:33:23 +02:00
parent 63e55f32c9
commit 7b7ec5b1e8
2 changed files with 32 additions and 50 deletions

View File

@ -32,6 +32,7 @@ For Compose standalone, see [Install Compose Standalone](standalone.md).
[Ubuntu](../../engine/install/ubuntu.md/#set-up-the-repository) |
[CentOS](../../engine/install/centos.md/#set-up-the-repository) |
[Debian](../../engine/install/debian.md/#install-using-the-repository) |
[Raspberry Pi OS](../../engine/install/raspberry-pi-os.md/#install-using-the-repository) |
[Fedora](../../engine/install/fedora.md/#set-up-the-repository) |
[RHEL](../../engine/install/rhel.md/#set-up-the-repository) |
[SLES](../../engine/install/sles.md/#set-up-the-repository).

View File

@ -89,50 +89,31 @@ You can install Docker Engine in different ways, depending on your needs:
### Install using the apt repository {#install-using-the-repository}
Before you install Docker Engine for the first time on a new host machine, you
need to set up the Docker repository. Afterward, you can install and update
need to set up the Docker Apt repository. Afterward, you can install and update
Docker from the repository.
#### Set up the repository
1. Set up Docker's Apt repository.
```bash
# Add Docker's official GPG key:
sudo apt-get update
sudo apt-get install ca-certificates curl gnupg
sudo install -m 0755 -d /etc/apt/keyrings
curl -fsSL {{% param "download-url-base" %}}/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg
sudo chmod a+r /etc/apt/keyrings/docker.gpg
1. Update the `apt` package index and install packages to allow `apt` to use a
repository over HTTPS:
```console
$ sudo apt-get update
$ sudo apt-get install ca-certificates curl gnupg
```
2. Add Docker's official GPG key:
```console
$ sudo install -m 0755 -d /etc/apt/keyrings
$ curl -fsSL {{% param "download-url-base" %}}/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg
$ sudo chmod a+r /etc/apt/keyrings/docker.gpg
```
3. Use the following command to set up the repository:
```console
$ echo \
"deb [arch="$(dpkg --print-architecture)" signed-by=/etc/apt/keyrings/docker.gpg] {{% param "download-url-base" %}} \
"$(. /etc/os-release && echo "$VERSION_CODENAME")" stable" | \
sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
```
4. Update the `apt` package index:
```console
$ sudo apt-get update
# Set up Docker's Apt repository:
echo \
"deb [arch="$(dpkg --print-architecture)" signed-by=/etc/apt/keyrings/docker.gpg] {{% param "download-url-base" %}} \
"$(. /etc/os-release && echo "$VERSION_CODENAME")" stable" | \
sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
sudo apt-get update
```
2. Install the Docker packages.
#### Install Docker Engine
1. Install Docker Engine, containerd, and Docker Compose.
{{< tabs >}}
{{< tab name="Latest" >}}
{{< tabs >}}
{{< tab name="Latest" >}}
To install the latest version, run:
@ -140,11 +121,11 @@ Docker from the repository.
$ sudo apt-get install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
```
{{< /tab >}}
{{< tab name="Specific version" >}}
{{< /tab >}}
{{< tab name="Specific version" >}}
To install a specific version of Docker Engine, start by listing the available
versions in the repository:
To install a specific version of Docker Engine, start by listing the
available versions in the repository:
```console
# List the available versions:
@ -152,7 +133,7 @@ Docker from the repository.
5:24.0.0-1~raspbian.11~bullseye
5:23.0.6-1~raspbian.11~bullseye
<...>
...
```
Select the desired version and install:
@ -162,11 +143,11 @@ Docker from the repository.
$ sudo apt-get install docker-ce=$VERSION_STRING docker-ce-cli=$VERSION_STRING containerd.io docker-buildx-plugin docker-compose-plugin
```
{{< /tab >}}
{{< /tabs >}}
{{< /tab >}}
{{< /tabs >}}
2. Verify that the Docker Engine installation is successful by running the
`hello-world` image:
3. Verify that the installation is successful by running the `hello-world`
image:
```console
$ sudo docker run hello-world
@ -181,9 +162,9 @@ You have now successfully installed and started Docker Engine.
#### Upgrade Docker Engine
To upgrade Docker Engine, follow the
[installation instructions](#install-docker-engine), choosing the new version
you want to install.
To upgrade Docker Engine, follow step 2 of the
[installation instructions](#install-using-the-repository),
choosing the new version you want to install.
### Install from a package
@ -264,4 +245,4 @@ You have to delete any edited configuration files manually.
- Continue to [Post-installation steps for Linux](linux-postinstall.md).
- Review the topics in [Develop with Docker](../../develop/index.md) to learn
how to build new applications using Docker.
how to build new applications using Docker.