Initial links

Docker-DCO-1.1-Signed-off-by: James Turnbull <james@lovedthanlost.net> (github: jamtur01)
This commit is contained in:
James Turnbull
2014-06-08 14:54:32 -07:00
parent c9f216d2fa
commit ef364f7e1f
40 changed files with 205 additions and 198 deletions
@@ -1,15 +1,15 @@
page_title: Getting started with Docker.io
page_description: Introductory guide to getting an account on Docker.io
page_title: Getting started with Docker Hub
page_description: Introductory guide to getting an account on Docker Hub
page_keywords: documentation, docs, the docker guide, docker guide, docker, docker platform, virtualization framework, docker.io, central service, services, how to, container, containers, automation, collaboration, collaborators, registry, repo, repository, technology, github webhooks, trusted builds
# Getting Started with Docker.io
# Getting Started with Docker Hub
*How do I use Docker.io?*
*How do I use Docker Hub?*
In this section we're going to introduce you, very quickly!, to
[Docker.io](https://index.docker.io) and create an account.
[Docker Hub](https://hub.docker.com) and create an account.
[Docker.io](https://www.docker.io) is the central hub for Docker. It
[Docker Hub](https://www.docker.io) is the central hub for Docker. It
helps you to manage Docker and its components. It provides services such
as:
@@ -19,15 +19,15 @@ as:
hooks.
* Integration with GitHub and BitBucket.
Docker.io helps you collaborate with colleagues and get the most out of
Docker Hub helps you collaborate with colleagues and get the most out of
Docker.
In order to use Docker.io you will need to register an account. Don't
In order to use Docker Hub you will need to register an account. Don't
panic! It's totally free and really easy.
## Creating a Docker.io Account
## Creating a Docker Hub Account
There are two ways you can create a Docker.io account:
There are two ways you can create a Docker Hub account:
* Via the web, or
* Via the command line.
@@ -41,7 +41,7 @@ choose your user name and specify some details such as an email address.
### Signup via the command line
You can also create a Docker.io account via the command line using the
You can also create a Docker Hub account via the command line using the
`docker login` command.
$ sudo docker login
@@ -63,7 +63,7 @@ Or via the command line and the `docker login` command:
$ sudo docker login
Now your Docker.io account is active and ready for you to use!
Now your Docker Hub account is active and ready for you to use!
## Next steps
+11 -11
View File
@@ -1,6 +1,6 @@
page_title: Working with Docker Images
page_description: How to work with Docker images.
page_keywords: documentation, docs, the docker guide, docker guide, docker, docker platform, virtualization framework, docker.io, Docker images, Docker image, image management, Docker repos, Docker repositories, docker, docker tag, docker tags, Docker.io, collaboration
page_keywords: documentation, docs, the docker guide, docker guide, docker, docker platform, virtualization framework, docker.io, Docker images, Docker image, image management, Docker repos, Docker repositories, docker, docker tag, docker tags, Docker Hub, collaboration
# Working with Docker Images
@@ -13,14 +13,14 @@ image and the `training/webapp` image.
We've also discovered that Docker stores downloaded images on the Docker
host. If an image isn't already present on the host then it'll be
downloaded from a registry: by default the
[Docker.io](https://index.docker.io) public registry.
[Docker Hub](https://hub.docker.com) public registry.
In this section we're going to explore Docker images a bit more
including:
* Managing and working with images locally on your Docker host;
* Creating basic images;
* Uploading images to [Docker.io](https://index.docker.io).
* Uploading images to [Docker Hub](https://hub.docker.com).
## Listing images on the host
@@ -45,7 +45,7 @@ do this using the `docker images` command like so:
ubuntu lucid 3db9c44f4520 4 weeks ago 183 MB
We can see the images we've previously used in our [user guide](/userguide/).
Each has been downloaded from [Docker.io](https://index.docker.io) when we
Each has been downloaded from [Docker Hub](https://hub.docker.com) when we
launched a container using that image.
We can see three crucial pieces of information about our images in the listing.
@@ -104,8 +104,8 @@ download the image.
One of the features of Docker is that a lot of people have created Docker
images for a variety of purposes. Many of these have been uploaded to
[Docker.io](https://index.docker.io). We can search these images on the
[Docker.io](https://index.docker.io) website.
[Docker Hub](https://hub.docker.com). We can search these images on the
[Docker Hub](https://hub.docker.com) website.
![indexsearch](/userguide/search.png)
@@ -359,12 +359,12 @@ Let's see our new tag using the `docker images` command.
ouruser/sinatra devel 5db5f8471261 11 hours ago 446.7 MB
ouruser/sinatra v2 5db5f8471261 11 hours ago 446.7 MB
## Push an image to Docker.io
## Push an image to Docker Hub
Once you've built or created a new image you can push it to [Docker.io](
https://index.docker.io) using the `docker push` command. This allows you to
share it with others, either publicly, or push it into [a private
repository](https://index.docker.io/plans/).
Once you've built or created a new image you can push it to [Docker
Hub](https://hub.docker.com) using the `docker push` command. This
allows you to share it with others, either publicly, or push it into [a
private repository](https://registry.hub.docker.com/plans/).
$ sudo docker push ouruser/sinatra
The push refers to a repository [ouruser/sinatra] (len: 1)
+1 -1
View File
@@ -30,7 +30,7 @@ operating system image.
When you specify an image, Docker looks first for the image on your
Docker host. If it can't find it then it downloads the image from the public
image registry: [Docker.io](https://index.docker.io).
image registry: [Docker Hub](https://hub.docker.com).
Next we told Docker what command to run inside our new container:
+26 -26
View File
@@ -1,8 +1,8 @@
page_title: Working with Docker.io
page_description: Learning how to use Docker.io to manage images and work flow
page_keywords: repo, Docker.io, Docker Hub, registry, index, repositories, usage, pull image, push image, image, documentation
page_title: Working with Docker Hub
page_description: Learning how to use Docker Hub to manage images and work flow
page_keywords: repo, Docker Hub, Docker Hub, registry, index, repositories, usage, pull image, push image, image, documentation
# Working with Docker.io
# Working with Docker Hub
So far we've seen a lot about how to use Docker on the command line and
your local host. We've seen [how to pull down
@@ -10,10 +10,10 @@ images](/userguide/usingdocker/) that you can run your containers from
and we've seen how to [create your own images](/userguide/dockerimages).
Now we're going to learn a bit more about
[Docker.io](https://index.docker.io) and how you can use it to enhance
[Docker Hub](https://hub.docker.com) and how you can use it to enhance
your Docker work flows.
[Docker.io](https://index.docker.io) is the public registry that Docker
[Docker Hub](https://hub.docker.com) is the public registry that Docker
Inc maintains. It contains a huge collection of images, over 15,000,
that you can download and use to build your containers. It also provides
authentication, structure (you can setup teams and organizations), work
@@ -21,7 +21,7 @@ flow tools like webhooks and build triggers as well as privacy features
like private repositories for storing images you don't want to publicly
share.
## Docker commands and Docker.io
## Docker commands and Docker Hub
Docker acts as a client for these services via the `docker search`,
`pull`, `login` and `push` commands.
@@ -29,7 +29,7 @@ Docker acts as a client for these services via the `docker search`,
## Searching for images
As we've already seen we can search the
[Docker.io](https://index.docker.io) registry via it's search interface
[Docker Hub](https://hub.docker.com) registry via it's search interface
or using the command line interface. Searching can find images by name,
user name or description:
@@ -57,15 +57,15 @@ Once you have found the image you want, you can download it:
The image is now available to run a container from.
## Contributing to Docker.io
## Contributing to Docker Hub
Anyone can pull public images from the [Docker.io](http://index.docker.io)
Anyone can pull public images from the [Docker Hub](https://hub.docker.com)
registry, but if you would like to share your own images, then you must
register a user first as we saw in the [first section of the Docker User
Guide](/userguide/dockerio/).
Guide](/userguide/dockerhub/).
To refresh your memory, you can create your user name and login to
[Docker.io](https://index.docker.io/account/signup/), or by running:
[Docker Hub](https://hub.docker.com/account/signup/), or by running:
$ sudo docker login
@@ -85,7 +85,7 @@ you in. Now you're ready to commit and push your own images!
> Your authentication credentials will be stored in the [`.dockercfg`
> authentication file](#authentication-file) in your home directory.
## Pushing a repository to Docker.io
## Pushing a repository to Docker Hub
In order to push an repository to its registry you need to have named an image,
or committed your container to a named image as we saw
@@ -98,9 +98,9 @@ or tag.
The image will then be uploaded and available for use.
## Features of Docker.io
## Features of Docker Hub
Now let's look at some of the features of Docker.io. You can find more
Now let's look at some of the features of Docker Hub. You can find more
information [here](/docker-io/).
* Private repositories
@@ -111,29 +111,29 @@ information [here](/docker-io/).
## Private Repositories
Sometimes you have images you don't want to make public and share with
everyone. So Docker.io allows you to have private repositories. You can
sign up for a plan [here](https://index.docker.io/plans/).
everyone. So Docker Hub allows you to have private repositories. You can
sign up for a plan [here](https://registry.hub.docker.com/plans/).
## Organizations and teams
One of the useful aspects of private repositories is that you can share
them only with members of your organization or team. Docker.io lets you
them only with members of your organization or team. Docker Hub lets you
create organizations where you can collaborate with your colleagues and
manage private repositories. You can create and manage an organization
[here](https://index.docker.io/account/organizations/).
[here](https://registry.hub.docker.com/account/organizations/).
## Automated Builds
Automated Builds automate the building and updating of images from [GitHub](https://www.github.com)
or [BitBucket](http://bitbucket.com), directly on Docker.io. It works by adding a commit hook to
or [BitBucket](http://bitbucket.com), directly on Docker Hub. It works by adding a commit hook to
your selected GitHub or BitBucket repository, triggering a build and update when you push a
commit.
### To setup an Automated Build
1. Create a [Docker.io account](https://index.docker.io/) and login.
2. Link your GitHub or BitBucket account through the [`Link Accounts`](https://index.docker.io/account/accounts/) menu.
3. [Configure an Automated Build](https://index.docker.io/builds/).
1. Create a [Docker Hub account](https://hub.docker.com/) and login.
2. Link your GitHub or BitBucket account through the [`Link Accounts`](https://registry.hub.docker.com/account/accounts/) menu.
3. [Configure an Automated Build](https://registry.hub.docker.com/builds/).
4. Pick a GitHub or BitBucket project that has a `Dockerfile` that you want to build.
5. Pick the branch you want to build (the default is the `master` branch).
6. Give the Automated Build a name.
@@ -142,12 +142,12 @@ commit.
Once the Automated Build is configured it will automatically trigger a
build, and in a few minutes, if there are no errors, you will see your
new Automated Build on the [Docker.io](https://index.docker.io) Registry.
new Automated Build on the [Docker Hub](https://hub.docker.com) Registry.
It will stay in sync with your GitHub and BitBucket repository until you
deactivate the Automated Build.
If you want to see the status of your Automated Builds you can go to your
[Automated Builds page](https://index.docker.io/builds/) on the Docker.io,
[Automated Builds page](https://registry.hub.docker.io/builds/) on the Docker Hub,
and it will show you the status of your builds, and the build history.
Once you've created an Automated Build you can deactivate or delete it. You
@@ -160,7 +160,7 @@ to point to specific `Dockerfile`'s or Git branches.
### Build Triggers
Automated Builds can also be triggered via a URL on Docker.io. This
Automated Builds can also be triggered via a URL on Docker Hub. This
allows you to rebuild an Automated build image on demand.
## Webhooks
+2 -2
View File
@@ -135,8 +135,8 @@ restore testing using your preferred tools.
Now we've learned a bit more about how to use Docker we're going to see how to
combine Docker with the services available on
[Docker.io](https://index.docker.io) including Automated Builds and private
[Docker Hub](https://hub.docker.com) including Automated Builds and private
repositories.
Go to [Working with Docker.io](/userguide/dockerrepos).
Go to [Working with Docker Hub](/userguide/dockerrepos).
+9 -9
View File
@@ -19,15 +19,15 @@ We’ll teach you how to use Docker to:
We've broken this guide into major sections that take you through
the Docker life cycle:
## Getting Started with Docker.io
## Getting Started with Docker Hub
*How do I use Docker.io?*
*How do I use Docker Hub?*
Docker.io is the central hub for Docker. It hosts public Docker images
Docker Hub is the central hub for Docker. It hosts public Docker images
and provides services to help you build and manage your Docker
environment. To learn more;
Go to [Using Docker.io](/userguide/dockerio).
Go to [Using Docker Hub](/userguide/dockerhub).
## Dockerizing Applications: A "Hello World!"
@@ -72,18 +72,18 @@ learning how to manage data, volumes and mounts inside our containers.
Go to [Managing Data in Containers](/userguide/dockervolumes).
## Working with Docker.io
## Working with Docker Hub
Now we've learned a bit more about how to use Docker we're going to see
how to combine Docker with the services available on Docker.io including
Automated Builds and private repositories.
how to combine Docker with the services available on Docker Hub including
Trusted Builds and private repositories.
Go to [Working with Docker.io](/userguide/dockerrepos).
Go to [Working with Docker Hub](/userguide/dockerrepos).
## Getting help
* [Docker homepage](http://www.docker.io/)
* [Docker.io](http://index.docker.io)
* [Docker Hub](https://hub.docker.com)
* [Docker blog](http://blog.docker.io/)
* [Docker documentation](http://docs.docker.io/)
* [Docker Getting Started Guide](http://www.docker.io/gettingstarted/)
+1 -1
View File
@@ -309,7 +309,7 @@ And now our container is stopped and deleted.
# Next steps
Until now we've only used images that we've downloaded from
[Docker.io](https://index.docker.io) now let's get introduced to
[Docker Hub](https://hub.docker.com) now let's get introduced to
building and sharing our own images.
Go to [Working with Docker Images](/userguide/dockerimages).