...
Eroare Docker · Pornirea și gestionarea containerelor

docker: invalid restart policy format: unknown policy 'allways'

Pe scurt

Valoarea dată la --restart nu e una dintre cele patru politici: no, always, unless-stopped, on-failure (opțional on-failure:5). De obicei e o greșeală de scriere: allways, unless_stopped, on_failure. Corectează valoarea: --restart always.

Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la

Ce înseamnă

Clientul docker validează valoarea lui --restart înainte să creeze containerul. Politicile valide sunt:

  • no: nu repornește (implicit);
  • always: repornește mereu;
  • unless-stopped: ca always, dar nu după un docker stop;
  • on-failure sau on-failure:N: doar când ieșirea are cod diferit de 0, de cel mult N ori.

Între ghilimele, mesajul arată partea dinainte de : așa cum ai scris-o (allways). Greșelile clasice: litera dublată, underscore în loc de cratimă (unless_stopped, on_failure), un număr care nu e întreg (on-failure:trei dă maximum retry count must be an integer). Aceeași validare se face la docker update --restart.

De ce apare: cauzele frecvente

1Politică scrisă greșit

Greșit
BASH
docker run -d --name cache --restart allways redis:7
Corect
BASH
docker run -d --name cache --restart always redis:7

always are un singur l; altfel nu e o politică cunoscută.

2Underscore în loc de cratimă

Greșit
BASH
docker update --restart unless_stopped cache
Corect
BASH
docker update --restart unless-stopped cache

Numele politicilor folosesc cratimă: unless-stopped, on-failure.

3Număr de încercări invalid

Greșit
BASH
docker run -d --restart on-failure:trei worker
Corect
BASH
docker run -d --restart on-failure:3 worker

După on-failure: trebuie un număr întreg.

Repară tu

Repară eroarea, direct în pagină

Cache-ul aplicației trebuie să repornească singur. Comanda docker run -d --name cache --restart allways redis:7 cade cu invalid restart policy format: unknown policy 'allways'. Pornește containerul cache din redis:7 cu politica de repornire always.

Indiciu

Numele politicii are un singur l.

Alte forme ale mesajului

  • invalid restart policy format: unknown policy 'unless_stopped'
  • docker: invalid restart policy format: maximum retry count must be an integer

Cum o eviți pe viitor

Copiază politica dintr-o sursă sigură (documentație sau un compose.yaml care merge) în loc s-o scrii din memorie. Verifică după pornire cu docker inspect -f '{{.HostConfig.RestartPolicy.Name}}' nume. În Compose, aceleași valori merg la restart:, iar docker compose config îți arată greșelile înainte de pornire.

Întrebări frecvente

Ce politică aleg pentru o bază de date în dezvoltare?

unless-stopped e cea mai comodă: pornește singură după repornirea calculatorului, dar rămâne oprită dacă ai oprit-o tu.

Pot schimba politica fără să recreez containerul?

Da, docker update --restart always cache schimbă politica unui container existent (cu excepția celor pornite cu --rm).

Erori înrudite

← Toate erorile Docker

Tudor Andrei Dumitrescu
Cine a explicat eroarea

Tudor Andrei Dumitrescu

Senior Software Developer · fondatorul Academiei Programatorilor

LinkedIn
  1. 2019 Junior JavaCognizant Softvision
  2. 2021 Mid JavaCognizant Softvision
  3. 2022 Team LeaderEndava
  4. 2023 Senior Software DeveloperUniCredit
  5. Acum Senior Software DeveloperHCLTech
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu
Certificat de formator autorizatMinisterul Muncii și Ministerul Educației · 2022
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu

Certificat de formator autorizat · Ministerul Muncii și Ministerul Educației · 2022

Din 2020 construiește Academia Programatorilor, iar din 2026 și JoburiIT.ro. Fiecare eroare de aici a fost reprodusă în editorul nostru: codul greșit chiar dă mesajul din titlu, iar reparația chiar funcționează.

Învață Docker de la zero, cu exerciții la fiecare lecție

Curs Docker: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 15 lecții sunt gratuite.