docker
/
docs
mirror of https://github.com/docker/docs.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

Repos UI updates (#9825) 

* updates to repos page based on cloud and Hub UI consolidation

Signed-off-by: Lena Larionova <lena.larionova@docker.com>

* spacing

Signed-off-by: Lena Larionova <lena.larionova@docker.com>
This commit is contained in:
lena-larionova 2019-11-07 14:26:16 -08:00 committed by GitHub
parent 082b0f0ae6
commit 094d94f7ef
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
9 changed files with 93 additions and 61 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

BIN
docker-hub/images/repo-create-details.png Normal file
View File

Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 256 KiB

BIN
docker-hub/images/repo-create-private.png
View File

Binary file not shown.
Side by Side Swipe Overlay

Before

Width:  |  Height:  |  Size: 160 KiB

After

Width:  |  Height:  |  Size: 82 KiB

BIN
docker-hub/images/repo-image-layers.png Normal file
View File

Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 131 KiB

BIN
docker-hub/images/repo-make-private.png
View File

Binary file not shown.
Side by Side Swipe Overlay

Before

Width:  |  Height:  |  Size: 110 KiB

After

Width:  |  Height:  |  Size: 120 KiB

BIN
docker-hub/images/repo-overview.png Normal file
View File

Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 182 KiB

BIN
docker-hub/images/repo-tags-list.png Normal file
View File

Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 105 KiB

BIN
docker-hub/images/repos-create.png
View File

Binary file not shown.
Side by Side Swipe Overlay

Before

Width:  |  Height:  |  Size: 524 KiB

After

Width:  |  Height:  |  Size: 120 KiB

14
docker-hub/release-notes.md
View File

@ -9,6 +9,18 @@ toc_max: 2
Here you can learn about the latest changes, new features, bug fixes, and Here you can learn about the latest changes, new features, bug fixes, and
known issues for each Docker Hub release. known issues for each Docker Hub release.
# 2019-11-04
### Enhancements
* The [repositories page](https://docs.docker.com/docker-hub/repos/) and all
related settings and tabs have been updated and moved from `cloud.docker.com`
to `hub.docker.com`. You can access the page at its new URL: [https://hub.docker.com/repositories](https://hub.docker.com/repositories).
### Known Issues
* Scan results don't appear for some official images.
# 2019-10-21 # 2019-10-21
### New features ### New features
@ -18,8 +30,6 @@ known issues for each Docker Hub release.
> not be able to recover your account. > not be able to recover your account.
{: .important } {: .important }
### Enhancements ### Enhancements
* As a security measure, when two-factor authentication is enabled, the Docker CLI requires a personal access token instead of a password to log in. * As a security measure, when two-factor authentication is enabled, the Docker CLI requires a personal access token instead of a password to log in.

140
docker-hub/repos.md
View File

@ -7,42 +7,57 @@ title: Repositories
Docker Hub repositories allow you share container images with your team, Docker Hub repositories allow you share container images with your team,
customers, or the Docker community at large. customers, or the Docker community at large.
Docker images are pushed to Docker Hub through the [`docker push`](https://docs.docker.com/engine/reference/commandline/push/) command. A single Docker Hub repository can hold many Docker images (stored as **tags**). Docker images are pushed to Docker Hub through the [`docker push`](https://docs.docker.com/engine/reference/commandline/push/)
command. A single Docker Hub repository can hold many Docker images (stored as
**tags**).
## Creating Repositories ## Creating repositories
To create a repository, sign into Docker Hub, click on **Repositories** then **Create Repo**: To create a repository, sign into Docker Hub, click on **Repositories** then
**Create Repository**:
![Create repo](images/repos-create.png) ![Create repo](images/repos-create.png)
When creating a new repository, you can choose to put it in your Docker ID When creating a new repository:
namespace, or that of any [Organization](/docker-hub/orgs.md) that you are in the "Owners"
team. The Repository Name needs to be unique in that namespace, can be two * You can choose to put it in your Docker ID
namespace, or in any [organization](/docker-hub/orgs.md) where you are an
[_owner_](/orgs/#the-owners-team).
* The repository name needs to be unique in that namespace, can be two
to 255 characters, and can only contain lowercase letters, numbers or `-` and to 255 characters, and can only contain lowercase letters, numbers or `-` and
`_`. `_`.
The "Short Description" of 100 characters is used in the search results, * The description can be up to 100 characters and is used in the search
while the "Full Description" can be used as the Readme for the repository, and result.
can use Markdown to add simple formatting.
After you hit the "Create" button, you then need to `docker push` images to that * You can link a GitHub or Bitbucket account now, or choose to do it
Hub based repository. later in the repository settings.
![Setting page for creating a repo](images/repo-create-details.png)
After you hit the **Create** button, you can start using `docker push` to push
images to this repository.
## Pushing a Docker container image to Docker Hub ## Pushing a Docker container image to Docker Hub
To push a repository to the Docker Hub, you must To push an image to Docker Hub, you must first name your local image using your
name your local image using your Docker Hub username, and the Docker Hub username and the repository name that you created through Docker Hub
repository name that you created through Docker Hub on the web. on the web.
You can add multiple images to a repository, by adding a specific `:<tag>` to You can add multiple images to a repository by adding a specific `:<tag>` to
it (for example `docs/base:testing`). If it's not specified, the tag defaults to them (for example `docs/base:testing`). If it's not specified, the tag defaults
`latest`. to `latest`.
You can name your local images either when you build it, using Name your local images using one of these methods:
`docker build -t <hub-user>/<repo-name>[:<tag>]`, * When you build them, using
by re-tagging an existing local image `docker tag <existing-image> <hub-user>/<repo-name>[:<tag>]`, `docker build -t <hub-user>/<repo-name>[:<tag>]`
or by using `docker commit <existing-container> <hub-user>/<repo-name>[:<tag>]` to commit
changes. * By re-tagging an existing local image `docker tag <existing-image> <hub-user>/<repo-name>[:<tag>]`
* By using `docker commit <existing-container> <hub-user>/<repo-name>[:<tag>]`
to commit changes
Now you can push this repository to the registry designated by its name or tag. Now you can push this repository to the registry designated by its name or tag.
@ -51,22 +66,23 @@ Now you can push this repository to the registry designated by its name or tag.
The image is then uploaded and available for use by your teammates and/or The image is then uploaded and available for use by your teammates and/or
the community. the community.
## Private Repositories ## Private repositories
Private repositories allow you keep container images private, either to your own account or within an organization or Private repositories let you keep container images private, either to your
team. own account or within an organization or team.
To create a private repo select **Private** when creating a private repo: To create a private repository, select **Private** when creating a repository:
![Create Private Repo](images/repo-create-private.png) ![Create Private Repo](images/repo-create-private.png)
You can also make an existing repository private by going to the repo's **Settings** tab: You can also make an existing repository private by going to its **Settings** tab:
![Convert Repo to Private](images/repo-make-private.png) ![Convert Repo to Private](images/repo-make-private.png)
You get one private repository for free with your Docker Hub user account (not usable for You get one private repository for free with your Docker Hub user account (not
organizations you're a member of). If you need more private repositories for your user account, upgrade usable for organizations you're a member of). If you need more private
your Docker Hub plan from your [Billing Information](https://hub.docker.com/billing/plan) page. repositories for your user account, upgrade your Docker Hub plan from your
[Billing Information](https://hub.docker.com/billing/plan) page.
Once the private repository is created, you can `push` and `pull` images to and Once the private repository is created, you can `push` and `pull` images to and
from it using Docker. from it using Docker.
@ -74,11 +90,11 @@ from it using Docker.
> **Note**: You need to be signed in and have access to work with a > **Note**: You need to be signed in and have access to work with a
> private repository. > private repository.
> **Note**: Private repositories are not currently available to search through the > **Note**: Private repositories are not currently available to search through
top-level search or `docker search` > the top-level search or `docker search`.
You can designate collaborators and manage their access to a private You can designate collaborators and manage their access to a private
repository from that repository's *Settings* page. You can also toggle the repository from that repository's **Settings** page. You can also toggle the
repository's status between public and private, if you have an available repository's status between public and private, if you have an available
repository slot open. Otherwise, you can upgrade your repository slot open. Otherwise, you can upgrade your
[Docker Hub](https://hub.docker.com/account/billing-plans/) plan. [Docker Hub](https://hub.docker.com/account/billing-plans/) plan.
@ -102,53 +118,59 @@ see the [organizations documentation](/docker-hub/orgs.md).
## Viewing repository tags ## Viewing repository tags
Docker Hub's individual repositories view shows you the available tags and the Docker Hub's individual repositories view shows you the available tags and the
size of the associated image. Go to the "Repositories" view and click on a size of the associated image. Go to the **Repositories** view and click on a
repository to see its tags. repository to see its tags.
![Repository View](images/repo-view-2019.png) ![Repository View](images/repos-create.png)
![View Repo Tags](images/repos-tags-view-2019.png) ![View Repo Tags](images/repo-overview.png)
Image sizes are the cumulative space taken up by the image and all its parent Image sizes are the cumulative space taken up by the image and all its parent
images. This is also the disk space used by the contents of the .tar file images. This is also the disk space used by the contents of the `.tar` file
created when you `docker save` an image. created when you `docker save` an image.
To view tags, click on "Tags" tab and then select a tag to view. To view individual tags, click on the **Tags** tab.
![Manage Repo Tags](images/repos-tags-manage-2019.png) ![Manage Repo Tags](images/repo-tags-list.png)
![View Tag](images/repo-single-tag-view-2019.png) Select a tag's digest to view details.
![View Tag](images/repo-image-layers.png)
## Searching for Repositories ## Searching for Repositories
You can search the [Docker Hub](https://hub.docker.com) registry through its search You can search the [Docker Hub](https://hub.docker.com) registry through its
interface or by using the command line interface. Searching can find images by search interface or by using the command line interface. Searching can find
image name, user name, or description: images by image name, username, or description:
$ docker search centos ```
NAME DESCRIPTION STARS OFFICIAL AUTOMATED $ docker search centos
centos The official build of CentOS. 1034 [OK] NAME DESCRIPTION STARS OFFICIAL AUTOMATED
ansible/centos7-ansible Ansible on Centos7 43 [OK] centos The official build of CentOS. 1034 [OK]
tutum/centos Centos image with SSH access. For the root... 13 [OK] ansible/centos7-ansible Ansible on Centos7 43 [OK]
... tutum/centos Centos image with SSH access. For the root... 13 [OK]
...
```
There you can see two example results: `centos` and `ansible/centos7-ansible`. There you can see two example results: `centos` and `ansible/centos7-ansible`.
The second result shows that it comes from the public repository of a user, The second result shows that it comes from the public repository of a user,
named `ansible/`, while the first result, `centos`, doesn't explicitly list a named `ansible/`, while the first result, `centos`, doesn't explicitly list a
repository which means that it comes from the top-level namespace for [Official repository which means that it comes from the top-level namespace for [official
Images](/docker-hub/official_images.md). The `/` character separates a user's images](/docker-hub/official_images.md). The `/` character separates a user's
repository from the image name. repository from the image name.
Once you've found the image you want, you can download it with `docker pull <imagename>`: Once you've found the image you want, you can download it with `docker pull <imagename>`:
$ docker pull centos ```
latest: Pulling from centos $ docker pull centos
6941bfcbbfca: Pull complete latest: Pulling from centos
41459f052977: Pull complete 6941bfcbbfca: Pull complete
fd44297e2ddb: Already exists 41459f052977: Pull complete
centos:latest: The image you are pulling has been verified. Important: image verification is a tech preview feature and should not be relied on to provide security. fd44297e2ddb: Already exists
Digest: sha256:d601d3b928eb2954653c59e65862aabb31edefa868bd5148a41fa45004c12288 centos:latest: The image you are pulling has been verified. Important: image verification is a tech preview feature and should not be relied on to provide security.
Status: Downloaded newer image for centos:latest Digest: sha256:d601d3b928eb2954653c59e65862aabb31edefa868bd5148a41fa45004c12288
Status: Downloaded newer image for centos:latest
```
You now have an image from which you can run containers. You now have an image from which you can run containers.