2016-01-27 3 views
3

Кто-нибудь знает, как dockerhub управляет описанием в автоматических хранилищах сборки?Dockerhub Repository Описание

Dockerhub имеет прекрасную возможность, что README.md из исходного репозитория принимается за описание репозитория. На практике описание репозитория не всегда является последним README.md из ведущей ветки. Он кажется довольно случайным или связан с последними сборками.

Пример Repository:

  • /
  • Dockerfile
  • README.md

Отрасль:

  • мастер

Тэги:

  • V1.0
  • V1.1
  • V2.0
  • V2.1

Теперь проблема: Если я ставлю все метки на AutoBuild затем он не воспроизводится, если README.md будет отображаться в описании репозиториев.

Есть ли там трюк или есть API, где я могу установить описание?

Мое желание состоит в том, чтобы всегда отображалась последняя фиксация моего хозяина/README.md!

ответ

6

DockerHub doc упоминает:

процесс Билд ищет README.md в том же каталоге, что и Dockerfile.

(смотри, например, tombatossals/dockerhub/nodejs)

Если у вас есть README.md файл в хранилище, он используется в хранилище, полное описание.

Если вы измените полное описание после сборки, оно будет перезаписано при следующем запуске Automated Build.
Чтобы внести изменения, измените README.md в своем репозитории Git.

Примечание: mentioned here от Andy, это не работает для ручной сборки.

Для ручной сборки (где вы нажимаете собственное изображение), Docker Hub не заглядывает внутрь вашего изображения и не имеет возможности узнать о вашем Readme.
Вам необходимо вручную добавить текст Readme в раздел Information.


ОП спрашивает:

Есть ли API вызова, где я могу установить описание репо?

Не то, что я знаю (Docker Hub API was deprecated in docker 1.8+)


Issue 467 сообщает ту же неопределенность:

Иногда автоматизированная система сборки будет по-прежнему использовать файл верхнего уровня README.

issue 402 И сообщает:

«Каждый раз в то время, содержание в Полное описание и Dockerfile страница будет от старого тега выпуска.»

И потом:

«имеет спецификацию вытягивать README s изменился Это теперь занимает верхний уровень README из репозитория, а не из каталога, в котором Dockerfile указан, учитывая, а? обычный вариант использования - это хранилище Dockerfiles, это полностью испортило документацию ».

Issue 300 подтверждает:

Я заметил два очевидных недостатков здесь:

  • A) README.md не соблюдается в подкаталоге, где Dockerfile является
  • б) Даже если README.md находится на верхнем уровне repoository (а также файл Docker), «иногда» он не читается в и описание остается пустым; даже после того, как сила подталкивается к базовому репозиторию.
+0

Спасибо за ваш ответ, но у меня есть несколько тегов и ветвей, и README.md кажется случайным в этом контексте. Как я могу это контролировать? – blacklabelops

+0

@maybeg - это ваш README возле вашего Dockerfile? – VonC

+0

Readme находится рядом с файлом Docker в той же папке. – blacklabelops