8000 Adding in updates for Mac for upcoming events by moxiegirl · Pull Request #10838 · moby/moby · GitHub
[go: up one dir, main page]
More Web Proxy on the site http://driver.im/
Skip to content

Adding in updates for Mac for upcoming events #10838

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 5 commits into from
Feb 20, 2015
Merged

Adding in updates for Mac for upcoming events #10838

merged 5 commits into from
Feb 20, 2015

Conversation

moxiegirl
Copy link
Contributor
  • Updates to the Mac installation
  • Tested and updated upgrade material
  • Added in some basic Mac exercises (acknowledge inspiration per Steve's ok)

Signed-off-by: Mary Anthony mary.anthony@docker.com

8000
@jessfraz
Copy link
Contributor

cool graphics :)

@moxiegirl
Copy link
Contributor Author

thanks :-)

$ $(boot2docker shellinit)

You can also set them manually by using the `export` commands `boot2docker`
returns.
Copy link
Contributor

Choose a reason for hiding this comment

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

please don't. The IP address can change randomly, and we've had many users taking the export lines and pasting them into their bashrc / profile.

@moxiegirl
Copy link
Contributor Author

You know, I understand your concern, but unless we show them the correct output to expect, readers won't be able to verify they are running correct. There are several techniques in this document that should help avoid this issue.

  • Readers are given a procedure to follow for setup rather than a narrative.

  • The instructions tell them to set their environment using this this:

    $ $(boot2docker init)

The last technique is our standard method in house. Only then do I tell them they can use export. I never actually illustrate setting that value via export on a command line.

I can add a line under the original output saying "your IP address will be different" which is just an added safety measure. Pretty standard ops for similar patterns in docs.


Work through this section to try some practical container tasks using `boot2docker` VM.

### Access container ports
Copy link
Contributor

Choose a reason for hiding this comment

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

from here, this is probably duplicating stuff we have in several places. The programmer in me wants to consolidate and reduce duplication - the reader in my applauds.

Copy link
Contributor Author

Choose a reason for hiding this comment

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

This is a t 8000 eaching technique for this particular situation. It serves several purposes 1) teaches them two new commands 2) If they went away from the page and came back or were interrupted, they can check their terminal.

Copy link
Contributor

Choose a reason for hiding this comment

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

yup, more violent agreement :)

@SvenDowideit
Copy link
Contributor

yup, much goodlyness :)

LGTM, with fixes - @fredlf @jamtur01

green Boot2Docker-x.x.x.pkg button near the bottom of the page.)
On a typical Linux installation, the Docker client, the Docker daemon, and any
containers run directly on your localhost. This means you can address ports on a
Docker container using the standard localhost addressing such as `localhost:8000` or
Copy link
Contributor

Choose a reason for hiding this comment

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

Cut "the"

Copy link
Contributor Author

Choose a reason for hiding this comment

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

done.

### Mount a volume on the container

When you start `boot2docker`, it automatically shares your `/Users` directory
with the VM. You can use this share to mount directories onto your container.
Copy link
Contributor

Choose a reason for hiding this comment

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

share point

Copy link
Contributor Author

Choose a reason for hiding this comment

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

fixed.

@fredlf
Copy link
Contributor
fredlf commented Feb 17, 2015

LGTM with a few copy edits, etc. Good revision. Let's work on always finding the simplest, most pithy to communicate and continue being mindful that we are serving a somewhat diverse group of users in terms of experience.

@SvenDowideit
Copy link
Contributor

The first 2 paragraphs still conflate the boot2docker management tool and the Boot2Docker vm:

Because the Docker daemon uses Linux-specific kernel features, you can't run
Docker natively in OS X. Instead, you must install the Boot2Docker application.
The application includes a VirtualBox Virtual Machine (VM), Docker itself, and the
Boot2Docker management tool.

The Boot2Docker management tool is a lightweight Linux virtual machine made
specifically to run the Docker daemon on Mac OS X. The VirtualBox VM runs
completely from RAM, is a small ~24MB download, and boots in approximately 5s.

I tried (and thus added words :( ) to simplify it a little like:

Because the Docker daemon uses Linux-specific kernel features, you can't run
Docker natively in OS X. Instead, you must install Boot2Docker.
Boot2Docker includes Oracle VM VirtualBox, Docker itself, and the
Boot2Docker management tool.

The Boot2Docker management tool creates a lightweight Linux virtual machine (VM) made
specifically to run the Docker daemon on Mac OS X. The VirtualBox VM runs
a read only micro Linux distribution, with an added persistence disk for the Docker images
and containers. After the first initialization bootup sequence, the Boot2docker VM should
be running and ready to use in 5-10 seconds.

Once you have an initialized virtual machine, you can control it with `boot2docker stop`
and `boot2docker start`.
In OS X, the Docker host address is the address of the Linux VM.
When you start the `boot2docker` process, the VM is assigned an IP address. Under
Copy link
Contributor

Choose a reason for hiding this comment

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

ug. more conflation. - when you start the Boot2Docker VM, is is assigned an IP address - you don't need to use the boot2docker management tool to start the VM, and you can start the boot2docker management tool with other parameters that don't involve the VM at all

@fredlf
Copy link
Contributor
fredlf commented Feb 18, 2015

I would like to consider discussion on this edit concluded. It's a significant improvement over what was here before, it's largely accurate and has been well vetted. If we see further issues, we can change things down the road.

@jamtur01
Copy link
Contributor

LGTM as an interim step. +1 to merge.

jessfraz pushed a commit that referenced this pull request Feb 20, 2015
Adding in updates for Mac for upcoming events
@jessfraz jessfraz merged commit aa057fd into moby:master Feb 20, 2015
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

7 participants
0