docker / docker/docs

Clarify that healthcheck retries must be > 0

Open
#10,929 2 comments 0 reactions 1 assignee View on GitHub

@dvdksn is already working on this.

Since Aug 24, 2023.

lifecycle/frozen status/upstream
Dominant language
Markdown
Stars
4.7k
Forks
8.5k
Avg merge
2d 18h
Merged PRs (30d)
108

Description

In the HEALTHCHECK section the docs say:

--retries=N (default: 3)

What isn't clear is if you want to disable retries, should you set this to 0 or 1. i.e. does the first attempt count as a "try" or a "retry"? 😄

Looks like per our observations and this code that anything less than 1 is ignored and triggers the default. Would be great to have this documented.

Here is a suggestion of how it could look:

Note: This value must be 1 or higher. Any value of 0 or lower will be ignored. To fail the health check on the first attempt, set it to 1.

File: engine/reference/builder.md

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.