|
@@ -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
|
|
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
|
|
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).
|
|
and we've seen how to [create your own images](/userguide/dockerimages).
|
|
|
|
|
|
Now we're going to learn a bit more about
|
|
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.
|
|
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,
|
|
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
|
|
that you can download and use to build your containers. It also provides
|
|
authentication, structure (you can setup teams and organizations), work
|
|
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
|
|
like private repositories for storing images you don't want to publicly
|
|
share.
|
|
share.
|
|
|
|
|
|
-## Docker commands and Docker.io
|
|
|
|
|
|
+## Docker commands and Docker Hub
|
|
|
|
|
|
Docker acts as a client for these services via the `docker search`,
|
|
Docker acts as a client for these services via the `docker search`,
|
|
`pull`, `login` and `push` commands.
|
|
`pull`, `login` and `push` commands.
|
|
@@ -29,7 +29,7 @@ Docker acts as a client for these services via the `docker search`,
|
|
## Searching for images
|
|
## Searching for images
|
|
|
|
|
|
As we've already seen we can search the
|
|
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,
|
|
or using the command line interface. Searching can find images by name,
|
|
user name or description:
|
|
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.
|
|
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
|
|
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
|
|
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
|
|
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
|
|
$ 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`
|
|
> Your authentication credentials will be stored in the [`.dockercfg`
|
|
> authentication file](#authentication-file) in your home directory.
|
|
> 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,
|
|
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
|
|
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.
|
|
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/).
|
|
information [here](/docker-io/).
|
|
|
|
|
|
* Private repositories
|
|
* Private repositories
|
|
@@ -111,29 +111,29 @@ information [here](/docker-io/).
|
|
## Private Repositories
|
|
## Private Repositories
|
|
|
|
|
|
Sometimes you have images you don't want to make public and share with
|
|
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
|
|
## Organizations and teams
|
|
|
|
|
|
One of the useful aspects of private repositories is that you can share
|
|
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
|
|
create organizations where you can collaborate with your colleagues and
|
|
manage private repositories. You can create and manage an organization
|
|
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
|
|
|
|
|
|
Automated Builds automate the building and updating of images from [GitHub](https://www.github.com)
|
|
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
|
|
your selected GitHub or BitBucket repository, triggering a build and update when you push a
|
|
commit.
|
|
commit.
|
|
|
|
|
|
### To setup an Automated Build
|
|
### 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.
|
|
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).
|
|
5. Pick the branch you want to build (the default is the `master` branch).
|
|
6. Give the Automated Build a name.
|
|
6. Give the Automated Build a name.
|
|
@@ -142,12 +142,12 @@ commit.
|
|
|
|
|
|
Once the Automated Build is configured it will automatically trigger a
|
|
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
|
|
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
|
|
It will stay in sync with your GitHub and BitBucket repository until you
|
|
deactivate the Automated Build.
|
|
deactivate the Automated Build.
|
|
|
|
|
|
If you want to see the status of your Automated Builds you can go to your
|
|
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.
|
|
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
|
|
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
|
|
### 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.
|
|
allows you to rebuild an Automated build image on demand.
|
|
|
|
|
|
## Webhooks
|
|
## Webhooks
|