Docker. Don't use version numbers with docker commands
I maintainer di solito rispondono entro 1 giorno
@mjang ci sta già lavorando.
Dal 25/9/2025.
Valutazione
Questa issue non è ancora stata valutata.
Descrizione
Describe the bug
The commands lead to errors, specifically:
Error response from daemon: pull access denied for private-registry.nginx.com/v2/nginx-plus/agent, repository does not exist or may require 'docker login': denied: <html>
<head><title>403 Forbidden</title></head>
<body>
<center><h1>403 Forbidden</h1></center>
<hr><center>nginx/1.27.4</center>
</body>
</html>
The command works without a v2. But in some cases, users will want the v2
To reproduce
Run commands in https://docs.nginx.com/nginx/admin-guide/installing-nginx/installing-nginx-docker/#use-official-nginx-plus-docker-images
Expected behavior
A clear and concise description of what you expected to happen.
Additional context
As noted internally:
that doc is for if you are using the docker REST API. See example curl command https://docs.nginx.com/nginx/admin-guide/installing-nginx/installing-nginx-docker/#list-all-tags
If you are doing a docker pull private-registry.nginx.com/nginx-plus/agent:debian will get you an agent v2 image and private-registry.nginx.com/nginx-plus/agentv3:debian will get you agent v3 image
Open question
Does this apply just to the link or is this a general problem. Should we add something to our style guide and/or set up an automated rule? Or am I "overthinking" this issue?
Possible solution:
Common explanation (with an include):
- When to omit version (in this case v2)
- When to use a version
- Lingua principale
- HTML
- Stelle
- 95
- Fork
- 174
- Merge medio
- 2g 4h
- PR unite (30g)
- 84
Preparare l'ambiente
- Include un Dockerfile o un file Docker Compose
- Ha un modello di pull request
- Leggi la guida per i contributori
Come iniziare
- Leggi tutta la issue e poi la guida ai contributi del progetto.
- Commenta sulla issue per dire che te ne occupi tu — evita che due persone facciano lo stesso lavoro.
- Fai un fork del repository e lavora su un branch.
- Apri una pull request che faccia riferimento al numero della issue.
Altre issue di nginx/documentation
-
bug P2 - Important (TTR: 2 weeks)
Difficoltà 2/5 1-3 ore Idoneità per principianti 76/100
nginx/documentation#486 · 10 commenti ·
I maintainer di solito rispondono entro 1 giorno
-
JSON can't include commentsApertabug
Difficoltà 3/5 1-2 giorni Idoneità per principianti 35/100
nginx/documentation#2158 ·
I maintainer di solito rispondono entro 1 giorno
-
[Idea]: Labelling nginx and nginx plus features seperately in the header of each featureForse di nuovo libera @pumpumx l’ha presa 201 giorni fa e non c’è nessuna pull request aperta. Aperta
nginx/documentation#1798 · 4 commenti · 1 assegnatario ·
I maintainer di solito rispondono entro 1 giorno
-
[Request]: NGINXaaS conceptual overview docForse di nuovo libera @bheftel l’ha presa 307 giorni fa e non c’è nessuna pull request aperta. Apertadocumentation P4 - Low (TTR: 90 days) product/nginxaas
nginx/documentation#1554 · 1 assegnatario ·
I maintainer di solito rispondono entro 1 giorno
-
[Audit]: Install NGINX Gateway Fabric with HelmForse di nuovo libera @ADubhlaoich l’ha presa 242 giorni fa e non c’è nessuna pull request aperta. Aperta📋 audit-requested customer-feedback onboarding P2 - Important (TTR: 2 weeks) product/ngf
nginx/documentation#1459 · 3 commenti · 1 assegnatario ·
I maintainer di solito rispondono entro 1 giorno