106 lines
1.8 KiB
Markdown
106 lines
1.8 KiB
Markdown
# Docker + Compose + Buildx Upgrade Guide
|
|
|
|
Process: remove old version → install new version → verify
|
|
|
|
---
|
|
|
|
# 1. Remove Old Version
|
|
|
|
## Remove apt-installed packages
|
|
|
|
```bash
|
|
sudo apt remove -y docker.io docker-compose docker-compose-v2 docker-doc podman-docker containerd runc
|
|
```
|
|
|
|
---
|
|
|
|
## Remove system `docker-compose` (V1)
|
|
|
|
```bash
|
|
sudo rm -f "$(which docker-compose 2>/dev/null)"
|
|
```
|
|
|
|
---
|
|
|
|
## Find and remove manually installed Buildx plugin
|
|
|
|
```bash
|
|
docker info | sed -n '/Plugins:/,/^ Server:/p' | grep -A2 buildx
|
|
```
|
|
|
|
Get the `Path` from the output, then run:
|
|
|
|
```bash
|
|
rm -f <path to docker-buildx file>
|
|
```
|
|
|
|
---
|
|
|
|
## Clean up unused dependencies
|
|
|
|
```bash
|
|
sudo apt autoremove -y
|
|
```
|
|
|
|
---
|
|
|
|
# 2. Install Official Docker
|
|
|
|
Includes Docker Engine, Docker Compose plugin, and Docker Buildx plugin.
|
|
|
|
## Install dependencies
|
|
|
|
```bash
|
|
sudo apt update
|
|
sudo apt install -y ca-certificates curl gnupg
|
|
```
|
|
|
|
---
|
|
|
|
## Add Docker GPG key
|
|
|
|
```bash
|
|
sudo install -m 0755 -d /etc/apt/keyrings
|
|
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | \
|
|
sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg
|
|
sudo chmod a+r /etc/apt/keyrings/docker.gpg
|
|
```
|
|
|
|
---
|
|
|
|
## Add official repository
|
|
|
|
```bash
|
|
echo "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.gpg] https://download.docker.com/linux/ubuntu $(. /etc/os-release && echo "$VERSION_CODENAME") stable" | \
|
|
sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
|
|
```
|
|
|
|
---
|
|
|
|
## Install Docker + Compose + Buildx
|
|
|
|
```bash
|
|
sudo apt update
|
|
sudo apt install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
|
|
```
|
|
|
|
---
|
|
|
|
# 3. Verify Installation
|
|
|
|
```bash
|
|
docker --version
|
|
docker compose version
|
|
docker buildx version
|
|
```
|
|
|
|
---
|
|
|
|
# 4. Common Commands
|
|
|
|
```bash
|
|
docker compose up -d
|
|
docker compose down
|
|
docker buildx build .
|
|
```
|