diff --git a/index.rst b/index.rst index 507edd022..682e74840 100644 --- a/index.rst +++ b/index.rst @@ -75,11 +75,13 @@ Doc v1.10 目次 ==================== .. toctree:: - :caption: 始めましょう + :caption: Docker を始めましょう - 導入ガイド :hidden: + linux/toc.rst windows/toc.rst - + mac/toc.rst + .. toctree:: :caption: Docker Engine :hidden: diff --git a/linux/index.rst b/linux/index.rst new file mode 100644 index 000000000..99a1b86e2 --- /dev/null +++ b/linux/index.rst @@ -0,0 +1,64 @@ +.. -*- coding: utf-8 -*- +.. https://docs.docker.com/linux/ +.. doc version: 1.10 +.. check date: 2016/4/13 +.. ----------------------------------------------------------------------------- + +.. Get Started with Docker Engine for Linux + +======================================== +Linux への Docker Engine 導入ガイド +======================================== + +.. sidebar:: 目次 + + .. contents:: + :depth: 3 + :local: + +.. This is written for users of Linux distribution such as Ubuntu. If you are not using Linux, see the Windows or Mac OS X version. + +このページは Ubuntu のような Linux ディストリビューションのユーザ向けです。Linux を使っていないのであれば :doc:`Windows ` または :doc:`Mac OS X ` のページをご覧ください。 + +.. This getting started is for non-technical users who are interested in learning about Docker. By following this getting started, you’ll learn fundamental Docker features by performing some simple tasks. You’ll learn how to: + +この導入ガイドは、技術者ではなくとも Docker を学ぶことに興味のある方を対象としています。導入ガイドでは、簡単な作業を通して Docker 機能の基本を学びます。導入ガイドで学ぶ内容は： + +.. install Docker Engine + use Docker Engine to run a software image in a container + browse for an image on Docker Hub + create your own image and run it in a container + create a Docker Hub account and an image repository + create an image of your own + push your image to Docker Hub for others to use + +* Docker ツールボックスを使って Docker ソフトウェアをインストールします。 +* Docker エンジンを使い、コンテナ内でイメージを実行します。 +* Docker Hub 上でイメージを探します。 +* イメージを取得し、コンテナとして実行します。 +* Docker Hub アカウントとイメージ・リポジトリを作成します。 +* イメージを作成します。 +* 誰でも使えるように Docker Hub にイメージを送信します。 + +.. The getting started was user tested to reduce the chance of users having problems. For the best chance of success, follow the steps as written the first time before exploring on your own. It takes approximately 45 minutes to complete. + +この導入ガイドは、進める上で発生する問題が減るようにテストを経ています。自分自身で色々試すよりも、次のステップに進む方が、成功へのチャンスになります。完了するまでにかかる時間は約45分です。 + +.. Make sure you understand… + +ご確認ください +==================== + +.. This getting started uses Docker Engine CLI commands entered on the commandline of a terminal window. You don’t need to be experienced using a command line, but you should be familiar with how to open one and type commands. + +この導入ガイドでは、Docker エンジンのコマンドライン・ツール（CLI）を Windows 端末上で使います。コマンドラインを使ったことがなくても構いませんが、コマンドラインの開き方やコマンドの入力方法に慣れておいた方が良いでしょう。 + +.. Go to the next page to install. + +:doc:`次のインストールのページ ` に移動します。 + + +.. seealso:: + + Get Started with Docker Engine for Linux + https://docs.docker.com/linux/ diff --git a/linux/last_page.rst b/linux/last_page.rst new file mode 100644 index 000000000..1347ce55e --- /dev/null +++ b/linux/last_page.rst @@ -0,0 +1,34 @@ +.. -*- coding: utf-8 -*- +.. https://docs.docker.com/linux/last_page/ +.. doc version: 1.10 +.. check date: 2016/4/13 +.. ----------------------------------------------------------------------------- + +.. Learning more + +.. _linux-learning-more: + +======================================== +更に学ぶには +======================================== + +.. Depending on your interest, the Docker documentation contains a wealth of information. Here are some places that might interest you: + +皆さんの興味に応じた、豊富な Docker のドキュメントがあります。 + +.. Information about the Docker product line. The product explainer is a good place to start. + +* Docker プロダクト郡についての情報を知りたい場合。 + + * `各プロダクトの紹介ページ（英語） `_ + +.. Set up an automated build on Docker Hub. The Docker Hub documentation. + +* Docker Hub で自動構築（automated build）を使いたい場合。 + + * :doc:`Docker Hub ドキュメント ` + +.. seealso:: + + Learning more + https://docs.docker.com/linux/last_page/ diff --git a/linux/step_five.rst b/linux/step_five.rst new file mode 100644 index 000000000..ba56a8d92 --- /dev/null +++ b/linux/step_five.rst @@ -0,0 +1,135 @@ +.. -*- coding: utf-8 -*- +.. https://docs.docker.com/linux/step_five/ +.. doc version: 1.10 +.. check date: 2016/4/13 +.. ----------------------------------------------------------------------------- + +.. Crate a Docker Hub account & repository + +.. _create-a-docker-hub-account-and-repository-linux: + +======================================== +Docker Hub アカウントとリポジトリの作成 +======================================== + +.. sidebar:: 目次 + + .. contents:: + :depth: 3 + :local: + +.. You’ve built something really cool, you should share it. In this next section, you’ll do just that. You’ll need a Docker Hub account. Then, you’ll push your image up to it so other people with Docker Engine can run it. + +良い感じに構築できましたので、次は共有しましょう。このセクションでは共有を扱います。そのためには Docker Hub アカウントが作成です。そしてイメージをアップロードすると、Docker Engine を持つ他の人も実行できるようになります。 + +.. Step 1: Sign up for an account + +.. _step-1-sign-up-for-an-account-linux: + +ステップ１：アカウントの登録（サインアップ） +================================================== + +.. Use your browser to navigate to the Docker Hub signup page. + +1. ブラウザで `Docker Hub のサインアップ・ページ `_ を開きます。　 + +.. Your browser displays the page. + +ブラウザには次のページが表示されます。 + +.. image:: /tutimg/hub_signup.png + :scale: 60% + :alt: Docker Hub + +.. Fill out the form on the signup page. + +2. サインアップ・ページのフォームを入力します。 + +.. Docker Hub is free. Docker does need a name, password, and email address. + +Docker Hub は無料で使えます。登録にはユーザ名、パスワード、メールアドレスが必要です。 + +.. Press Signup. + +3. Signup（サインアップ）を押します。 + +.. The browser displays the welcome to Docker Hub page. + +ブラウザには Docker Hub のウェルカム・ページが表示されます。 + +.. Step 2: Verify your email and add a repository + +.. _step-2-verify-your-email-and-add-a-repository-linux: + +ステップ２：メールアドレスの確認とリポジトリの追加 +================================================== + +.. Before you can share anything on the hub, you need to verify your email address. + +何かを Docker Hub 上で共有する前に、メールアドレスの確認が必要です。 + +.. Open your email inbox. + +1. メールの受信箱を確認します。 + +.. Look for the email titled Please confirm email for your Docker Hub account. + +2. メールのタイトル ``Please confirm email for your Docker Hub account`` （Docker Hub アカウントのメールアドレスをご確認ください）を探します。 + +.. If you don’t see the email, check your Spam folder or wait a moment for the email to arrive. + +メールが届いていなければ、迷惑メール用のフォルダに入っていないか確認するか、メールが到着するまでお待ちください。 + +.. Open the email and click the Confirm Your Email button. + +3. メールの本文にあるボタンをクリックし、メールアドレスの確認を済ませます。 + +.. The browser opens Docker Hub to your profile page. + +ブラウザで Docker Hub のページを開くと、自分のプロフィール・ページが表示されます。 + +.. Choose Create Repository. + +4. Create Repository（リポジトリの作成）をクリックします。 + +.. The browser opens the Create Repository page. + +ブラウザは新しいリポジトリ作成ページを開きます。 + +.. Provide a Repository Name and Short Description. + +5. リポジトリ名と簡単な説明を背追加します。 + +.. Make sure Visibility is set to Public. + +6. Visibility（可視性）は Public （公開）に指定します。 + +.. When you are done, your form should look similar to the following: + +作成するには、次の画面のように入力します。 + +.. image:: /tutimg/add_repository.png + +.. Press Create when you are done. + +7. Create を押すと作業完了です。 + +.. Docker Hub creates your new repository. + +Docker Hub で新しいリポジトリを作成しました。 + +.. Where to go next + +次は何をしますか +==================== + +.. On this page, you opened an account on Docker Hub and created a new repository. In the next section, you populate the repository by tagging and pushing the image you created earlier. + +このページでは Docker Hub 上にアカウントを開設し、新しいリポジトリを追加しました。次のセクションではリポジトリに送信するため、 :doc:`先ほど作成したイメージにタグを付けて送信 ` します。 + +.. seealso:: + + Create a Docker Hub account & repository + https://docs.docker.com/linux/step_five/ + + diff --git a/linux/step_four.rst b/linux/step_four.rst new file mode 100644 index 000000000..f06fb30a4 --- /dev/null +++ b/linux/step_four.rst @@ -0,0 +1,315 @@ +.. -*- coding: utf-8 -*- +.. https://docs.docker.com/linux/step_four/ +.. doc version: 1.10 +.. check date: 2016/4/13 +.. ----------------------------------------------------------------------------- + +.. Build your own image + +.. _build-your-own-image-linux: + +======================================== +自分でイメージを構築 +======================================== + +.. sidebar:: 目次 + + .. contents:: + :depth: 3 + :local: + +.. The whalesay image could be improved. It would be nice if you didn’t have to think of something to say. And you type a lot to get whalesay to talk. + +``whalesay`` イメージは更に改良できます。もしかすると、何も喋らせたくないかもしれません。あるいは、もっと喋らせることもできます。 + +.. code-block:: bash + + docker run docker/whalesay cowsay boo-boo + +.. In this next section, you will improve the whalesay image by building a new version that “talks on its own” and requires fewer words to run. + +このセクションでは ``whalesay`` イメージを改良します。（オプションを指定しなくても）「自分で何かシャベル」新しいバージョンのイメージを作成します。実行に必要なのは、ほんの少しの単語です。 + +.. Step 1: Open a Docker Quickstart Terminal + +.. _step-1-open-a-docker-quickstart-terminal-linux: + +ステップ１：Docker クイックスタート・ターミナルを開く +============================================================ + +.. In this step, you use your favorite text editor to write a short Dockerfile. A Dockerfile describes the software that is “baked” into an image. It isn’t just ingredients tho, it can tell the software what environment to use or what commands to run. Your recipe is going to be very short. + +このステップでは、任意のテキストエディタを使い短い Dockerfile を書きます。Dockerfile にはイメージを構成するソフトウェア要素を記述します。Dockerfile は単に素材を記述するだけではありません。どのような環境を使うかや、コンテナの中で実行するコマンドも記述できます。今回の Dockerfile は非常に短いものです。 + +.. Go back to your terminal window. + +1. ターミナル・ウインドウに戻ります。 + +.. Make a new directory by typing mkdir mydockerbuild and pressing RETURN. + +2. 新しいディレクトリを作成するため、 ``mkdir mydockerbuild`` を入力してリターンキーを押します。 + +.. code-block:: bash + + $ mkdir mydockerbuild + +.. This directory serves as the “context” for your build. The context just means it contains all the things you need to build your image. + +このディレクトリは構築時の「コンテクスト」（context；内容物）の役割があります。このコンテクストとは、イメージを構築するために必要な全てを指します。 + +.. Change to your new directory. + +3. 新しいディレクトリに移動します。 + + $ cd mydockerbuild + +.. Right now the directory is empty. + +この時点でディレクトリには何もありません。 + +.. Create a text file called Dockerfile in your current directory. + +4. 現在のディレクトリに ``Dockerfile`` という名称のテキストファイルを作成します。 + +.. You can use any text editor for example, vi or nano to do this. + +``vi`` や ``nano`` などの任意のテキストエディタを使えます。 + +.. Open your Dockerfile file. + +5. Dockerfile ファイルを開きます。 + +.. Add a line to the file like this: + +6. 次のように行を追加します。 + +.. code-block:: bash + + FROM docker/whalesay:latest + +.. The FROM keyword tells Docker which image your image is based on. You are basing your new work on the existing whalesay image. + +``FROM`` キーワードは Docker に対してイメージの元となるイメージを伝えます。これから作成する新しいイメージは、既存の ``whalesay`` イメージを使います。 + +.. Now, add the fortunes program to the image. + +7. 次はイメージに ``fortunes`` プログラムを追加します。 + +.. code-block:: bash + + RUN apt-get -y update && apt-get install -y fortunes + +.. The fortunes program has a command that prints out wise sayings for our whale to say. So, the first step is to install it. This line installs the software into the image. + +``fortunes`` プログラムは賢そうなことを表示するプログラムです。これを今回のこの鯨プログラムに喋らせます。そのため、最初のステップはソフトウェアのインストールです。 + +.. Once the image has the software it needs, you instruct the software to run when the image is loaded. + +8. イメージに必要なソフトウェアをインストールしたら、イメージの読み込み時に実行するソフトウェアを命令します。 + +.. code-block:: bash + + CMD /usr/games/fortune -a | cowsay + +.. This line tells the fortune program to send its nifty quotes to the cowsay program. + +この行は ``fortune`` プログラム（の結果）を、気の利いたことを喋る ``cowsay`` プログラムに送ります。 + +.. Check your work, your file should look like this: + +9. これまでの作業内容を確認します。ファイルは次のようになっているでしょう。 + +.. code-block:: bash + + FROM docker/whalesay:latest + RUN apt-get -y update && apt-get install -y fortunes + CMD /usr/games/fortune -a | cowsay + +.. Save and close your Dockerfile. + +10. Dockerfile を保存して閉じます。 + +.. At this point, you have all your software ingredients and behaviors described in a Dockerfile. You are ready to build a new image. + +以上で Dockerfile 中にソフトウエア全ての要素と挙動を記述しました。これで新しいイメージを構築する準備が整いました。 + +.. Step 2: Build an image from your Dockerfile + +.. _step-2-build-an-image-from-your-dockerfile-linux: + +ステップ２：Dockerfile を使ってイメージ構築 +================================================== + +.. Now, build your new image by typing the docker build -t docker-whale . command in your terminal (don’t forget the . period). + +1. 次は新しいイメージを構築するため ``docker build -t docker-whale .`` コマンドをターミナル上で実行します（最後にピリオド ``.`` を忘れないでください）。 + +.. code-block:: bash + + $ docker build -t docker-whale . + Sending build context to Docker daemon 158.8 MB + ...省略... + Removing intermediate container a8e6faa88df3 + Successfully built 7d9495d03763 + +.. The command takes several seconds to run and reports its outcome. Before you do anything with the new image, take a minute to learn about the Dockerfile build process. + +このコマンドを実行すると、結果が出るまで数秒ほどかかります。この新しいイメージを使う前に、Dockerfile の構築時の流れを学びましょう。 + +.. Step 3: Learn about the build process + +.. _step-3-learn-about-the-build-process-linux: + +ステップ３：構築時の流れを学ぶ +============================== + +.. The docker build -t docker-whale . command takes the Dockerfile in the current directory, and builds an image called docker-whale on your local machine. The command takes about a minute and its output looks really long and complex. In this section, you learn what each message means. + +``docker build -t docker-whale .`` コマンドは現在のディレクトリ内にある ``Dockerfile`` を使います。そして、自分のマシン上に ``docker-whale`` という名称のイメージを構築します。コマンドの処理には少し時間がかかります。処理結果の表示は少し複雑に見えるでしょう。このセクションでは、各メッセージの意味を学びます。 + +.. First Docker checks to make sure it has everything it needs to build. + +まず Docker は構築時に必要な全てを確認します。 + +.. code-block:: bash + + Sending build context to Docker daemon 158.8 MB + +.. Then, Docker loads with the whalesay image. It already has this image locally as you might recall from the last page. So, Docker doesn’t need to download it. + +それから Docker は ``whalesay`` イメージを読み込みます。読み込むイメージは、先ほどのステップで既にローカルにあります。そのため、Docker は改めてダウンロードしません。 + +.. code-block:: bash + + Step 0 : FROM docker/whalesay:latest + ---> fb434121fc77 + +.. Docker moves onto the next step which is to update the apt-get package manager. This takes a lot of lines, no need to list them all again here. + +Docker は次の行に移ります。 ``apt-get`` パッケージ・マネージャを更新します。ここでは多くのメッセージが表示されますが、表示されるのは初回だけです。 + +.. code-block:: bash + + Step 1 : RUN apt-get -y update && apt-get install -y fortunes + ---> Running in 27d224dfa5b2 + Ign http://archive.ubuntu.com trusty InRelease + Ign http://archive.ubuntu.com trusty-updates InRelease + Ign http://archive.ubuntu.com trusty-security InRelease + Hit http://archive.ubuntu.com trusty Release.gpg + ....snip... + Get:15 http://archive.ubuntu.com trusty-security/restricted amd64 Packages [14.8 kB] + Get:16 http://archive.ubuntu.com trusty-security/universe amd64 Packages [134 kB] + Reading package lists... + ---> eb06e47a01d2 + +.. Then, Docker installs the new fortunes software. + +それから、Docker は新しい ``fortunes`` ソフトウエアをインストールします。 + +.. code-block:: bash + + Removing intermediate container e2a84b5f390f + Step 2 : RUN apt-get install -y fortunes + ---> Running in 23aa52c1897c + Reading package lists... + Building dependency tree... + Reading state information... + The following extra packages will be installed: + fortune-mod fortunes-min librecode0 + Suggested packages: + x11-utils bsdmainutils + The following NEW packages will be installed: + fortune-mod fortunes fortunes-min librecode0 + 0 upgraded, 4 newly installed, 0 to remove and 3 not upgraded. + Need to get 1961 kB of archives. + After this operation, 4817 kB of additional disk space will be used. + Get:1 http://archive.ubuntu.com/ubuntu/ trusty/main librecode0 amd64 3.6-21 [771 kB] + ...snip...... + Setting up fortunes (1:1.99.1-7) ... + Processing triggers for libc-bin (2.19-0ubuntu6.6) ... + ---> c81071adeeb5 + Removing intermediate container 23aa52c1897c + +.. Finally, Docker finishes the build and reports its outcome. + +最後に Docker は構築の終了を画面に表示します。 + +.. code-block:: bash + + Step 3 : CMD /usr/games/fortune -a | cowsay + ---> Running in a8e6faa88df3 + ---> 7d9495d03763 + Removing intermediate container a8e6faa88df3 + Successfully built 7d9495d03763 + +.. Step 4: Run your new docker-whale + +.. _step-4-run-your-new-docker-whale-linux: + +ステップ４：新しい docker-whale を実行 +======================================== + +.. In this step, you verify the new images is on your computer and then you run your new image. + +このステップではコンピュータ上にイメージがあるかどうか確認してから、新しいイメージを実行します。 + +.. If it isn’t already there, place your cursor at the prompt in your terminal window. + +1. ターミナル・ウインドウ上でなければ、画面にカーソルを合わせます。 + +.. Type docker images and press RETURN. + +2. ``docker images`` を実行してリターンキーを押します。 + +.. This command, you might remember, lists the images you have locally. + +このコマンドはローカルにあるイメージの一覧を表示します。覚えておくと良いでしょう。 + +.. code-block:: bash + + $ docker images + REPOSITORY TAG IMAGE ID CREATED VIRTUAL SIZE + docker-whale latest 7d9495d03763 4 minutes ago 273.7 MB + docker/whalesay latest fb434121fc77 4 hours ago 247 MB + hello-world latest 91c95931e552 5 weeks ago 910 B + +.. Run your new image by typing docker run docker-whale and pressing RETURN. + +3. 新しいイメージを実行します。``docker run docker-whale`` を入力して、エンターキーを押します。 + +.. code-block:: bash + + $ docker run docker-whale + _________________________________________ + / "He was a modest, good-humored boy. It \ + \ was Oxford that made him insufferable." / + ----------------------------------------- + \ + \ + \ + ## . + ## ## ## == + ## ## ## ## === + /""""""""""""""""___/ === + ~~~ {~~ ~~~~ ~~~ ~~~~ ~~ ~ / ===- ~~~ + \______ o __/ + \ \ __/ + \____\______/ + +.. As you can see, you’ve made the whale a lot smarter. It finds its own things to say and the command line is a lot shorter! You may also notice that Docker didn’t have to download anything. That is because the image was built locally and is already available. + +ご覧の通り、少し賢くなった鯨プログラムを作りました。コマンドラインで何かを自分で指定すると、それの表示もできます！ Docker は何もダウンロードしないことにも注目します。これはイメージをローカルで構築しており、ダウンロードする必要がないからです。 + +.. Where to go next + +次は何をしますか +==================== + +.. On this page, you learned to build an image by writing your own Dockerfile. You ran your image in a container. In the next section, you take the first step in sharing your image by creating a Docker Hub account. + +このページでは自分で Dockerfile を記述してイメージを構築する方法を学びました。そして、自分のイメージを使ってコンテナを実行しました。次のセクションではイメージを共有する第一歩として、 :doc:`Docker Hub アカウントを作成 ` します。 + +.. seealso:: + + Biuld your own image + https://docs.docker.com/linux/step_four/ diff --git a/linux/step_one.rst b/linux/step_one.rst new file mode 100644 index 000000000..94914407e --- /dev/null +++ b/linux/step_one.rst @@ -0,0 +1,115 @@ +.. -*- coding: utf-8 -*- +.. https://docs.docker.com/linux/step_one/ +.. doc version: 1.10 +.. check date: 2016/4/13 +.. ----------------------------------------------------------------------------- + +.. Install Docker + +.. _install-docker-linx: + +================================================== +Docker のインストール +================================================== + +.. sidebar:: 目次 + + .. contents:: + :depth: 3 + :local: + +.. This installation procedure is written for users who are unfamiliar with package managers. If you are comfortable with package managers, prefer not to use curl, or have problems installing and want to troubleshoot, please use our apt and yum repositories instead for your installation. + +以下の手順はパッケージ・マネージャに不慣れな方向けの内容です。パッケージ・マネージャに使い慣れているのであれば、 ``curl`` を使うことでインストールやトラブルシューティングの問題になるかもしれません。その場合は ``apt`` や ``yum`` の :doc:`リポジトリを使うインストール方法 ` をご覧ください。 + +.. Log into your Ubuntu installation as a user with sudo privileges. + +1. インストールする Ubuntu 環境に ``sudo`` 権限を持つユーザでログインします。 + +.. Verify that you have curl installed. + +2. ``curl`` がインストールされているか確認します。 + +.. code-block:: bash + + $ which curl + +.. If curl isn’t installed, install it after updating your manager: + +もしも ``curl`` が入っていなければ、マネージャの更新後にインストールします。 + +.. code-block:: bash + + $ sudo apt-get update + $ sudo apt-get install curl + +.. Get the latest Docker package. + +3. 最新の Docker パッケージを取得します。 + +.. code-block:: bash + + $ curl -fsSL https://get.docker.com/ | sh + +.. The system prompts you for your sudo password. Then, it downloads and installs Docker and its dependencies. + +``sudo`` パスワードの入力を求めるシステム・プロンプトが表示します。入力すると、 Docker と、その依存関係にあるパッケージをインストールします。 + +.. Note: If your company is behind a filtering proxy, you may find that the apt-key command fails for the Docker repo during installation. To work around this, add the key directly using the following: + +.. note:: + + 社内環境が制限されたプロキシ配下の場合、 Docker リポジトリのインストール中に ``apt-key`` コマンドの実行に失敗するかもしれません。正常に動かすためには、以下のように直接キーを追加します。 + +.. code-block:: bash + + $ curl -fsSL https://get.docker.com/gpg | sudo apt-key add - + +.. Verify docker is installed correctly. + +4. ``docker`` が正常にインストールされたことを確認します。 + +.. code-block:: bash + + $ docker run hello-world + Unable to find image 'hello-world:latest' locally + latest: Pulling from library/hello-world + 535020c3e8ad: Pull complete + af340544ed62: Pull complete + Digest: sha256:a68868bfe696c00866942e8f5ca39e3e31b79c1e50feaee4ce5e28df2f051d5c + Status: Downloaded newer image for hello-world:latest + + Hello from Docker. + This message shows that your installation appears to be working correctly. + + To generate this message, Docker took the following steps: + 1. The Docker Engine CLI client contacted the Docker Engine daemon. + 2. The Docker Engine daemon pulled the "hello-world" image from the Docker Hub. + 3. The Docker Engine daemon created a new container from that image which runs the + executable that produces the output you are currently reading. + 4. The Docker Engine daemon streamed that output to the Docker Engine CLI client, which sent it + to your terminal. + + To try something more ambitious, you can run an Ubuntu container with: + $ docker run -it ubuntu bash + + Share images, automate workflows, and more with a free Docker Hub account: + https://hub.docker.com + + For more examples and ideas, visit: + https://docs.docker.com/userguide/ + + +.. Where to go next + +次は何をしますか +==================== + +.. At this point, you have successfully installed Docker. Leave the terminal window open. Now, go to the next page to read a very short introduction Docker images and containers. + +以上で Docker のインストールが完了しました。画面は開いたままにします。次は :doc:`step_two` に進みます。 + +.. seealso:: + + Install Docker for Windows + https://docs.docker.com/linux/step_one/ diff --git a/linux/step_six.rst b/linux/step_six.rst new file mode 100644 index 000000000..33e17aeeb --- /dev/null +++ b/linux/step_six.rst @@ -0,0 +1,288 @@ +.. -*- coding: utf-8 -*- +.. https://docs.docker.com/linux/step_six/ +.. doc version: 1.10 +.. check date: 2016/4/13 +.. ----------------------------------------------------------------------------- + +.. Tag, push, and pull your image + +.. _tag-push-and-pull-your-image-linux: + +======================================== +イメージのタグ付け、送信、取得 +======================================== + +.. sidebar:: 目次 + + .. contents:: + :depth: 3 + :local: + +.. In this section, you tag and push your docker-whale image to your newly created repository. When you are done, you test the repository by pulling your new image. + +このセクションでは ``docker-whale`` イメージにタグを付け、先ほど作成した自分のリポジトリにイメージを送信します。作業が後は、自分の新しいイメージをリポジトリから取得できるか確認します。 + +.. Step 1: Tag and push the image + +.. _step-1-tag-and-push-the-image-linux: + +ステップ１：イメージのタグ付けと送信 +======================================== + +.. Go back to your terminal. + +1. ターミナルに戻ります。 + +.. List the images you currently have: + +2. 手許にあるイメージの一覧を表示します。 + +.. code-block:: bash + + $ docker images + REPOSITORY TAG IMAGE ID CREATED VIRTUAL SIZE + docker-whale latest 7d9495d03763 38 minutes ago 273.7 MB + 5dac217f722c 45 minutes ago 273.7 MB + docker/whalesay latest fb434121fc77 4 hours ago 247 MB + hello-world latest 91c95931e552 5 weeks ago 910 B + +.. Find the IMAGE ID for your docker-whale image. + +3. ``docker-whale`` イメージの ``イメージ ID`` を確認します。 + +.. In this example, the id is 7d9495d03763. + +この例では ID は ``7d9495d03763`` です。 + +.. Notice that currently, the REPOSITORY shows the repo name docker-whale but not the namespace. You need to include the namespace for Docker Hub to associate it with your account. The namespace is the same as your Docker Hub account name. You need to rename the image to YOUR_DOCKERHUB_NAME/docker-whale. + +現時点の ``REPOSITORY`` にあるリポジトリ名は ``docker-whale`` ですが、名前空間（namespace）がありません。名前空間は Docker Hub 上の自分のアカウントに関連付いています。この名前空間は自分の Docker Hub アカウント名と同じです。そのため、イメージを ``自分のアカウント名/docker-whale`` に名称変更する必要があります。 + +.. Use IMAGE ID and the docker tag command to tag your docker-whale image. + +4. ``docker tag`` コマンドと ``イメージ ID`` を指定し、 ``docker-whale`` イメージをタグ付けします。 + +.. The command you type looks like this: + +入力するコマンドは、次のような意味があります。 + +.. image:: /tutimg/tagger.png + +.. Of course, your account name will be your own. So, you type the command with your image’s ID and your account name and press RETURN. + +もちろん、アカウント名は自分自身のものです。そのため、イメージ ID やアカウント名は自分のものを入力し、リターンキーを押します。 + +.. code-block:: bash + + $ docker tag 7d9495d03763 maryatdocker/docker-whale:latest + +.. Type the docker images command again to see your newly tagged image. + +5. ``docker images`` コマンドをもう一度実行して、新しくタグ付けされたイメージがあるかどうか確認します。 + +.. code-block:: bash + + $ docker images + REPOSITORY TAG IMAGE ID CREATED VIRTUAL SIZE + maryatdocker/docker-whale latest 7d9495d03763 5 minutes ago 273.7 MB + docker-whale latest 7d9495d03763 2 hours ago 273.7 MB + 5dac217f722c 5 hours ago 273.7 MB + docker/whalesay latest fb434121fc77 5 hours ago 247 MB + hello-world latest 91c95931e552 5 weeks ago 910 B + +.. Use the docker login command to log into the Docker Hub from the command line. + +6. コマンドライン上で ``docker login`` コマンドを使い Docker Hub にログインします。 + +.. The format for the login command is: + +ログインコマンドの書式は次の通りです： + +.. code-block:: bash + + docker login --username=yourhubusername --email=youremail@company.com + +.. When prompted, enter your password and press enter. So, for example: + +入力を促すプロンプトが表示された、パスワードを入力してエンターを押します。実行例： + +.. code-block:: bash + + $ docker login --username=maryatdocker --email=mary@docker.com + Password: + WARNING: login credentials saved in C:\Users\sven\.docker\config.json + Login Succeeded + +.. Type the docker push command to push your image to your new repository. + +7. ``docker push`` コマンドを実行し、自分のイメージをリポジトリに送信します。 + +.. code-block:: bash + + $ docker push maryatdocker/docker-whale + The push refers to a repository [maryatdocker/docker-whale] (len: 1) + 7d9495d03763: Image already exists + c81071adeeb5: Image successfully pushed + eb06e47a01d2: Image successfully pushed + fb434121fc77: Image successfully pushed + 5d5bd9951e26: Image successfully pushed + 99da72cfe067: Image successfully pushed + 1722f41ddcb5: Image successfully pushed + 5b74edbcaa5b: Image successfully pushed + 676c4a1897e6: Image successfully pushed + 07f8e8c5e660: Image successfully pushed + 37bea4ee0c81: Image successfully pushed + a82efea989f9: Image successfully pushed + e9e06b06e14c: Image successfully pushed + Digest: sha256:ad89e88beb7dc73bf55d456e2c600e0a39dd6c9500d7cd8d1025626c4b985011 + +.. Return to your profile on Docker Hub to see your new image. + +8. 自分の Docker Hub のプロフィールページに戻ると、新しいイメージの情報が表示されます。 + +.. image:: /tutimg/new_image.png + :scale: 60% + +.. Step 2: Pull your new image + +.. _step-2-pull-your-new-image-linux: + +ステップ２：新しいイメージの取得 +======================================== + +.. In this last section, you’ll pull the image you just pushed to hub. Before you do that though, you’ll need to remove the original image from your local machine. If you left the original image on your machine. Docker would not pull from the hub — why would it? The two images are identical. + +この最後のセクションでは、Docker Hub に送信(push)したイメージを取得(pull)します。作業を進める前に、これまでローカルマシン上で作成したオリジナルのイメージを削除します。マシン上にオリジナルのイメージを残しておいたままでは、Docker は Docker Hub からイメージを取得しません。これは両方のイメージが同一と認識されるためです。 + +.. Place your cursor at the prompt in your erminal window. + +1. ターミナルのウインドウ上のプロンプトにカーソルを合わせます。 + +.. Type docker images to list the images you currently have on your local machine. + +2. ``docker images`` を入力し、ローカルマシン上にあるイメージの一覧を表示します。 + +.. code-block:: bash + + $ docker images + REPOSITORY TAG IMAGE ID CREATED VIRTUAL SIZE + maryatdocker/docker-whale latest 7d9495d03763 5 minutes ago 273.7 MB + docker-whale latest 7d9495d03763 2 hours ago 273.7 MB + 5dac217f722c 5 hours ago 273.7 MB + docker/whalesay latest fb434121fc77 5 hours ago 247 MB + hello-world latest 91c95931e552 5 weeks ago 910 B + +.. To make a good test, you need to remove the maryatdocker/docker-whale and docker-whale images from your local system. Removing them forces the next docker pull to get the image from your repository. + +テストを正しく行うため、ローカルのシステム上から ``maryatdocker/docker-whale`` と ``docker-whale`` イメージを削除します。次の ``docker pull`` コマンドを実行する前に、リポジトリからイメージを削除します。 + +.. Use the docker rmi to remove the maryatdocker/docker-whale and docker-whale images. + +3. ``docker rmi`` コマンドを使い、 ``maryatdocker/docker-whale`` と ``docker-whale`` イメージを削除します。 + +.. You can use an ID or the name to remove an image. + +イメージを削除するにはイメージ ID かイメージ名を使います。 + +.. code-block:: bash + + $ docker rmi -f 7d9495d03763 + $ docker rmi -f docker-whale + +.. Pull and load a new image from your repository using the docker run command. + +4. ``docker run`` コマンドを使い、リポジトリから新しいイメージの取得と読み込みます。 + +.. The command you type should include your username from Docker Hub. + +コマンド実行時、ユーザ名には Docker Hub 上の自分の名前を指定します。 + +.. code-block:: bash + + docker run 自分のユーザ名/docker-whale + +.. Since the image is no longer available on your local system, Docker downloads it. + +イメージがローカルホスト上にないため、Docker はイメージをダウンロードします。 + +.. code-block:: bash + + $ docker run maryatdocker/docker-whale + Unable to find image 'maryatdocker/docker-whale:latest' locally + latest: Pulling from maryatdocker/docker-whale + eb06e47a01d2: Pull complete + c81071adeeb5: Pull complete + 7d9495d03763: Already exists + e9e06b06e14c: Already exists + a82efea989f9: Already exists + 37bea4ee0c81: Already exists + 07f8e8c5e660: Already exists + 676c4a1897e6: Already exists + 5b74edbcaa5b: Already exists + 1722f41ddcb5: Already exists + 99da72cfe067: Already exists + 5d5bd9951e26: Already exists + fb434121fc77: Already exists + Digest: sha256:ad89e88beb7dc73bf55d456e2c600e0a39dd6c9500d7cd8d1025626c4b985011 + Status: Downloaded newer image for maryatdocker/docker-whale:latest + ________________________________________ + / Having wandered helplessly into a \ + | blinding snowstorm Sam was greatly | + | relieved to see a sturdy Saint Bernard | + | dog bounding toward him with the | + | traditional keg of brandy strapped to | + | his collar. | + | | + | "At last," cried Sam, "man's best | + \ friend -- and a great big dog, too!" / + ---------------------------------------- + \ + \ + \ + ## . + ## ## ## == + ## ## ## ## === + /""""""""""""""""___/ === + ~~~ {~~ ~~~~ ~~~ ~~~~ ~~ ~ / ===- ~~~ + \______ o __/ + \ \ __/ + \____\______/ + +.. Where to go next + +次は何をしますか +==================== + +.. You’ve done a lot, you’ve done all of the following fundamental Docker tasks. + +これで Docker の基本的なタスクを扱う全てが終了しました。 + +.. installed Docker + run a software image in a container + located an interesting image on Docker Hub + run the image on your own machine + modified an image to create your own and run it + create a Docker Hub account and repository + pushed your image to Docker Hub for others to share + +* Docker をインストールする。 +* コンテナでソフトウェアのイメージを実行する。 +* Docker Hub 上で興味あるイメージをさがす。 +* 自分のマシン上でイメージを実行する。 +* 実行するイメージに対する変更を加え、イメージを作成する。 +* Docker Hub 上のアカウントとリポジトリの作成。 +* 他の人と共有できるよう Docker Hub イメージを送信。 + +.. Tweet your accomplishment! + +`完了したことを Tweet しましょう！ `_ + +.. You’ve only scratched the surface of what Docker can do. Go to the next page to learn more. + +Docker ができることを詳しく知りたくありませんか。次のページから :doc:`より詳細を学びましょう ` 。 + +.. seealso:: + + Tag, push, and pull your image + https://docs.docker.com/linux/step_six/ + diff --git a/linux/step_three.rst b/linux/step_three.rst new file mode 100644 index 000000000..ee786b065 --- /dev/null +++ b/linux/step_three.rst @@ -0,0 +1,188 @@ +.. -*- coding: utf-8 -*- +.. https://docs.docker.com/linux/step_three/ +.. doc version: 1.10 +.. check date: 2016/4/13 +.. ----------------------------------------------------------------------------- + +.. Find and run the whalesay image + +.. _find-and-run-the-whalesay-image-linux: + +======================================== +whalesay イメージの実行 +======================================== + +.. sidebar:: 目次 + + .. contents:: + :depth: 3 + :local: + +.. People all over the world create Docker images. You can find these images by browsing the Docker Hub. In this next section, you’ll do just that to find the image to use in the rest of this getting started. + + you’ll do just that to find the image to use in the rest of this getting started. + +世界中の皆さんが Docker イメージを作成しています。これらのイメージを Docker Hub 上で閲覧できます。このセクションではイメージを使って見ましょう。 + +.. Step 1: Locate the whalesay image + +.. _step-1-locate-the-whalesay-image-linux: + +ステップ１：whalesay イメージを探す +======================================== + +.. Open your browser and browse to the Docker Hub. + +1. ブラウザを起動し、 `Docker Hub を開きます `_ 。 + +.. image:: /tutimg/browse_and_search.png + :scale: 60% + :alt: 開いて検索 + +.. The Docker Hub contains images from individuals like you and official images from organizations like RedHat, IBM, Google, and a whole lot more. + +Docker Hub には皆さんのような個人で作成したイメージと、何らかの組織、例えば RedHat、IBM、Googole 等が作成した公式イメージ（オフィシャル・イメージ）があります。 + +.. Click Browse & Search. + +2. ``Search`` をクリックします。 + +.. The browser opens the search page. + +ブラウザで検索ページを開きます。 + +.. Enter the word whalesay in the search bar. + +3. 検索バーに ``whalesay`` を入力します（訳者注： whalesay とは whale say = 鯨が話す、という意味です）。 + +.. image:: /tutimg/image_found.png + :scale: 60% + +.. Click on the docker/whalesay image in the results. + +.. 検索結果にある docker/whalesay イメージをクリックします。 + +.. The browser displays the repository for the whalesay image. + +ブラウザは whalesay イメージのリポジトリを表示します。 + +.. image:: /tutimg/whale_repo.png + :scale: 60% + +.. Each image repository contains information about an image. It should include information such as what kind of software the image contains and how to use it. You may notice that the whalesay image is based on a Linux distribution called Ubuntu. In the next step, you run the whalesay image on your machine. + +各イメージ・リポジトリにはイメージに関する情報が掲載されています。この中にはイメージにどのような種類のソフトウェアが入っているかや、どのように使うかについての説明があるでしょう。ここでは whalesay イメージが Ubuntu と呼ばれる Linux ディストリビューションをベースにしていることを覚えておきます。次のステップでは、自分のマシン上で whalesay イメージを実行しましょう。 + +.. Step 2: Run the whalesay image + +.. _step-2-run-the-whalesay-image-linux: + +ステップ２：whaysay イメージの実行 +================================== + +.. Put your cursor in your terminal window at the $ prompt. + +1. ターミナル・ウインドウの ``$`` プロンプトにカーソルを移動します。 + +.. Type the docker run docker/whalesay cowsay boo command and press RETURN. + +2. ``docker run docker/whalesay cowsay boo`` コマンドを入力し、リターンキーを押します。 + +.. This command runs the whalesay image in a container. Your terminal should look like the following: + +コマンドを実行すると、コンテナ内で whalesay イメージを実行します。ターミナル上では、次のように表示されるでしょう。 + +.. code-block:: bash + + $ docker run docker/whalesay cowsay boo + Unable to find image 'docker/whalesay:latest' locally + latest: Pulling from docker/whalesay + e9e06b06e14c: Pull complete + a82efea989f9: Pull complete + 37bea4ee0c81: Pull complete + 07f8e8c5e660: Pull complete + 676c4a1897e6: Pull complete + 5b74edbcaa5b: Pull complete + 1722f41ddcb5: Pull complete + 99da72cfe067: Pull complete + 5d5bd9951e26: Pull complete + fb434121fc77: Already exists + Digest: sha256:d6ee73f978a366cf97974115abe9c4099ed59c6f75c23d03c64446bb9cd49163 + Status: Downloaded newer image for docker/whalesay:latest + _____ + < boo > + ----- + \ + \ + \ + ## . + ## ## ## == + ## ## ## ## === + /""""""""""""""""___/ === + ~~~ {~~ ~~~~ ~~~ ~~~~ ~~ ~ / ===- ~~~ + \______ o __/ + \ \ __/ + \____\______/ + +.. The first time you run a software image, the docker command looks for it on your local system. If the image isn’t there, then docker gets it from the hub. + +``docker`` コマンドを手許（ローカル）のシステム上でソフトウエア・イメージを初めて実行しました。イメージが手許になければ、 ``docker`` は Docker Hub から取得します。 + +.. While still in the terminal, type docker images command and press RETURN. + +3. ターミナルを開いたまま ``docker images`` コマンドを入力してリターンキーを押します。 + +.. The command lists all the images on your local system. You should see docker/whalesay in the list. + +このコマンドは手許のシステム上にある全イメージを表示します。一覧に ``docker/whalesay`` イメージが見えるでしょう。 + +.. code-block:: bash + + $ docker images + REPOSITORY TAG IMAGE ID CREATED VIRTUAL SIZE + docker/whalesay latest fb434121fc77 3 hours ago 247 MB + hello-world latest 91c95931e552 5 weeks ago 910 B + +.. When you run an image in a container, Docker downloads the image to your computer. This local copy of the image saves you time. Docker only downloads the image again if the image’s source changes on the hub. You can, of course, delete the image yourself. You’ll learn more about that later. Let’s leave the image there for now because we are going to use it later. + +コンテナ内でイメージを実行する時、Docker は手許のコンピュータ上にイメージをダウンロードします。イメージのコピーを手許に作成するため、時間の節約になります。Docker がイメージをダウンロードするのは、 Docker Hub 上の元イメージに変更が加わった時のみです。もちろん、イメージは自分で削除もできます。詳細は後ほど学びます。この後もイメージを使うため、今はこのままにしておきます。 + +.. Take a moment to play with the whalesay container a bit. + +4. もう少し whalesay コンテナで遊んでみましょう。 + +.. Try running the whalesay image again with a word or phrase. Try a long or short phrase. Can you break the cow? + +``whalesay`` イメージを再度使いますが、今度は言葉を変えてみましょう。長い、もしくは短いフレーズに置き換えます。何かしら喋らせましたか？ + +.. code-block:: bash + + $ docker run docker/whalesay cowsay boo-boo + _________ + < boo-boo > + --------- + \ + \ + \ + ## . + ## ## ## == + ## ## ## ## === + /""""""""""""""""___/ === + ~~~ {~~ ~~~~ ~~~ ~~~~ ~~ ~ / ===- ~~~ + \______ o __/ + \ \ __/ + \____\______/ + +.. Where to go next + +次は何をしますか +==================== + +.. On this page, you learned to search for images on Docker Hub. You used your command line to run an image. You learned that running an image copies it on your computer. Now, you are ready to create your own Docker image. Go on to the next part to build your own image. + +このページでは Docker Hub 上のイメージを探す方法を学びました。そして、コマンドを使ってイメージを実行しました。自分のコンピュータ上にイメージをコピーし、実行する方法を学びました。次は自分で Docker イメージを作ってみましょう。次の :doc:`step_four` に進みます。 + +.. seealso:: + + Find and run the whalesay image + https://docs.docker.com/linux/step_three/ diff --git a/linux/step_two.rst b/linux/step_two.rst new file mode 100644 index 000000000..700112307 --- /dev/null +++ b/linux/step_two.rst @@ -0,0 +1,65 @@ +.. -*- coding: utf-8 -*- +.. https://docs.docker.com/linux/step_two/ +.. doc version: 1.10 +.. check date: 2016/4/13 +.. ----------------------------------------------------------------------------- + +.. Learn about images & containers + +.. _learn-about-images-containers-linux: + +======================================== +イメージとコンテナを学ぶ +======================================== + +.. sidebar:: 目次 + + .. contents:: + :depth: 3 + :local: + +.. Docker Engine provides the core Docker technology that enables images and containers. As the last step in your installation, you ran the Engine docker run hello-world command. With this one command, you completed the core tasks to using Engine. The command you ran had three parts. + +Docker Engine は Docker の中心となる技術を提供します。これはイメージとコンテナを扱う技術です。先ほどのステップでインストールを終えていますので、 ``docker run hello-world`` コマンドを実行できます。このコマンドを１つ実行するだけで、Engine を使う上で中心となるタスクをこなします。コマンドは３つのパーツに分かれています。 + +.. image:: /tutimg/container_explainer.png + :scale: 60% + :alt: docker run hello-world + +.. A container is a stripped-to-basics version of a Linux operating system. An image is software you load into a container. When you ran the command, the Engine Software: + +コンテナとは Linux オペレーティング・システムを基盤としています。イメージとはコンテナの中に取り込むソフトウェアです。コマンドを実行すると、Engine のソフトウェアは以下の処理を行います。 + +.. checked to see if you had the hello-world software image + downloaded the image from the Docker Hub (more about the hub later) + loaded the image into the container and “ran” it + +* ``hello-world`` ソフトウェアのイメージを持っているかどうか確認します。 +* Docker Hub （詳しくは後ほど説明）からイメージをダウンロードします。 +* コンテナにイメージを読み込み「実行」します。 + +.. Depending on how it was built, an image might run a simple, single command and then exit. This is what Hello-World did. + +イメージが何を実行するかは、どのように構築されたかに依存します。ここでは ``Hello-World`` を表示するという単純なコマンドを実行しています。 + +.. A Docker image, though, is capable of much more. An image can start software as complex as a database, wait for you (or someone else) to add data, store the data for later use, and then wait for the next person. + +Docker イメージによっては、様々な処理ができます。データベースのような複雑なソフトウェアも、イメージを使って実行できます。あなた（もしくは誰かが）データを追加するのに待つ必要はなく、保管したデータを使えますし、次の人もすぐに利用できます。 + +.. Who built the hello-world software image though? In this case, Docker did but anyone can. Docker Engine lets people (or companies) create and share software through Docker images. Using Docker Engine, you don’t have to worry about whether your computer can run the software in a Docker image — a Docker container can always run it. + +``hello-world`` ソフトウェアのイメージは、誰が作ったのでしょうか？ これは Docker が作りましたが、誰でも作れます。Docker Engine は人々（あるいは会社）が作成したソフトウェアを、 Docker イメージを通して共有できるようにします。 Docker Engine を使えば、Docker イメージ内のソフトウェアを実行するため、どのコンピュータを使えば良いのか迷う必要がなくなります。Docker コンテナは、どこでも実行できるのです。 + +.. Where to go next + +次は何をしますか +==================== + +.. See, that was quick wasn’t it? Now, you are ready to do some really fun stuff with Docker. Go on to the next part to find and run the whalesay image. + +ほら、迅速でしょう。これで Docker を使って何か面白いことをする準備が整いました。次の :doc:`step_three` に進みましょう。 + +.. seealso:: + + Learn about images & containers + https://docs.docker.com/linux/step_two/ diff --git a/linux/toc.rst b/linux/toc.rst new file mode 100644 index 000000000..2fbb63c34 --- /dev/null +++ b/linux/toc.rst @@ -0,0 +1,27 @@ +.. -*- coding: utf-8 -*- +.. +.. doc version: 1.10 +.. check date: 2016/04/05 +.. ----------------------------------------------------------------------------- + +.. Get Started with Docker toc + +以下は初心者向けの導入ガイドです。通常インストール用の詳細ドキュメントは :doc:`こちらのページ` をご覧ください。 + +======================================== +Linux +======================================== + +.. toctree:: + :maxdepth: 1 + :caption: Docker Engine for Linux 目次 + + index.rst + step_one.rst + step_two.rst + step_three.rst + step_four.rst + step_five.rst + step_six.rst + last_page.rst + diff --git a/mac/index.rst b/mac/index.rst new file mode 100644 index 000000000..3ef5178f1 --- /dev/null +++ b/mac/index.rst @@ -0,0 +1,64 @@ +.. -*- coding: utf-8 -*- +.. https://docs.docker.com/mac/ +.. doc version: 1.10 +.. check date: 2016/4/13 +.. ----------------------------------------------------------------------------- + +.. Get Started with Docker for Mac OS X + +======================================== +Mac OS X 導入ガイド +======================================== + +.. sidebar:: 目次 + + .. contents:: + :depth: 3 + :local: + +.. This is written for users of Mac OS X. If you are not using Mac OS X, see the Linux or Windows version. + +このページは Mac OS X ユーザ向けです。Mac OS X を使っていないのであれば :doc:`Linux ` または :doc:`Windows ` のページをご覧ください。 + +.. This getting started is for non-technical users who are interested in learning about Docker. By following this getting started, you’ll learn fundamental Docker features by performing some simple tasks. You’ll learn how to: + +この導入ガイドは、技術者ではなくとも Docker を学ぶことに興味のある方を対象としています。導入ガイドでは、簡単な作業を通して Docker 機能の基本を学びます。導入ガイドで学ぶ内容は： + +.. install Docker software using the Docker Toolbox + use Docker Engine to run a software image in a container + browse for an image on Docker Hub + create your own image and run it in a container + create a Docker Hub account and an image repository + create an image of your own + push your image to Docker Hub for others to use + +* Docker ツールボックスを使って Docker ソフトウェアをインストールします。 +* Docker エンジンを使い、コンテナ内でイメージを実行します。 +* Docker Hub 上でイメージを探します。 +* イメージを取得し、コンテナとして実行します。 +* Docker Hub アカウントとイメージ・リポジトリを作成します。 +* イメージを作成します。 +* 誰でも使えるように Docker Hub にイメージを送信します。 + +.. The getting started was user tested to reduce the chance of users having problems. For the best chance of success, follow the steps as written the first time before exploring on your own. It takes approximately 45 minutes to complete. + +この導入ガイドは、進める上で発生する問題が減るようにテストを経ています。自分自身で色々試すよりも、次のステップに進む方が、成功へのチャンスになります。完了するまでにかかる時間は約45分です。 + +.. Make sure you understand… + +ご確認ください +==================== + +.. This getting started uses Docker Engine CLI commands entered on the commandline of a terminal window. You don’t need to be experienced using a command line, but you should be familiar with how to open one and type commands. + +この導入ガイドでは、Docker エンジンのコマンドライン・ツール（CLI）を Windows 端末上で使います。コマンドラインを使ったことがなくても構いませんが、コマンドラインの開き方やコマンドの入力方法に慣れておいた方が良いでしょう。 + +.. Go to the next page to install. + +:doc:`次のインストールのページ ` に移動します。 + + +.. seealso:: + + Get Started with Docker for Mac OS X + https://docs.docker.com/mac/ diff --git a/mac/last_page.rst b/mac/last_page.rst new file mode 100644 index 000000000..67d5fb355 --- /dev/null +++ b/mac/last_page.rst @@ -0,0 +1,48 @@ +.. -*- coding: utf-8 -*- +.. https://docs.docker.com/mac/last_page/ +.. doc version: 1.10 +.. check date: 2016/4/13 +.. ----------------------------------------------------------------------------- + +.. Learning more + +.. mac-learning-more: + +======================================== +更に学ぶには +======================================== + +.. Depending on your interest, the Docker documentation contains a wealth of information. Here are some places that might interest you: + +皆さんの興味に応じた、豊富な Docker のドキュメントがあります。 + +.. If you are looking for Where to find it +.. This getting started provided very basic essentials for using Docker Engine on Mac OS X. If you want to do more with Docker Engine, start with the full installation and user guide for Docker Toolbox. Install Docker Toolbox + +* Mac OS X 上で Docker Engine を使うための基本を学びたい場合。Docker Engine を更に使うため、Docker Toolbox のユーザ・ガイドを使ってインストールしたい場合。 + + * :doc:`Toolbox のインストール ` + +.. Information about the Docker product line. The product explainer is a good place to start. + +* Docker プロダクト郡についての情報を知りたい場合。 + + * `各プロダクトの紹介ページ（英語） `_ + +.. Set up an automated build on Docker Hub. The Docker Hub documentation. + +* Docker Hub で自動構築（automated build）を使いたい場合。 + + * :doc:`Docker Hub ドキュメント ` + +.. Run a multi-container application with Compose The Docker Compose documentation. + +* Compose で複数のコンテナを扱うアプリケーションを実行したい場合。 + + * :doc:`/compose/gettingstarted` + + +.. seealso:: + + Learning more + https://docs.docker.com/mac/last_page/ diff --git a/mac/step_five.rst b/mac/step_five.rst new file mode 100644 index 000000000..6ba5f6764 --- /dev/null +++ b/mac/step_five.rst @@ -0,0 +1,135 @@ +.. -*- coding: utf-8 -*- +.. https://docs.docker.com/mac/step_five/ +.. doc version: 1.10 +.. check date: 2016/4/13 +.. ----------------------------------------------------------------------------- + +.. Crate a Docker Hub account & repository + +.. _create-a-docker-hub-account-and-repository-mac: + +======================================== +Docker Hub アカウントとリポジトリの作成 +======================================== + +.. sidebar:: 目次 + + .. contents:: + :depth: 3 + :local: + +.. You’ve built something really cool, you should share it. In this next section, you’ll do just that. You’ll need a Docker Hub account. Then, you’ll push your image up to it so other people with Docker Engine can run it. + +良い感じに構築できましたので、次は共有しましょう。このセクションでは共有を扱います。そのためには Docker Hub アカウントが作成です。そしてイメージをアップロードすると、Docker Engine を持つ他の人も実行できるようになります。 + +.. Step 1: Sign up for an account + +.. _step-1-sign-up-for-an-account-mac: + +ステップ１：アカウントの登録（サインアップ） +================================================== + +.. Use your browser to navigate to the Docker Hub signup page. + +1. ブラウザで `Docker Hub のサインアップ・ページ `_ を開きます。　 + +.. Your browser displays the page. + +ブラウザには次のページが表示されます。 + +.. image:: /tutimg/hub_signup.png + :scale: 60% + :alt: Docker Hub + +.. Fill out the form on the signup page. + +2. サインアップ・ページのフォームを入力します。 + +.. Docker Hub is free. Docker does need a name, password, and email address. + +Docker Hub は無料で使えます。登録にはユーザ名、パスワード、メールアドレスが必要です。 + +.. Press Signup. + +3. Signup（サインアップ）を押します。 + +.. The browser displays the welcome to Docker Hub page. + +ブラウザには Docker Hub のウェルカム・ページが表示されます。 + +.. Step 2: Verify your email and add a repository + +.. _step-2-verify-your-email-and-add-a-repository-mac: + +ステップ２：メールアドレスの確認とリポジトリの追加 +================================================== + +.. Before you can share anything on the hub, you need to verify your email address. + +何かを Docker Hub 上で共有する前に、メールアドレスの確認が必要です。 + +.. Open your email inbox. + +1. メールの受信箱を確認します。 + +.. Look for the email titled Please confirm email for your Docker Hub account. + +2. メールのタイトル ``Please confirm email for your Docker Hub account`` （Docker Hub アカウントのメールアドレスをご確認ください）を探します。 + +.. If you don’t see the email, check your Spam folder or wait a moment for the email to arrive. + +メールが届いていなければ、迷惑メール用のフォルダに入っていないか確認するか、メールが到着するまでお待ちください。 + +.. Open the email and click the Confirm Your Email button. + +3. メールの本文にあるボタンをクリックし、メールアドレスの確認を済ませます。 + +.. The browser opens Docker Hub to your profile page. + +ブラウザで Docker Hub のページを開くと、自分のプロフィール・ページが表示されます。 + +.. Choose Create Repository. + +4. Create Repository（リポジトリの作成）をクリックします。 + +.. The browser opens the Create Repository page. + +ブラウザは新しいリポジトリ作成ページを開きます。 + +.. Provide a Repository Name and Short Description. + +5. リポジトリ名と簡単な説明を背追加します。 + +.. Make sure Visibility is set to Public. + +6. Visibility（可視性）は Public （公開）に指定します。 + +.. When you are done, your form should look similar to the following: + +作成するには、次の画面のように入力します。 + +.. image:: /tutimg/add_repository.png + +.. Press Create when you are done. + +7. Create を押すと作業完了です。 + +.. Docker Hub creates your new repository. + +Docker Hub で新しいリポジトリを作成しました。 + +.. Where to go next + +次は何をしますか +==================== + +.. On this page, you opened an account on Docker Hub and created a new repository. In the next section, you populate the repository by tagging and pushing the image you created earlier. + +このページでは Docker Hub 上にアカウントを開設し、新しいリポジトリを追加しました。次のセクションではリポジトリに送信するため、 :doc:`先ほど作成したイメージにタグを付けて送信 ` します。 + +.. seealso:: + + Create a Docker Hub account & repository + https://docs.docker.com/mac/step_five/ + + diff --git a/mac/step_four.rst b/mac/step_four.rst new file mode 100644 index 000000000..f46669d6f --- /dev/null +++ b/mac/step_four.rst @@ -0,0 +1,363 @@ +.. -*- coding: utf-8 -*- +.. https://docs.docker.com/mac/step_four/ +.. doc version: 1.10 +.. check date: 2016/4/13 +.. ----------------------------------------------------------------------------- + +.. Build your own image + +.. _build-your-own-image-mac: + +======================================== +自分でイメージを構築 +======================================== + +.. sidebar:: 目次 + + .. contents:: + :depth: 3 + :local: + +.. The whalesay image could be improved. It would be nice if you didn’t have to think of something to say. And you type a lot to get whalesay to talk. + +``whalesay`` イメージは更に改良できます。もしかすると、何も喋らせたくないかもしれません。あるいは、もっと喋らせることもできます。 + +.. code-block:: bash + + docker run docker/whalesay cowsay boo-boo + +.. In this next section, you will improve the whalesay image by building a new version that “talks on its own” and requires fewer words to run. + +このセクションでは ``whalesay`` イメージを改良します。（オプションを指定しなくても）「自分で何かシャベル」新しいバージョンのイメージを作成します。実行に必要なのは、ほんの少しの単語です。 + +.. Step 1: Open a Docker Quickstart Terminal + +.. _step-1-open-a-docker-quickstart-terminal-mac: + +ステップ１：Docker クイックスタート・ターミナルを開く +============================================================ + +.. In this step, you use the Mac TextEdit program to write a short Dockerfile. A Dockerfile describes the software that is “baked” into an image. It isn’t just ingredients tho, it can tell the software what environment to use or what commands to run. Your recipe is going to be very short. + +このステップでは、Mac のテキストエディット・プログラムを使い短い Dockerfile を書きます。Dockerfile にはイメージを構成するソフトウェア要素を記述します。Dockerfile は単に素材を記述するだけではありません。どのような環境を使うかや、コンテナの中で実行するコマンドも記述できます。今回の Dockerfile は非常に短いものです。 + +.. If you don’t already have a terminal open, open one now: + +ターミナルを開いていなければ、新しいものを開きます。 + +.. Open the Launchpad and locate the Docker Quickstart Terminal icon. + +1. Launchpad を起動し、Docker クイックスタート・ターミナルのアイコンを探します。 + +.. Click the icon to launch a Docker Quickstart Terminal. + +2. アイコンをクリックし、 Docker クイックスタート・ターミナルを起動します。 + +.. Place your cursor at the prompt in the Docker Quickstart Terminal. + +3. Docker クイックスタート・ターミナルのプロンプトにカーソルを合わせます。 + +.. Make a new directory by typing mkdir mydockerbuild and pressing RETURN. + +4. 新しいディレクトリを作成するため、 ``mkdir mydockerbuild`` を入力してリターンキーを押します。 + +.. code-block:: bash + + $ mkdir mydockerbuild + +.. This directory serves as the “context” for your build. The context just means it contains all the things you need to build your image. + +このディレクトリは構築時の「コンテクスト」（context；内容物）の役割があります。このコンテクストとは、イメージを構築するために必要な全てを指します。 + +.. Change to your new directory. + +5. 新しいディレクトリに移動します。 + + $ cd mydockerbuild + +.. Right now the directory is empty. + +この時点でディレクトリには何もありません。 + +.. Create a Dockerfile in the current directory by typing touch Dockerfile and pressing RETURN. + +6. ``touch Dockerfile`` と入力してエンターキーを押すと、現在のディレクトリに Dockerfile を作成します。 + +.. code-block:: bash + + $ touch Dockerfile + +.. The command appears to do nothing but it actually creates the Dockerfile in the current directory. Just type ls Dockerfile to see it. + +コマンドを実行しても何も表示されませんが、実際には現在のディレクトリ内に Dockerfile が作成されています。 ``ls Dockerfile`` を実行してみましょう。 + +.. code-block:: bash + + $ ls Dockerfile + Dockerfile + +.. Now, type the open -e Dockerfile to open the file in Mac’s TextEdit program. + +7. 次は ``open -e Dockerfile`` を実行し、Mac のテキストエディット・プログラムを開きます。 + +.. Your Mac opens the TextEdit program with the empty Dockerfile. + +Mac はテキストエディット・プログラムを起動し、空の Dockerfile を開きます。 + +.. Type FROM docker/whalesay:latest line into the open file. + +8. 開いたファイルの中に ``FROM docker/whalesay:latest`` と入力します。 + +.. Now, it should look like this. + +次のような表示になります。 + +.. Line one + +.. code-block:: bash + + FROM docker/whalesay:latest + +.. The FROM keyword tells Docker which image your image is based on. You are basing your new work on the existing whalesay image. + +``FROM`` キーワードは Docker に対してイメージの元となるイメージを伝えます。これから作成する新しいイメージは、既存の ``whalesay`` イメージを使います。 + +.. Now, add the fortunes program to the image. + +9. 次はイメージに ``fortunes`` プログラムを追加します。 + +.. Line two + +.. code-block:: bash + + FROM docker/whalesay:latest + + RUN apt-get -y update && apt-get install -y fortunes + +.. The fortunes program has a command that prints out wise sayings for our whale to say. So, the first step is to install it. This line adds the fortune program using the apt-get program. If these sound all very cryptic to you, don’t worry. As long as you type the words correctly, they will work for you! + +``fortunes`` プログラムは賢そうなことを表示するプログラムです。これを今回のこの鯨プログラムに喋らせます。そのため、最初のステップはインストールです。この行は ``apt-get`` プログラムを使い ``fourtune`` プログラムをインストールします。もしかしたら暗号めいて見えるかもしれませんが、心配しなくても大丈夫です。正確に入力さえしれば、正しく動いてくれます！ + +.. Once the image has the software it needs, you instruct the software to run when the image is loaded. + +10. イメージに必要なソフトウェアをインストールしたら、イメージの読み込み時に実行するソフトウェアを命令します。 + +.. Line two + +.. code-block:: bash + + FROM docker/whalesay:latest + + RUN apt-get -y update && apt-get install -y fortunes + + CMD /usr/games/fortune -a | cowsay + +.. This line tells the fortune program to send its nifty quotes to the cowsay program. + +この行は ``fortune`` プログラム（の結果）を、気の利いたことを喋る ``cowsay`` プログラムに送ります。 + +.. Save your work and the Dockerfile by choosing File > Save from the TextEdit menu or by pressing CMD + S on your keyboard + +10. 編集した Dockerfile プログラムを保存します。テキストエディットのメニューから保存を選ぶか、キーボード上で CMD +S を押します。 + +.. At this point, you have all your software ingredients and behaviors described in a Dockerfile. You are ready to build a new image. + +以上で Dockerfile 中にソフトウエア全ての要素と挙動を記述しました。これで新しいイメージを構築する準備が整いました。 + +.. Step 2: Build an image from your Dockerfile + +.. _step-2-build-an-image-from-your-dockerfile-mac: + +ステップ２：Dockerfile を使ってイメージ構築 +================================================== + +.. Place your cursor back in your Docker Quickstart Terminal. + +1. Docker クイックスタート・ターミナルにカーソルを合わせます。 + +.. Make sure the Dockerfile is in the current directory by typing cat Dockerfile + +2. Dockerfile が正確かどうかを確認するため、現在のディレクトリで ``cat Dockerfile`` を実行します。 + +.. code-block:: bash + + $ cat Dockerfile + FROM docker/whalesay:latest + + RUN apt-get -y update && apt-get install -y fortunes + + CMD /usr/games/fortune -a | cowsay + +.. Now, build your new image by typing the docker build -t docker-whale . command in your terminal (don’t forget the . period). + +3. 次は新しいイメージを構築するため ``docker build -t docker-whale .`` コマンドをターミナル上で実行します（最後にピリオド ``.`` を忘れないでください）。 + +.. code-block:: bash + + $ docker build -t docker-whale . + Sending build context to Docker daemon 158.8 MB + ...省略... + Removing intermediate container a8e6faa88df3 + Successfully built 7d9495d03763 + +.. The command takes several seconds to run and reports its outcome. Before you do anything with the new image, take a minute to learn about the Dockerfile build process. + +このコマンドを実行すると、結果が出るまで数秒ほどかかります。この新しいイメージを使う前に、Dockerfile の構築時の流れを学びましょう。 + +.. Step 3: Learn about the build process + +.. _step-3-learn-about-the-build-process-mac: + +ステップ３：構築時の流れを学ぶ +============================== + +.. The docker build -t docker-whale . command takes the Dockerfile in the current directory, and builds an image called docker-whale on your local machine. The command takes about a minute and its output looks really long and complex. In this section, you learn what each message means. + +``docker build -t docker-whale .`` コマンドは現在のディレクトリ内にある ``Dockerfile`` を使います。そして、自分のマシン上に ``docker-whale`` という名称のイメージを構築します。コマンドの処理には少し時間がかかります。処理結果の表示は少し複雑に見えるでしょう。このセクションでは、各メッセージの意味を学びます。 + +.. First Docker checks to make sure it has everything it needs to build. + +まず Docker は構築時に必要な全てを確認します。 + +.. code-block:: bash + + Sending build context to Docker daemon 158.8 MB + +.. Then, Docker loads with the whalesay image. It already has this image locally as you might recall from the last page. So, Docker doesn’t need to download it. + +それから Docker は ``whalesay`` イメージを読み込みます。読み込むイメージは、先ほどのステップで既にローカルにあります。そのため、Docker は改めてダウンロードしません。 + +.. code-block:: bash + + Step 0 : FROM docker/whalesay:latest + ---> fb434121fc77 + +.. Docker moves onto the next step which is to update the apt-get package manager. This takes a lot of lines, no need to list them all again here. + +Docker は次の行に移ります。 ``apt-get`` パッケージ・マネージャを更新します。ここでは多くのメッセージが表示されますが、表示されるのは初回だけです。 + +.. code-block:: bash + + Step 1 : RUN apt-get -y update && apt-get install -y fortunes + ---> Running in 27d224dfa5b2 + Ign http://archive.ubuntu.com trusty InRelease + Ign http://archive.ubuntu.com trusty-updates InRelease + Ign http://archive.ubuntu.com trusty-security InRelease + Hit http://archive.ubuntu.com trusty Release.gpg + ....snip... + Get:15 http://archive.ubuntu.com trusty-security/restricted amd64 Packages [14.8 kB] + Get:16 http://archive.ubuntu.com trusty-security/universe amd64 Packages [134 kB] + Reading package lists... + ---> eb06e47a01d2 + +.. Then, Docker installs the new fortunes software. + +それから、Docker は新しい ``fortunes`` ソフトウエアをインストールします。 + +.. code-block:: bash + + Removing intermediate container e2a84b5f390f + Step 2 : RUN apt-get install -y fortunes + ---> Running in 23aa52c1897c + Reading package lists... + Building dependency tree... + Reading state information... + The following extra packages will be installed: + fortune-mod fortunes-min librecode0 + Suggested packages: + x11-utils bsdmainutils + The following NEW packages will be installed: + fortune-mod fortunes fortunes-min librecode0 + 0 upgraded, 4 newly installed, 0 to remove and 3 not upgraded. + Need to get 1961 kB of archives. + After this operation, 4817 kB of additional disk space will be used. + Get:1 http://archive.ubuntu.com/ubuntu/ trusty/main librecode0 amd64 3.6-21 [771 kB] + ...snip...... + Setting up fortunes (1:1.99.1-7) ... + Processing triggers for libc-bin (2.19-0ubuntu6.6) ... + ---> c81071adeeb5 + Removing intermediate container 23aa52c1897c + +.. Finally, Docker finishes the build and reports its outcome. + +最後に Docker は構築の終了を画面に表示します。 + +.. code-block:: bash + + Step 3 : CMD /usr/games/fortune -a | cowsay + ---> Running in a8e6faa88df3 + ---> 7d9495d03763 + Removing intermediate container a8e6faa88df3 + Successfully built 7d9495d03763 + +.. Step 4: Run your new docker-whale + +.. _step-4-run-your-new-docker-whale-mac: + +ステップ４：新しい docker-whale を実行 +======================================== + +.. In this step, you verify the new images is on your computer and then you run your new image. + +このステップではコンピュータ上にイメージがあるかどうか確認してから、新しいイメージを実行します。 + +.. If it isn’t already there, place your cursor at the prompt in the Docker Quickstart Terminal window. + +1. ターミナル・ウインドウ上でなければ、Docker クイックスタート・ターミナルにカーソルを合わせます。 + +.. Type docker images and press RETURN. + +2. ``docker images`` を実行してリターンキーを押します。 + +.. This command, you might remember, lists the images you have locally. + +このコマンドはローカルにあるイメージの一覧を表示します。覚えておくと良いでしょう。 + +.. code-block:: bash + + $ docker images + REPOSITORY TAG IMAGE ID CREATED VIRTUAL SIZE + docker-whale latest 7d9495d03763 4 minutes ago 273.7 MB + docker/whalesay latest fb434121fc77 4 hours ago 247 MB + hello-world latest 91c95931e552 5 weeks ago 910 B + +.. Run your new image by typing docker run docker-whale and pressing RETURN. + +3. 新しいイメージを実行します。``docker run docker-whale`` を入力して、エンターキーを押します。 + +.. code-block:: bash + + $ docker run docker-whale + _________________________________________ + / "He was a modest, good-humored boy. It \ + \ was Oxford that made him insufferable." / + ----------------------------------------- + \ + \ + \ + ## . + ## ## ## == + ## ## ## ## === + /""""""""""""""""___/ === + ~~~ {~~ ~~~~ ~~~ ~~~~ ~~ ~ / ===- ~~~ + \______ o __/ + \ \ __/ + \____\______/ + +.. As you can see, you’ve made the whale a lot smarter. It finds its own things to say and the command line is a lot shorter! You may also notice that Docker didn’t have to download anything. That is because the image was built locally and is already available. + +ご覧の通り、少し賢くなった鯨プログラムを作りました。コマンドラインで何かを自分で指定すると、それの表示もできます！ Docker は何もダウンロードしないことにも注目します。これはイメージをローカルで構築しており、ダウンロードする必要がないからです。 + +.. Where to go next + +次は何をしますか +==================== + +.. On this page, you learned to build an image by writing your own Dockerfile. You ran your image in a container. You also just used Linux from your Mac yet again. In the next section, you take the first step in sharing your image by creating a Docker Hub account. + +このページでは自分で Dockerfile を記述してイメージを構築する方法を学びました。そして、自分のイメージを使ってコンテナを実行しました。また、まだ Mac 上の Linux システムを使っています。次のセクションではイメージを共有する第一歩として、 :doc:`Docker Hub アカウントを作成 ` します。 + +.. seealso:: + + Biuld your own image + https://docs.docker.com/mac/step_four/ diff --git a/mac/step_one.rst b/mac/step_one.rst new file mode 100644 index 000000000..56c886be0 --- /dev/null +++ b/mac/step_one.rst @@ -0,0 +1,276 @@ +.. -*- coding: utf-8 -*- +.. https://docs.docker.com/mac/step_one/ +.. doc version: 1.10 +.. check date: 2016/4/13 +.. ----------------------------------------------------------------------------- + +.. Install Docker Toolbox on Mac OS X + +.. _install-docker-toolbox-on-macos-x: + +================================================== +Mac OS X に Docker Toolbox のインストール +================================================== + +.. sidebar:: 目次 + + .. contents:: + :depth: 3 + :local: + +.. Mac OS X users use Docker Toolbox to install Docker software. Docker Toolbox includes the following Docker tools: + +Mac OS X ユーザは Docker ツールボックス（Toolbox）を使って Docker のソフトウェアをインストールできます。Docker ツールボックスには、以下の Docker ツールが含まれます。 + +.. Docker CLI client for running Docker Engine to create images and containers + Docker Machine so you can run Docker Engine commands from Mac OS X terminals + Docker Compose for running the docker-compose command + Kitematic, the Docker GUI + the Docker QuickStart shell preconfigured for a Docker command-line environment + Oracle VM VirtualBox + +* Docker CLI クライアントは Docker Engine（エンジン）でコンテナやイメージを作成します。 +* Docker Machine（マシン）は Mac OS X 端末から Docker Engine に命令できます。 +* Docker Compose（コンポーズ）は ``docker-compose`` コマンドを実行します。 +* Kitematic（カイトマティック）は Docker の GUI です。 +* Docker QuickStart（クイックスタート）は Docker コマンドライン環境を設定済みのシェルです。 +* Oracle VM VirtualBox + +.. Because the Docker Engine daemon uses Linux-specific kernel features, you can’t run Docker Engine natively in OS X. Instead, you must use the Docker Machine command, docker-machine, to create and attach to a small Linux VM on your machine. This VM hosts Docker Engine for you on your OS X system. + +Docker Engine デーモンは LInux 固有の kernel 機能を使います。そのため、Windows では Docker Engine をネイティブに扱えません。その代わりに ``docker-machine`` コマンドを使い、自分のマシン上に小さな Linux 仮想マシンを作成し、そこに接続します。この仮想マシンは Mac システム上で Docker Engine を動かします。 + +.. Step 1: Check your version + +.. _step1-check-your-version-mac: + +ステップ１：バージョンの確認 +============================== + +.. Your Mac must be running OS X 10.8 “Mountain Lion” or newer to run Docker software. To find out what version of the OS you have: + +Mac で Docker ソフトウェアを実行するには OS X 10.8 「Mountain Lion」以上のバージョンが必要です。OS のバージョンは次の手順で確認します。 + +.. Choose About this Mac from the Apple menu. + +1. アップルのメニューからこの Mac についてをクリックします。 + +.. The version number appears directly below the words OS X. + +画面上にある ``OS X`` の後ろ側にある文字がバージョン番号です。 + +.. If you have the correct version, go to the next step. + +2. 適切なバージョンであれば、次のステップに進みます。 + +.. If you aren’t using a supported version, you could consider upgrading your operating system. + +サポートしているバージョンでなければ、オペレーティング・システムのアップグレードをご検討ください。 + +.. Step 2: Install Docker Toolbox + +.. _step2-install-docker-toolbox-mac: + +ステップ２：Docker Toolbox のインストール +========================================= + +.. Go to the Docker Toolbox. + +1. `Docker Toolbox `_ のページに移動します。 + +.. Click the installer link to download. + +2. インストーラのリンクをクリックし、ダウンロードします。 + +.. Install Docker Toolbox by double-clicking the package or by right-clicking and choosing “Open” from the pop-up menu. + +3. Docker Toolbox をインストールします。パッケージをダブル・クリックするか、右クリックして開いたポップアップ・メニューから「開く」を選びます。 + +.. The installer launches an introductory dialog, followed by an overview of what’s installed. + +インストーラが起動すると、何をインストールするかの概要説明が表示されます。 + +.. Press Continue to install the toolbox. + +4. Contine を押すと Toolbox のインストールに進みます。 + +.. The installer presents you with options to customize the standard installation. + +インストーラ画面には標準インストール対象のカスタマイズが表示されます。 + +.. By default, the standard Docker Toolbox installation: + +デフォルトでは、標準的な Docker Toolbox のインストールです。 + +.. installs binaries for the Docker tools in /usr/local/bin + makes these binaries available to all users + updates any existing Virtual Box installation + +* Docker tool のバイナリを ``/usr/local/bin`` にインストールします。 +* これらのバイナリを、全てのユーザで利用可能にします。 +* 既存の Virtual Box がインストールされていれば、更新します。 + +.. For now, don’t change any of the defaults. + +現時点では、これらのデフォルトを変更しません。 + +.. Press Install to perform the standard installation. + +5. Install を押して、標準インストールを進めます。 + +.. The system prompts you for your password. + +画面上にはパスワード入力を促す画面が表示されます。 + +.. Provide your password to continue with the installation. + +6. インストールを続けるためにパスワードを入力します。 + +.. When it completes, the installer provides you with some shortcuts. You can ignore this for now and click Continue. + +インストールが終わると、ショートカットの作成を訊ねてきます。ここでは、このまま Continue （続ける）を押します。 + +.. Then click Close to finish the installer. + +そして Close を押してインストーラを終了します。 + +.. Step 3: Verify your installation + +.. _step3-verify-your-installation-mac: + +ステップ３：インストールの確認 +============================== + +.. To run a Docker container, you: + +Docker コンテナを実行するには： + +.. create a new (or start an existing) Docker Engine host running + switch your environment to your new VM + use the docker client to create, load, and manage containers + +* 新しい Docker Engine のホストを作成します（あるいは、既存のホストを起動します）。 +* 環境変数を新しい仮想マシンに切り替えます。 +* ``docker`` クライアントを使い、コンテナの作成、読み込み、管理を行します。 + +.. Once you create a machine, you can reuse it as often as you like. Like any Virtual Box VM, it maintains its configuration between uses. + +マシンを作成後は、必要な時に何度でも再利用できます。これは Virtual Box の仮想マシンと同様で、共通の設定を使います。 + +.. Open the Launchpad and locate the Docker Quickstart Terminal icon. + +1. Launchpad を起動し、Docker Quickstart Terminal（クイックスタート・ターミナル）のアイコンを探します。 + +.. Click the icon to launch a Docker Quickstart Terminal windows. + +2. アイコンをクリックし、Docker Quickstart ターミナル・ウインドウを起動します。 + +.. The terminal does a number of things to set up Docker Quickstart Terminal for you. + +ターミナルでは、Docker ツールボックスがセットアップに関する様々な情報を表示します。 + +.. code-block:: bash + + Last login: Sat Jul 11 20:09:45 on ttys002 + bash '/Applications/Docker Quickstart Terminal.app/Contents/Resources/Scripts/start.sh' + Get http:///var/run/docker.sock/v1.19/images/json?all=1&filters=%7B%22dangling%22%3A%5B%22true%22%5D%7D: dial unix /var/run/docker.sock: no such file or directory. Are you trying to connect to a TLS-enabled daemon without TLS? + Get http:///var/run/docker.sock/v1.19/images/json?all=1: dial unix /var/run/docker.sock: no such file or directory. Are you trying to connect to a TLS-enabled daemon without TLS? + -bash: lolcat: command not found + + mary at meepers in ~ + $ bash '/Applications/Docker Quickstart Terminal.app/Contents/Resources/Scripts/start.sh' + Creating Machine dev... + Creating VirtualBox VM... + Creating SSH key... + Starting VirtualBox VM... + Starting VM... + To see how to connect Docker to this machine, run: docker-machine env dev + Starting machine dev... + Setting environment variables for machine dev... + + ## . + ## ## ## == + ## ## ## ## ## === + /"""""""""""""""""\___/ === + ~~~ {~~ ~~~~ ~~~ ~~~~ ~~~ ~ / ===- ~~~ + \______ o __/ + \ \ __/ + \____\_______/ + + The Docker Quick Start Terminal is configured to use Docker with the “default” VM. + +3. Click your mouse in the terminal window to make it active. + +ターミナル・ウインドウをマウスでクリックし、アクティブにします。 + +.. If you aren’t familiar with a terminal window, here are some quick tips. + +.. If you aren’t familiar with a terminal window, here are some quick tips. + +ターミナル画面に不慣れでしたら、ここで便利な使い方を紹介します。 + +.. The prompt is traditionally a $ dollar sign. You type commands into the command line which is the area after the prompt. Your cursor is indicated by a highlighted area or a | that appears in the command line. After typing a command, always press RETURN. + +プロンプトとは一般的に ``$`` ドル記号です。このプロンプトの後にあるコマンドライン上でコマンドを入力します。コマンドライン上ではカーソルは ``|`` として表示されます。コマンドを入力した後は、常にリターン・キーを押します。 + +.. Type the docker run hello-world command and press RETURN. + +4. ``docker run hello-world`` コマンドを実行し、リターン・キーを押します。 + +.. The command does some work for you, if everything runs well, the command’s output looks like this: + +以下のコマンドは、何らかの処理を行うものです。正常に実行すると、画面には次のように表示されます。 + +.. code-block:: bash + + $ docker run hello-world + Unable to find image 'hello-world:latest' locally + latest: Pulling from library/hello-world + 535020c3e8ad: Pull complete + af340544ed62: Pull complete + Digest: sha256:a68868bfe696c00866942e8f5ca39e3e31b79c1e50feaee4ce5e28df2f051d5c + Status: Downloaded newer image for hello-world:latest + + Hello from Docker. + This message shows that your installation appears to be working correctly. + + To generate this message, Docker took the following steps: + 1. The Docker Engine CLI client contacted the Docker Engine daemon. + 2. The Docker Engine daemon pulled the "hello-world" image from the Docker Hub. + 3. The Docker Engine daemon created a new container from that image which runs the + executable that produces the output you are currently reading. + 4. The Docker Engine daemon streamed that output to the Docker Engine CLI client, which sent it + to your terminal. + + To try something more ambitious, you can run an Ubuntu container with: + $ docker run -it ubuntu bash + + Share images, automate workflows, and more with a free Docker Hub account: + https://hub.docker.com + + For more examples and ideas, visit: + https://docs.docker.com/userguide/ + +.. Looking for troubleshooting help? + +問題解決のヘルプをお探しですか？ +======================================== + +.. Typically, the above steps work out-of-the-box, but some scenarios can cause problems. If your docker run hello-world didn’t work and resulted in errors, check out Troubleshooting for quick fixes to common problems. + +通常、これらの手順は特に何も考えなくても実行できますが、もしかしたら問題が発生する場合があるかもしれません。 ```docker run hello-world`` が実行できずエラーになる場合は、一般的な問題を解決するための :doc:`トラブルシューティング ` をご覧ください。 + + +.. Where to go next + +次は何をしますか +==================== + +.. At this point, you have successfully installed the Docker software. Leave the Docker Quickstart Terminal window open. Now, go to the next page to read a very short introduction Docker images and containers. + +以上で Docker ソフトウェアのインストールが完了しました。Docker Quickstart ターミナル画面は開いたままにします。次は :doc:`step_two` に進みます。 + +.. seealso:: + + Install Docker for Windows + https://docs.docker.com/mac/step_one/ diff --git a/mac/step_six.rst b/mac/step_six.rst new file mode 100644 index 000000000..4c5c4d585 --- /dev/null +++ b/mac/step_six.rst @@ -0,0 +1,304 @@ +.. -*- coding: utf-8 -*- +.. https://docs.docker.com/mac/step_six/ +.. doc version: 1.10 +.. check date: 2016/4/13 +.. ----------------------------------------------------------------------------- + +.. Tag, push, and pull your image + +.. _tag-push-and-pull-your-image-mac: + +======================================== +イメージのタグ付け、送信、取得 +======================================== + +.. sidebar:: 目次 + + .. contents:: + :depth: 3 + :local: + +.. In this section, you tag and push your docker-whale image to your newly created repository. When you are done, you test the repository by pulling your new image. + +このセクションでは ``docker-whale`` イメージにタグを付け、先ほど作成した自分のリポジトリにイメージを送信します。作業が後は、自分の新しいイメージをリポジトリから取得できるか確認します。 + +.. Step 1: Tag and push the image + +.. _step-1-tag-and-push-the-image-mac: + +ステップ１：イメージのタグ付けと送信 +======================================== + +.. If you don’t already have a terminal open, open one now: + +ターミナルを開いていなければ、今から開きます。 + +.. Open the Launchpad and locate the Docker Quickstart Terminal icon. + +1. Lanchpad を開き、 Docker Quickstart Terminal アイコンを探します。 + +.. image:: /tutimg/icon_set.png + :scale: 60% + :alt: デスクトップ + +.. Click the icon to launch a Docker Quickstart Terminal. + +2. アイコンをクリックし、 Docker クイックスタート・ターミナルを起動します。 + +.. Place your cursor at the prompt in the Docker Quickstart Terminal window. + +3. Docker クイックスタート・ターミナルのウインドウのプロンプトにカーソルをあわせます。 + +.. Type docker images to list the images you currently have: + +4. ``docker image`` を入力し、現在手許にあるイメージの一覧を表示します。 + +.. code-block:: bash + + $ docker images + REPOSITORY TAG IMAGE ID CREATED VIRTUAL SIZE + docker-whale latest 7d9495d03763 38 minutes ago 273.7 MB + 5dac217f722c 45 minutes ago 273.7 MB + docker/whalesay latest fb434121fc77 4 hours ago 247 MB + hello-world latest 91c95931e552 5 weeks ago 910 B + +.. Find the IMAGE ID for your docker-whale image. + +5. ``docker-whale`` イメージの ``イメージ ID`` を確認します。 + +.. In this example, the id is 7d9495d03763. + +この例では ID は ``7d9495d03763`` です。 + +.. Notice that currently, the REPOSITORY shows the repo name docker-whale but not the namespace. You need to include the namespace for Docker Hub to associate it with your account. The namespace is the same as your Docker Hub account name. You need to rename the image to YOUR_DOCKERHUB_NAME/docker-whale. + +現時点の ``REPOSITORY`` にあるリポジトリ名は ``docker-whale`` ですが、名前空間（namespace）がありません。名前空間は Docker Hub 上の自分のアカウントに関連付いています。この名前空間は自分の Docker Hub アカウント名と同じです。そのため、イメージを ``自分のアカウント名/docker-whale`` に名称変更する必要があります。 + +.. Use IMAGE ID and the docker tag command to tag your docker-whale image. + +6. ``docker tag`` コマンドと ``イメージ ID`` を指定し、 ``docker-whale`` イメージをタグ付けします。 + +.. The command you type looks like this: + +入力するコマンドは、次のような意味があります。 + +.. image:: /tutimg/tagger.png + +.. Of course, your account name will be your own. So, you type the command with your image’s ID and your account name and press RETURN. + +もちろん、アカウント名は自分自身のものです。そのため、イメージ ID やアカウント名は自分のものを入力し、リターンキーを押します。 + +.. code-block:: bash + + $ docker tag 7d9495d03763 maryatdocker/docker-whale:latest + +.. Type the docker images command again to see your newly tagged image. + +7. ``docker images`` コマンドをもう一度実行して、新しくタグ付けされたイメージがあるかどうか確認します。 + +.. code-block:: bash + + $ docker images + REPOSITORY TAG IMAGE ID CREATED VIRTUAL SIZE + maryatdocker/docker-whale latest 7d9495d03763 5 minutes ago 273.7 MB + docker-whale latest 7d9495d03763 2 hours ago 273.7 MB + 5dac217f722c 5 hours ago 273.7 MB + docker/whalesay latest fb434121fc77 5 hours ago 247 MB + hello-world latest 91c95931e552 5 weeks ago 910 B + +.. Use the docker login command to log into the Docker Hub from the command line. + +8. コマンドライン上で ``docker login`` コマンドを使い Docker Hub にログインします。 + +.. The format for the login command is: + +ログインコマンドの書式は次の通りです： + +.. code-block:: bash + + docker login --username=yourhubusername --email=youremail@company.com + +.. When prompted, enter your password and press enter. So, for example: + +入力を促すプロンプトが表示された、パスワードを入力してエンターを押します。実行例： + +.. code-block:: bash + + $ docker login --username=maryatdocker --email=mary@docker.com + Password: + WARNING: login credentials saved in C:\Users\sven\.docker\config.json + Login Succeeded + +.. Type the docker push command to push your image to your new repository. + +9. ``docker push`` コマンドを実行し、自分のイメージをリポジトリに送信します。 + +.. code-block:: bash + + $ docker push maryatdocker/docker-whale + The push refers to a repository [maryatdocker/docker-whale] (len: 1) + 7d9495d03763: Image already exists + c81071adeeb5: Image successfully pushed + eb06e47a01d2: Image successfully pushed + fb434121fc77: Image successfully pushed + 5d5bd9951e26: Image successfully pushed + 99da72cfe067: Image successfully pushed + 1722f41ddcb5: Image successfully pushed + 5b74edbcaa5b: Image successfully pushed + 676c4a1897e6: Image successfully pushed + 07f8e8c5e660: Image successfully pushed + 37bea4ee0c81: Image successfully pushed + a82efea989f9: Image successfully pushed + e9e06b06e14c: Image successfully pushed + Digest: sha256:ad89e88beb7dc73bf55d456e2c600e0a39dd6c9500d7cd8d1025626c4b985011 + +.. Return to your profile on Docker Hub to see your new image. + +10. 自分の Docker Hub のプロフィールページに戻ると、新しいイメージの情報が表示されます。 + +.. image:: /tutimg/new_image.png + :scale: 60% + +.. Step 2: Pull your new image + +.. _step-2-pull-your-new-image-mac: + +ステップ２：新しいイメージの取得 +======================================== + +.. In this last section, you’ll pull the image you just pushed to hub. Before you do that though, you’ll need to remove the original image from your local machine. If you left the original image on your machine. Docker would not pull from the hub — why would it? The two images are identical. + +この最後のセクションでは、Docker Hub に送信(push)したイメージを取得(pull)します。作業を進める前に、これまでローカルマシン上で作成したオリジナルのイメージを削除します。マシン上にオリジナルのイメージを残しておいたままでは、Docker は Docker Hub からイメージを取得しません。これは両方のイメージが同一と認識されるためです。 + +.. Place your cursor at the prompt in the Docker Quickstart Terminal window. + +1. Docker クイックスタート・ターミナルのウインドウ上のプロンプトにカーソルを合わせます。 + +.. Type docker images to list the images you currently have on your local machine. + +2. ``docker images`` を入力し、ローカルマシン上にあるイメージの一覧を表示します。 + +.. code-block:: bash + + $ docker images + REPOSITORY TAG IMAGE ID CREATED VIRTUAL SIZE + maryatdocker/docker-whale latest 7d9495d03763 5 minutes ago 273.7 MB + docker-whale latest 7d9495d03763 2 hours ago 273.7 MB + 5dac217f722c 5 hours ago 273.7 MB + docker/whalesay latest fb434121fc77 5 hours ago 247 MB + hello-world latest 91c95931e552 5 weeks ago 910 B + +.. To make a good test, you need to remove the maryatdocker/docker-whale and docker-whale images from your local system. Removing them forces the next docker pull to get the image from your repository. + +テストを正しく行うため、ローカルのシステム上から ``maryatdocker/docker-whale`` と ``docker-whale`` イメージを削除します。次の ``docker pull`` コマンドを実行する前に、リポジトリからイメージを削除します。 + +.. Use the docker rmi to remove the maryatdocker/docker-whale and docker-whale images. + +3. ``docker rmi`` コマンドを使い、 ``maryatdocker/docker-whale`` と ``docker-whale`` イメージを削除します。 + +.. You can use an ID or the name to remove an image. + +イメージを削除するにはイメージ ID かイメージ名を使います。 + +.. code-block:: bash + + $ docker rmi -f 7d9495d03763 + $ docker rmi -f docker-whale + +.. Pull and load a new image from your repository using the docker run command. + +4. ``docker run`` コマンドを使い、リポジトリから新しいイメージの取得と読み込みます。 + +.. The command you type should include your username from Docker Hub. + +コマンド実行時、ユーザ名には Docker Hub 上の自分の名前を指定します。 + +.. code-block:: bash + + docker run 自分のユーザ名/docker-whale + +.. Since the image is no longer available on your local system, Docker downloads it. + +イメージがローカルホスト上にないため、Docker はイメージをダウンロードします。 + +.. code-block:: bash + + $ docker run maryatdocker/docker-whale + Unable to find image 'maryatdocker/docker-whale:latest' locally + latest: Pulling from maryatdocker/docker-whale + eb06e47a01d2: Pull complete + c81071adeeb5: Pull complete + 7d9495d03763: Already exists + e9e06b06e14c: Already exists + a82efea989f9: Already exists + 37bea4ee0c81: Already exists + 07f8e8c5e660: Already exists + 676c4a1897e6: Already exists + 5b74edbcaa5b: Already exists + 1722f41ddcb5: Already exists + 99da72cfe067: Already exists + 5d5bd9951e26: Already exists + fb434121fc77: Already exists + Digest: sha256:ad89e88beb7dc73bf55d456e2c600e0a39dd6c9500d7cd8d1025626c4b985011 + Status: Downloaded newer image for maryatdocker/docker-whale:latest + ________________________________________ + / Having wandered helplessly into a \ + | blinding snowstorm Sam was greatly | + | relieved to see a sturdy Saint Bernard | + | dog bounding toward him with the | + | traditional keg of brandy strapped to | + | his collar. | + | | + | "At last," cried Sam, "man's best | + \ friend -- and a great big dog, too!" / + ---------------------------------------- + \ + \ + \ + ## . + ## ## ## == + ## ## ## ## === + /""""""""""""""""___/ === + ~~~ {~~ ~~~~ ~~~ ~~~~ ~~ ~ / ===- ~~~ + \______ o __/ + \ \ __/ + \____\______/ + +.. Where to go next + +次は何をしますか +==================== + +.. You’ve done a lot, you’ve done all of the following fundamental Docker tasks. + +これで Docker の基本的なタスクを扱う全てが終了しました。 + +.. installed Docker + run a software image in a container + located an interesting image on Docker Hub + run the image on your own machine + modified an image to create your own and run it + create a Docker Hub account and repository + pushed your image to Docker Hub for others to share + +* Docker をインストールする。 +* コンテナでソフトウェアのイメージを実行する。 +* Docker Hub 上で興味あるイメージをさがす。 +* 自分のマシン上でイメージを実行する。 +* 実行するイメージに対する変更を加え、イメージを作成する。 +* Docker Hub 上のアカウントとリポジトリの作成。 +* 他の人と共有できるよう Docker Hub イメージを送信。 + +.. Tweet your accomplishment! + +`完了したことを Tweet しましょう！ `_ + +.. You’ve only scratched the surface of what Docker can do. Go to the next page to learn more. + +Docker ができることを詳しく知りたくありませんか。次のページから :doc:`より詳細を学びましょう ` 。 + +.. seealso:: + + Tag, push, and pull your image + https://docs.docker.com/mac/step_six/ + diff --git a/mac/step_three.rst b/mac/step_three.rst new file mode 100644 index 000000000..27415f31d --- /dev/null +++ b/mac/step_three.rst @@ -0,0 +1,198 @@ +.. -*- coding: utf-8 -*- +.. https://docs.docker.com/mac/step_three/ +.. doc version: 1.10 +.. check date: 2016/4/13 +.. ----------------------------------------------------------------------------- + +.. Find and run the whalesay image + +.. _find-and-run-the-whalesay-image-mac: + +======================================== +whalesay イメージの実行 +======================================== + +.. sidebar:: 目次 + + .. contents:: + :depth: 3 + :local: + +.. People all over the world create Docker images. You can find these images by browsing the Docker Hub. In this next section, you’ll search for and find the image you’ll use in the rest of this getting started. + +世界中の皆さんが Docker イメージを作成しています。これらのイメージを Docker Hub 上で閲覧できます。このセクションでは、使うためのイメージを探し始めましょう。 + +.. Step 1: Locate the whalesay image + +.. _step-1-locate-the-whalesay-image-mac: + +ステップ１：whalesay イメージを探す +======================================== + +.. Open your browser and browse to the Docker Hub. + +1. ブラウザを起動し、 `Docker Hub を開きます `_ 。 + +.. image:: /tutimg/browse_and_search.png + :scale: 60% + :alt: 開いて検索 + +.. The Docker Hub contains images from individuals like you and official images from organizations like RedHat, IBM, Google, and a whole lot more. + +Docker Hub には皆さんのような個人で作成したイメージと、何らかの組織、例えば RedHat、IBM、Googole 等が作成した公式イメージ（オフィシャル・イメージ）があります。 + +.. Click Browse & Search. + +2. ``Search`` をクリックします。 + +.. The browser opens the search page. + +ブラウザで検索ページを開きます。 + +.. Enter the word whalesay in the search bar. + +3. 検索バーに ``whalesay`` を入力します（訳者注： whalesay とは whale say = 鯨が話す、という意味です）。 + +.. image:: /tutimg/image_found.png + :scale: 60% + +.. Click on the docker/whalesay image in the results. + +.. 検索結果にある docker/whalesay イメージをクリックします。 + +.. The browser displays the repository for the whalesay image. + +ブラウザは whalesay イメージのリポジトリを表示します。 + +.. image:: /tutimg/whale_repo.png + :scale: 60% + +.. Each image repository contains information about an image. It should include information such as what kind of software the image contains and how to use it. You may notice that the whalesay image is based on a Linux distribution called Ubuntu. In the next step, you run the whalesay image on your machine. + +各イメージ・リポジトリにはイメージに関する情報が掲載されています。この中にはイメージにどのような種類のソフトウェアが入っているかや、どのように使うかについての説明があるでしょう。ここでは whalesay イメージが Ubuntu と呼ばれる Linux ディストリビューションをベースにしていることを覚えておきます。次のステップでは、自分のマシン上で whalesay イメージを実行しましょう。 + +.. Step 2: Run the whalesay image + +.. _step-2-run-the-whalesay-image-mac: + +ステップ２：whaysay イメージの実行 +================================== + +.. If you don’t already have the Docker Quickstart Terminal open, open one now: + +Docker クイックスタート・ターミナルを開いていなければ、今から開きます。 + +.. Open the Launchpad and locate the Docker Quickstart Terminal icon. + +1. Launchpad を開き、Docker Quickstart Terminal アイコンを探します。 + +.. Click the icon to launch a Docker Quickstart Terminal. + +2. アイコンをクリックし、 Docker クイックスタート・ターミナルを起動します。 + +.. Put your cursor in your Docker Quickstart Terminal at the $ prompt. + +3. Docker クイックスタート・ターミナルの ``$`` プロンプトにカーソルを移動します。 + +.. Type the docker run docker/whalesay cowsay boo command and press RETURN. + +4. ``docker run docker/whalesay cowsay boo`` コマンドを入力し、リターンキーを押します。 + +.. This command runs the whalesay image in a container. Your terminal should look like the following: + +コマンドを実行すると、コンテナ内で whalesay イメージを実行します。ターミナル上では、次のように表示されるでしょう。 + +.. code-block:: bash + + $ docker run docker/whalesay cowsay boo + Unable to find image 'docker/whalesay:latest' locally + latest: Pulling from docker/whalesay + e9e06b06e14c: Pull complete + a82efea989f9: Pull complete + 37bea4ee0c81: Pull complete + 07f8e8c5e660: Pull complete + 676c4a1897e6: Pull complete + 5b74edbcaa5b: Pull complete + 1722f41ddcb5: Pull complete + 99da72cfe067: Pull complete + 5d5bd9951e26: Pull complete + fb434121fc77: Already exists + Digest: sha256:d6ee73f978a366cf97974115abe9c4099ed59c6f75c23d03c64446bb9cd49163 + Status: Downloaded newer image for docker/whalesay:latest + _____ + < boo > + ----- + \ + \ + \ + ## . + ## ## ## == + ## ## ## ## === + /""""""""""""""""___/ === + ~~~ {~~ ~~~~ ~~~ ~~~~ ~~ ~ / ===- ~~~ + \______ o __/ + \ \ __/ + \____\______/ + +.. The first time you run a software image, the docker command looks for it on your local system. If the image isn’t there, then docker gets it from the hub. + +``docker`` コマンドを手許（ローカル）のシステム上でソフトウエア・イメージを初めて実行しました。イメージが手許になければ、 ``docker`` は Docker Hub から取得します。 + +.. While still in the Docker Quickstart Terminal, type docker images command and press RETURN. + +5. Docker クイックスタート・ターミナルを開いたまま ``docker images`` コマンドを入力してリターンキーを押します。 + +.. The command lists all the images on your local system. You should see docker/whalesay in the list. + +このコマンドは手許のシステム上にある全イメージを表示します。一覧に ``docker/whalesay`` イメージが見えるでしょう。 + +.. code-block:: bash + + $ docker images + REPOSITORY TAG IMAGE ID CREATED VIRTUAL SIZE + docker/whalesay latest fb434121fc77 3 hours ago 247 MB + hello-world latest 91c95931e552 5 weeks ago 910 B + +.. When you run an image in a container, Docker downloads the image to your computer. This local copy of the image saves you time. Docker only downloads the image again if the image’s source changes on the hub. You can, of course, delete the image yourself. You’ll learn more about that later. Let’s leave the image there for now because we are going to use it later. + +コンテナ内でイメージを実行する時、Docker は手許のコンピュータ上にイメージをダウンロードします。イメージのコピーを手許に作成するため、時間の節約になります。Docker がイメージをダウンロードするのは、 Docker Hub 上の元イメージに変更が加わった時のみです。もちろん、イメージは自分で削除もできます。詳細は後ほど学びます。この後もイメージを使うため、今はこのままにしておきます。 + +.. Take a moment to play with the whalesay container a bit. + +6. もう少し whalesay コンテナで遊んでみましょう。 + +.. Try running the whalesay image again with a word or phrase. Try a long or short phrase. Can you break the cow? + +``whalesay`` イメージを再度使いますが、今度は言葉を変えてみましょう。長い、もしくは短いフレーズに置き換えます。何かしら喋らせましたか？ + +.. code-block:: bash + + $ docker run docker/whalesay cowsay boo-boo + _________ + < boo-boo > + --------- + \ + \ + \ + ## . + ## ## ## == + ## ## ## ## === + /""""""""""""""""___/ === + ~~~ {~~ ~~~~ ~~~ ~~~~ ~~ ~ / ===- ~~~ + \______ o __/ + \ \ __/ + \____\______/ + +.. Where to go next + +次は何をしますか +==================== + +.. On this page, you learned to search for images on Docker Hub. You used your command line to run an image. Think about it, effectively you ran a piece of Linux software on your Mac computer. You learned that running an image copies it on your computer. Now, you are ready to create your own Docker image. Go on to the next part to build your own image. + +このページでは Docker Hub 上のイメージを探す方法を学びました。そして、コマンドを使ってイメージを実行しました。Mac コンピュータ上で Linux ソフトウェアの一部を実行するのに効果的だと思いませんか。自分のコンピュータ上にイメージをコピーし、実行する方法を学びました。次は自分で Docker イメージを作ってみましょう。次の :doc:`step_four` に進みます。 + +.. seealso:: + + Find and run the whalesay image + https://docs.docker.com/mac/step_three/ diff --git a/mac/step_two.rst b/mac/step_two.rst new file mode 100644 index 000000000..2adbcf50c --- /dev/null +++ b/mac/step_two.rst @@ -0,0 +1,65 @@ +.. -*- coding: utf-8 -*- +.. https://docs.docker.com/mac/step_two/ +.. doc version: 1.10 +.. check date: 2016/4/13 +.. ----------------------------------------------------------------------------- + +.. Learn about images & containers + +.. _learn-about-images-containers-mac: + +======================================== +イメージとコンテナを学ぶ +======================================== + +.. sidebar:: 目次 + + .. contents:: + :depth: 3 + :local: + +.. Docker Engine provides the core Docker technology that enables images and containers. As the last step in your installation, you ran the Engine docker run hello-world command. With this one command, you completed the core tasks to using Engine. The command you ran had three parts. + +Docker Engine は Docker の中心となる技術を提供します。これはイメージとコンテナを扱う技術です。先ほどのステップでインストールを終えていますので、 ``docker run hello-world`` コマンドを実行できます。このコマンドを１つ実行するだけで、Engine を使う上で中心となるタスクをこなします。コマンドは３つのパーツに分かれています。 + +.. image:: /tutimg/container_explainer.png + :scale: 60% + :alt: docker run hello-world + +.. A container is a stripped-to-basics version of a Linux operating system. An image is software you load into a container. When you ran the command, the Engine Software: + +コンテナとは Linux オペレーティング・システムを基盤としています。イメージとはコンテナの中に取り込むソフトウェアです。コマンドを実行すると、Engine のソフトウェアは以下の処理を行います。 + +.. checked to see if you had the hello-world software image + downloaded the image from the Docker Hub (more about the hub later) + loaded the image into the container and “ran” it + +* ``hello-world`` ソフトウェアのイメージを持っているかどうか確認します。 +* Docker Hub （詳しくは後ほど説明）からイメージをダウンロードします。 +* コンテナにイメージを読み込み「実行」します。 + +.. Depending on how it was built, an image might run a simple, single command and then exit. This is what Hello-World did. + +イメージが何を実行するかは、どのように構築されたかに依存します。ここでは ``Hello-World`` を表示するという単純なコマンドを実行しています。 + +.. A Docker image, though, is capable of much more. An image can start software as complex as a database, wait for you (or someone else) to add data, store the data for later use, and then wait for the next person. + +Docker イメージによっては、様々な処理ができます。データベースのような複雑なソフトウェアも、イメージを使って実行できます。あなた（もしくは誰かが）データを追加するのに待つ必要はなく、保管したデータを使えますし、次の人もすぐに利用できます。 + +.. Who built the hello-world software image though? In this case, Docker did but anyone can. Docker Engine lets people (or companies) create and share software through Docker images. Using Docker Engine, you don’t have to worry about whether your computer can run the software in a Docker image — a Docker container can always run it. + +``hello-world`` ソフトウェアのイメージは、誰が作ったのでしょうか？ これは Docker が作りましたが、誰でも作れます。Docker Engine は人々（あるいは会社）が作成したソフトウェアを、 Docker イメージを通して共有できるようにします。 Docker Engine を使えば、Docker イメージ内のソフトウェアを実行するため、どのコンピュータを使えば良いのか迷う必要がなくなります。Docker コンテナは、どこでも実行できるのです。 + +.. Where to go next + +次は何をしますか +==================== + +.. See, that was quick wasn’t it? Now, you are ready to do some really fun stuff with Docker. Go on to the next part to find and run the whalesay image. + +ほら、迅速でしょう。これで Docker を使って何か面白いことをする準備が整いました。次の :doc:`step_three` に進みましょう。 + +.. seealso:: + + Learn about images & containers + https://docs.docker.com/mac/step_two/ diff --git a/mac/toc.rst b/mac/toc.rst new file mode 100644 index 000000000..c7a92d229 --- /dev/null +++ b/mac/toc.rst @@ -0,0 +1,27 @@ +.. -*- coding: utf-8 -*- +.. +.. doc version: 1.10 +.. check date: 2016/04/05 +.. ----------------------------------------------------------------------------- + +.. Get Started with Docker toc + +以下は初心者向けの導入ガイドです。通常インストール用の詳細ドキュメントは :doc:`こちらのページ` をご覧ください。 + +======================================== +Mac OS X +======================================== + +.. toctree:: + :maxdepth: 1 + :caption: Docker for Mac OS X 目次 + + index.rst + step_one.rst + step_two.rst + step_three.rst + step_four.rst + step_five.rst + step_six.rst + last_page.rst + diff --git a/windows/step_four.rst b/windows/step_four.rst index 25ce7a286..ea45ae110 100644 --- a/windows/step_four.rst +++ b/windows/step_four.rst @@ -94,7 +94,7 @@ .. Create a Dockerfile in the current directory by typing touch Dockerfile and pressing RETURN. -5. ```touch Dockerfile`` と入力してエンターキーを押すと、現在のディレクトリに Dockerfile を作成します。 +5. ``touch Dockerfile`` と入力してエンターキーを押すと、現在のディレクトリに Dockerfile を作成します。 .. Make sure you use a capital D in the file name. Linux file names are case sensitive. diff --git a/windows/step_one.rst b/windows/step_one.rst index 9d0b2fe78..da4f30331 100644 --- a/windows/step_one.rst +++ b/windows/step_one.rst @@ -91,7 +91,7 @@ Windows 7 .. Run the Microsoft® Hardware-Assisted Virtualization Detection Tool and follow the on-screen instructions. -Microsoft の `Hardware-Assisted Virtualization Detection Tool `（ ハードウェア支援仮想化技術検出ツール）を実行し、画面の指示に従います。 +Microsoft の `Hardware-Assisted Virtualization Detection Tool `_ （ ハードウェア支援仮想化技術検出ツール）を実行し、画面の指示に従います。 .. Verify your Windows OS is 64-bit (x64) @@ -262,7 +262,7 @@ Windows セキュリティのダイアログが表示されたら、プログラ .. Typically, the above steps work out-of-the-box, but some scenarios can cause problems. If your docker run hello-world didn’t work and resulted in errors, check out Troubleshooting for quick fixes to common problems. -通常、これらの手順は特に何も考えなくても実行できますが、もしかしたら問題が発生する場合があるかもしれません。 ```docker run hello-world`` が実行できずエラーになる場合は、一般的な問題を解決するための :doc:`トラブルシューティング ` をご覧ください。 +通常、これらの手順は特に何も考えなくても実行できますが、もしかしたら問題が発生する場合があるかもしれません。 ```docker run hello-world`` が実行できずエラーになる場合は、一般的な問題を解決するための :doc:`トラブルシューティング ` をご覧ください。 .. A Windows specific problem you might encounter has to do with the NDIS6 host network filter driver, which is known to cause issues on some Windows versions. For Windows Vista systems and newer, VirtualBox installs NDIS6 driver by default. Issues can range from system slowdowns to networking problems for the virtual machine (VM). If you notice problems, re-run the Docker Toolbox installer, and select the option to install VirtualBox with the NDIS5 driver. diff --git a/windows/step_three.rst b/windows/step_three.rst index 1c884c87d..ebb8485ff 100644 --- a/windows/step_three.rst +++ b/windows/step_three.rst @@ -58,7 +58,7 @@ Docker Hub には皆さんのような個人で作成したイメージと、何 .. Click on the docker/whalesay image in the results. -.. bbbbbbbbbbbbbbbbbbbbbbbbbbb検索結果にある docker/whalesay イメージをクリックします。 +.. 検索結果にある docker/whalesay イメージをクリックします。 .. The browser displays the repository for the whalesay image. diff --git a/windows/toc.rst b/windows/toc.rst index 34aeb4c3a..ce3182634 100644 --- a/windows/toc.rst +++ b/windows/toc.rst @@ -6,12 +6,14 @@ .. Get Started with Docker toc +以下は初心者向けの導入ガイドです。通常インストール用の詳細ドキュメントは :doc:`こちらのページ` をご覧ください。 + ======================================== -Docker for Window +Window ======================================== .. toctree:: - :maxdepth: 2 + :maxdepth: 1 :caption: Docker for Windows 目次 index.rst