search

docker / docs

Source repo for Docker's Documentation
https://docs.docker.com
Apache License 2.0
4.19k stars 7.35k forks source link

update ucp storage requirements for /var/lib/kubelet ephemeral storage #8378

Closed trapier closed 5 years ago

trapier commented 5 years ago

Problem description

UCP system requirements currently indicate minimum requirements:

  • 4GB of free disk space for the /var partition for manager nodes
  • 500MB of free disk space for the /var partition for worker nodes

I see a couple issues with this:

  1. Units. Should be base-2 GiB and MiB.
  2. Experience suggests when a manager reaches 4GiB-1B or a worker reaches 500MiB-1B, pods get evicted. So the currently documented minimum requirement is actually a dysfunctional state.
  3. Precision of filesystem path. The operative path is actually /var/lib/kubelet, which is quite often on a different filesystem than /var.

Problem location

https://docs.docker.com/ee/ucp/admin/install/system-requirements/#minimum-requirements

Project version(s) affected

Suggestions for a fix

Note: IANA UCP development engineer. Please get a technical :+1: from one on the following (would be required for #4).

  1. Change units to GiB and MiB or otherwise indicate that units are base-2 not base-10.
  2. Change minimum requirement to current_minimum + 1 GiB for managers and workers.
  3. Express requirement as applying to specific path /var/lib/kubelet.
  4. (For @ericsmalling): identify and document a recommendation as well as a minimum

/cc https://success.docker.com/article/kublet-restarting-after-upgrade-to-universal-control-plane-31

trapier commented 5 years ago

/cc @david-yu

trapier commented 5 years ago

/cc @quadespresso @shantiallamudi

paigehargrave commented 5 years ago

@trapier I created #8385 as a start - PTAL. Thank you for bringing this forward!

paigehargrave commented 5 years ago

@trapier @quadespresso @shantiallamudi Hi all - I've merged #8385 - please let me know if additional changes are needed or if we can close this issue - thank you!

quadespresso commented 5 years ago

LGTM

paigehargrave commented 5 years ago

@quadespresso Thank you! I'm going to close this....

docker-robott commented 1 year ago

Closed issues are locked after 30 days of inactivity. This helps our team focus on active issues.

If you have found a problem that seems similar to this, please open a new issue.

/lifecycle locked