Как установить справочные страницы докера на Mac OS

Question

Я установил Docker на Mac OS, как написано в документации.

Но в некоторых документах (например, в книге докеров) я вижу рекомендации по использованию man docker-run (man docker-pull, так далее).

Но когда я запускаю такую ​​команду, я получаю ошибку:

bessarabov@bessarabov-osx:~$ man docker
No manual entry for docker

Как я могу установить док-документацию man в мою систему Mac OS?

Answer 1

Начиная с 2017.06.01, вы должны сделать заказ нужного тега / версии с

• версия >= 17.06: https://github.com/docker/docker-ce
• версия < 17.06: https://github.com/moby/moby

а затем перейти к components/cli каталог и выполнить:

make -f docker.Makefile manpages

Чтобы добавить manpages в manpath:

echo "MANPATH $PWD/man" | sudo tee -a /private/etc/man.conf

Источник: https://github.com/docker/cli/issues/217

Answer 2

Похоже, что докер немного изменился с момента ответа@Sergiy. Вот немного обновленная версия, которая работала для меня.

git clone https://github.com/docker/docker.git
cd docker/man                      # looks like the directory has moved up
docker build -t docker/md2man .    # don't forget the '.'
docker run -v $PWD/:/docs:rw -w /docs -i docker/md2man /docs/md2man-all.sh
sudo cp -R man* /usr/share/man/    # you'll likely need sudo access for this
man docker                         # check it worked

Answer 3

До тех пор, пока проблема не будет решена, вы можете создавать man-страницы вручную через Docker-контейнер, используя прилагаемый Dockerfile, а затем просто копировать сгенерированные файлы в /usr/share/man/:

# Step 1: checkout docker sources, but make sure you do this
# somewhere in /Users directory because boot2docker can only
# share this path with docker containers
git clone https://github.com/docker/docker.git

# Step 2: build docker image  
cd docker/docs/man
docker build -t docker/md2man .

# Step 3: build man pages
docker run -v /Users/<path-to-git-dir>/docker/docs/man:/docs:rw \
-w /docs -i docker/md2man /docs/md2man-all.sh

# Step 4: copy generated man pages to /usr/share/man
cp -R man* /usr/share/man/

Наслаждайтесь!

Answer 4

Кажется, что биты go/glide под docker/md2man изменились с момента ответа @gilly. Что я в итоге делал в Mac OS:

cd /usr/local
git clone https://github.com/docker/docker.git
brew install ruby
gem install md2man
cd docker/man
mkdir man1; for i in *.1.md; md2man-roff $i > man1/${i%.md}; done
cd /usr/local/share/man/man1
for i in ../../../docker/man/man1/*.1; do ln -s $i .; done