Skip to content

update installation document of docker for Windows 10 in 2018#23

Open
hoshimado wants to merge 5 commits intovvakame:masterfrom
hoshimado:windows10-2018-docker-doc
Open

update installation document of docker for Windows 10 in 2018#23
hoshimado wants to merge 5 commits intovvakame:masterfrom
hoshimado:windows10-2018-docker-doc

Conversation

@hoshimado
Copy link
Copy Markdown

Windows用の手引き「WindowsでDocker+Re:VIEWを使う」の、WSL+Docker for Ubuntu版を作成してみました。

2018年春の「Windows 10 April Update 2018」にてWSL上でDocker Daemon動作がサポートされたことを受けて(※1)、Windows 10 Home上で仮想環境【無し】に「Re:VIEW image for Docker」を実行できるようになったので(※2)、その手順を記載しています。README.md からのリンクもこちらにしてみました。

なお、ベースとした windows-review.md は、次の観点からそのまま残しています。

  • Windows8と7環境向け
  • docker-composeの利用

※1:Background Task Support in WSL – Windows Command Line Tools For Developers
https://blogs.msdn.microsoft.com/commandline/2017/12/04/background-task-support-in-wsl/

※2:docker is running natively on wsl - Reddit
https://www.reddit.com/r/bashonubuntuonwindows/comments/8cvr27/docker_is_running_natively_on_wsl/

@vvakame
Copy link
Copy Markdown
Owner

vvakame commented Aug 16, 2018

気がつくのが遅れました…
@kmuto どうでしょうか?

@kmuto
Copy link
Copy Markdown
Collaborator

kmuto commented Aug 16, 2018

どうしましょうか、細かな文言は気になるところが多いですが、入れてから編集する?


本ドキュメントでは、Windows 10上で「Windows Subsystem for Linux」と「Re:VIEW image for Docker」を利用し、Re:VIEWドキュメントからPDFおよびEPUBを生成する方法を紹介します。Dockerコンテナを利用することで、reviwe動作環境を容易に構築できます。

Windows 10以前の環境では、「LatexとRuby、そしてReivewを直接Windows上にインストールする」方法をお勧めします。こちらの方法についてはGoogleにて「Windows Latex Ruby Review」のキーワードで検索すると、良記事が見つかると思います(2018年1月以降の記事をお勧めします)。
Copy link
Copy Markdown
Owner

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Windows 10以前の環境ではこちらを参考に作業するとよいでしょう。

でよい気がします。

@@ -0,0 +1,276 @@
# WindowsでDocker+Re:VIEWを使う
Copy link
Copy Markdown
Owner

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

もう片方と同じタイトルはちょっと嫌なので Windows+WSLでDocker+Re:VIEWを使う とかが良い気がします

dockder が正しくセットアップされたの確認のため、以下のコマンドを実行してHello Worldのイメージを起動してみます。

```
sudo docker run hello-world
Copy link
Copy Markdown
Owner

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

この辺ってsudoいるんですかね?(以下dockerコマンド利用箇所すべてにおいて同じ

Copy link
Copy Markdown
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

すみません、今しがた再確認したところ「sudo は不要」でした。>以下dockerコマンド利用箇所すべて
(移動中なので、取り急ぎここだけ見ました)

Re:VIEW image for Dockerの取得します。ここでは「review 2.5」を例にコマンドを例示します。以下のコマンドを実行します。

```sh
shdo docker pull vvakame/review:2.5
Copy link
Copy Markdown
Owner

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

s/shdo/sudo/


## Re:VIEW image for Dockerのダウンロードと展開

Re:VIEW image for Dockerの取得します。ここでは「review 2.5」を例にコマンドを例示します。以下のコマンドを実行します。
Copy link
Copy Markdown
Owner

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

バージョン指定無しで解説してしまってもよい気がします @kmuto どうでしょうか…

![Re:VIEW image for Dockerの取得](windows-img/win10-docker-review3-review.png)


ダウンロードが終わりましたら、以下のコマンドを実行して、Reviewのバージョンを表示します。
Copy link
Copy Markdown
Owner

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

s/Review/Re:VIEW/ ですね。同様の箇所が複数あるように思います。

$ exit
```

ここで、「$」マークの行はWSL上のコマンドラインを意味します。「#」マークの行は、docker上のコマンドラインを意味します(※実行時には、「$」も「#」も入力しません)。
Copy link
Copy Markdown
Owner

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Dockerのセットアップ の節が初出だと思います。そっちと表記があってないのはちょっと気になる…

@vvakame
Copy link
Copy Markdown
Owner

vvakame commented Aug 16, 2018

リポジトリ内にドキュメントを入れてしまうよりwikiに置いたほうがいい気もしますね… 🤔
ドキュメントメンテするたびにdocker hub側でautomated build走るのも若干アレですし

@kmuto
Copy link
Copy Markdown
Collaborator

kmuto commented Aug 16, 2018

ただ、wikiだと編集が面倒なのがちとアレですね。

@vvakame
Copy link
Copy Markdown
Owner

vvakame commented Aug 16, 2018

なんかめんどくさ要素あるんでしたっけ…(GitHubのwikiほとんど使ったことないマンです

@vvakame
Copy link
Copy Markdown
Owner

vvakame commented Aug 16, 2018

とりあえず作ってみました
https://github.com/vvakame/docker-review/wiki

とりあえずgit cloneしてcommitしてpushもできそうです
https://github.com/vvakame/docker-review.wiki.git

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants