Container-Upgrade

Aktualisieren Sie eine Container-Bereitstellung, indem Sie den RustFS-Container aus einem neueren Image neu erzeugen. Wählen Sie den Ablauf, der zur ursprünglichen Installationsmethode passt: ein direkt mit Docker oder Podman gestarteter Container oder ein von Docker Compose verwalteter Dienst.

Vor dem UpgradeCopy Anchor Link

Lesen Sie die Versionshinweise der Zielversion und verwenden Sie für das Upgrade ein explizites Image-Tag. Notieren Sie das aktuelle Image und bewahren Sie die ursprüngliche Konfiguration von docker run, podman run oder Compose auf, weil das Neuerzeugen eines Containers dessen Laufzeitoptionen nicht automatisch übernimmt.

Bestätigen Sie, dass RustFS betriebsbereit ist, bevor Sie es ersetzen:

curl -fsS http://localhost:9000/health/ready

Einen Docker-Container aktualisierenCopy Anchor Link

Der folgende Ablauf entspricht dem Containernamen und dem benannten Volume aus der Docker-Installationsanleitung. Wenn Ihre Bereitstellung andere Ports, Umgebungsvariablen, Einhängungen oder Startargumente verwendet, lassen Sie diese Einstellungen im Ersatzbefehl unverändert.

Notieren Sie das aktuelle Image und ziehen Sie dann die Zielversion:

docker inspect --format '{{.Config.Image}}' rustfs
docker pull rustfs/rustfs:<target-version>

Stoppen und entfernen Sie nur den Container. Das Volume rustfs-data bleibt erhalten:

docker stop rustfs
docker rm rustfs

Erzeugen Sie den Container mit der ursprünglichen Konfiguration und dem Ziel-Image neu:

docker run -d \
	--name rustfs \
	--restart unless-stopped \
	-p 9000:9000 \
	-p 9001:9001 \
	-v rustfs-data:/data \
	-e RUSTFS_ACCESS_KEY="<your-access-key>" \
	-e RUSTFS_SECRET_KEY="<your-secret-key>" \
	-e RUSTFS_ADDRESS=":9000" \
	-e RUSTFS_CONSOLE_ADDRESS=":9001" \
	-e RUSTFS_CONSOLE_ENABLE=true \
	-e RUSTFS_OBS_LOGGER_LEVEL=error \
	-e RUSTFS_OBS_LOG_DIRECTORY="/var/log/rustfs/" \
	rustfs/rustfs:<target-version> \
	/data

Warten Sie, bis der Ersatzcontainer betriebsbereit ist:

docker ps --filter name=rustfs
docker logs rustfs
curl -fsS http://localhost:9000/health/ready

Einen Podman-Container aktualisierenCopy Anchor Link

Der Podman-Ablauf ist derselbe Ersatzvorgang und verwendet den Image-Namen aus der Podman-Installationsanleitung.

podman inspect --format '{{.Config.Image}}' rustfs
podman pull docker.io/rustfs/rustfs:<target-version>
podman stop rustfs
podman rm rustfs

Erzeugen Sie den Container mit der ursprünglichen Konfiguration und dem persistenten Volume neu:

podman run -d \
	--name rustfs \
	-p 9000:9000 \
	-p 9001:9001 \
	-v rustfs-data:/data \
	-e RUSTFS_ACCESS_KEY="<your-access-key>" \
	-e RUSTFS_SECRET_KEY="<your-secret-key>" \
	-e RUSTFS_ADDRESS=":9000" \
	-e RUSTFS_CONSOLE_ADDRESS=":9001" \
	-e RUSTFS_CONSOLE_ENABLE=true \
	-e RUSTFS_OBS_LOGGER_LEVEL=error \
	-e RUSTFS_OBS_LOG_DIRECTORY="/var/log/rustfs/" \
	docker.io/rustfs/rustfs:<target-version> \
	/data

Prüfen Sie den Ersatz, bevor Sie fortfahren:

podman ps --filter name=rustfs
podman logs rustfs
curl -fsS http://localhost:9000/health/ready

Mit Docker Compose aktualisierenCopy Anchor Link

Führen Sie Compose-Befehle aus dem Verzeichnis aus, das die docker-compose.yml der Bereitstellung enthält. Speichern Sie vor dem Upgrade die vollständig aufgelöste Konfiguration und bestätigen Sie das aktuelle Image:

docker compose config > docker-compose.resolved.yaml
docker compose images rustfs

Setzen Sie den Dienst rustfs auf ein explizites Ziel-Image-Tag und lassen Sie Volumes, Umgebung, Ports und Befehl unverändert:

services:
	rustfs:
		image: rustfs/rustfs:<target-version>

Prüfen Sie die Datei, ziehen Sie das Ziel-Image und erzeugen Sie nur den RustFS-Dienst neu. --no-deps lässt optionale Observability-Dienste weiterlaufen:

docker compose config --quiet
docker compose pull rustfs
docker compose up -d --no-deps rustfs

Prüfen Sie den Dienst und den Bereitschafts-Endpunkt von RustFS:

docker compose ps rustfs
docker compose logs --tail=100 rustfs
curl -fsS http://localhost:9000/health/ready

Wenn Sie RustFS zusammen mit dem Profil observability gestartet haben, wird der RustFS-Dienst mit denselben Befehlen aktualisiert. Aktualisieren Sie Observability-Images getrennt nach den Versionshinweisen der jeweiligen Komponente.

Eine Bereitstellung mit mehreren Knoten aktualisierenCopy Anchor Link

Ersetzen Sie jeweils einen RustFS-Knoten. Warten Sie, bis der Bereitschafts-Endpunkt des aktualisierten Knotens erfolgreich antwortet, und bestätigen Sie den Clusterstatus, bevor Sie zum nächsten Knoten wechseln. Erzeugen Sie nicht alle Knoten gleichzeitig neu.

Verwenden Sie auf jedem Knoten denselben Ablauf für Docker, Podman oder Compose und behalten Sie die vorhandenen Einhängungen und die Konfiguration dieses Knotens bei.

ZurücksetzenCopy Anchor Link

Stoppen und entfernen Sie bei Docker oder Podman den fehlgeschlagenen Ersatzcontainer und wiederholen Sie den zugehörigen run-Befehl mit dem zuvor notierten Image-Tag. Behalten Sie dasselbe persistente Volume und dieselbe Laufzeitkonfiguration bei.

Setzen Sie bei Docker Compose den vorherigen Wert von image in docker-compose.yml wieder ein und erzeugen Sie dann den RustFS-Dienst neu:

docker compose pull rustfs
docker compose up -d --no-deps rustfs
curl -fsS http://localhost:9000/health/ready

Setzen Sie in einer Bereitstellung mit mehreren Knoten jeweils einen Knoten zurück und warten Sie auf Bereitschaft, bevor Sie fortfahren.

Nächste SchritteCopy Anchor Link

Weitere Prüfungen nach dem Upgrade finden Sie unter Statusprüfung.