mirror of https://github.com/docker/docs.git
updated repo topics
This commit is contained in:
Jerae Duffin
parent
6f56b41666
commit
0f34b82c9b
|
|
@ -4,6 +4,8 @@ keywords: Docker, docker, trusted, registry, accounts, plans, Dockerfile, Docker
|
|||
title: Access repositories
|
||||
---
|
||||
|
||||
Within your repository, you can give others access to push and pull to your repository, and you can assign permissions. You can also view your repository tags and the associated images.
|
||||
|
||||
## Collaborators and their role
|
||||
|
||||
A collaborator is someone you want to give access to a private repository. Once
|
||||
|
|
@ -23,38 +25,28 @@ see the [organizations documentation](../../../docker-hub/orgs.md#create-an-orga
|
|||
## Viewing repository tags
|
||||
|
||||
Docker Hub's individual repositories view shows you the available tags and the
|
||||
size of the associated image. Go to the **Repositories** view and select repository to see its tags.
|
||||
|
||||
|
||||
size of the associated image. Go to the **Repositories** view and select repository to see its tags. To view individual tags, select the **Tags** tab.
|
||||
|
||||
|
||||
|
||||
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
|
||||
created when you `docker save` an image.
|
||||
created when you `docker save` an image. An image is stale if there has been no push/pull activity for more than one month. For example:
|
||||
|
||||
To view individual tags, select the **Tags** tab.
|
||||
* It hasn't been pulled for more than one month
|
||||
* And it hasn't been pushed for more than one month
|
||||
|
||||
|
||||
|
||||
An image is considered stale if there has been no push/pull activity for more
|
||||
than 1 month, i.e.:
|
||||
|
||||
* It hasn't been pulled for more than 1 month
|
||||
* And it hasn't been pushed for more than 1 month
|
||||
|
||||
A multi-architecture image is considered stale if all single-architecture images
|
||||
A multi-architecture image is stale if all single-architecture images
|
||||
part of its manifest are stale.
|
||||
|
||||
To delete a tag, select the corresponding checkbox and select **Delete** from the
|
||||
**Action** drop-down list.
|
||||
To delete a tag, select the corresponding checkbox and select **Delete** from the **Action** drop-down list.
|
||||
|
||||
> **Note**
|
||||
>
|
||||
> Only a user with administrative access (owner or team member with Admin
|
||||
> permission) over the repository can delete tags.
|
||||
|
||||
Select a tag's digest to view details.
|
||||
You can select a tag's digest to view more details.
|
||||
|
||||
|
||||
|
||||
|
|
@ -99,6 +91,4 @@ You now have an image from which you can run containers.
|
|||
|
||||
## Starring repositories
|
||||
|
||||
Your repositories can be starred and you can star repositories in return. Stars
|
||||
are a way to show that you like a repository. They're also an easy way of
|
||||
bookmarking your favorites.
|
||||
Your can star your repositories. Stars are a way to show that you like a repository. They're also an easy way of bookmarking your favorites.
|
||||
|
|
|
|||
|
|
@ -3,55 +3,46 @@ description: Configuring repositories on Docker Hub
|
|||
keywords: Docker, docker, trusted, registry, accounts, plans, Dockerfile, Docker Hub, webhooks, docs, documentation, creating, deleting, consolidating
|
||||
title: Configure repositories
|
||||
---
|
||||
|
||||
When configuring repositories, your private repositories let you keep your container images private, to your personal account or within an organization or team. You can also view your permissions or manage your users' access to those repositories.
|
||||
|
||||
|
||||
## Private repositories
|
||||
|
||||
Private repositories let you keep container images private, either to your
|
||||
own account or within an organization or team.
|
||||
You can make an existing repository private by going to its **Settings** tab and select **Make private**.
|
||||
|
||||
To create a private repository, select **Private** when creating a repository:
|
||||
{: style="max-width: 60%"}
|
||||
|
||||
{: style="max-width: 60%"}
|
||||
You get one free private repository with your Docker Hub user account (not
|
||||
available for organizations you're a member of). If you need more private
|
||||
repositories for your user account, upgrade your Docker Hub subscription from your [Billing Information](https://hub.docker.com/billing/plan){: target="_blank" rel="noopener" class="_"} page.
|
||||
|
||||
You can also make an existing repository private by going to its **Settings** tab:
|
||||
|
||||
{: style="max-width: 60%"}
|
||||
|
||||
You get one private repository for free with your Docker Hub user account (not
|
||||
usable for organizations you're a member of). If you need more private
|
||||
repositories for your user account, upgrade your Docker Hub plan from your
|
||||
[Billing Information](https://hub.docker.com/billing/plan){: target="_blank" rel="noopener" class="_"} page.
|
||||
|
||||
Once you create the private repository, you can `push` and `pull` images to and
|
||||
Once you've created a private repository, you can `push` and `pull` images to and
|
||||
from it using Docker.
|
||||
|
||||
> **Note**: You must sign in and have access to work with a
|
||||
> private repository.
|
||||
|
||||
> **Note**: Private repositories aren't available to search through
|
||||
> private repository. Private repositories aren't available to search through
|
||||
> the top-level search or `docker search`.
|
||||
|
||||
You can choose collaborators and manage their access to a private
|
||||
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 slot open. Otherwise, you can upgrade your
|
||||
[Docker Hub](https://hub.docker.com/account/billing-plans/){: target="_blank" rel="noopener" class="_"} plan.
|
||||
[Docker Hub](https://hub.docker.com/account/billing-plans/){: target="_blank" rel="noopener" class="_"} subscription.
|
||||
|
||||
### Permissions reference
|
||||
|
||||
Permissions are cumulative. For example, if you have Read & Write permissions,
|
||||
you automatically have Read-only permissions:
|
||||
|
||||
- `Read-only` access allows users to view, search, and pull a private repository in the same way as they can a public repository.
|
||||
- `Read & Write` access allows users to pull, push, and view a repository Docker
|
||||
Hub. In addition, it allows users to view, cancel, retry or trigger builds
|
||||
- `Admin` access allows users to Pull, push, view, edit, and delete a
|
||||
repository; edit build settings; update the repository description modify the
|
||||
repositories "Description", "Collaborators" rights, "Public/Private"
|
||||
visibility, and "Delete".
|
||||
- `Read-only` access lets users view, search, and pull a private repository in the same way as they can a public repository.
|
||||
- `Read & Write` access lets users pull, push, and view a repository. In addition, it lets users view, cancel, retry or trigger builds
|
||||
- `Admin` access lets users pull, push, view, edit, and delete a
|
||||
repository. You can also edit build settings, and update the repositories description, collaborators rights, public/private visibility, and delete.
|
||||
|
||||
> **Note**
|
||||
>
|
||||
> A User who hasn't yet verified their email address only has
|
||||
> A user who hasn't verified their email address only has
|
||||
> `Read-only` access to the repository, regardless of the rights their team
|
||||
> membership has given them.
|
||||
|
||||
|
|
|
|||
|
|
@ -13,7 +13,7 @@ Docker images are pushed to Docker Hub through the [`docker push`](/engine/refer
|
|||
command. A single Docker Hub repository can hold many Docker images (stored as
|
||||
**tags**).
|
||||
|
||||
## Creating repositories
|
||||
## Creating a repository
|
||||
|
||||
To create a repository, sign into Docker Hub, select **Repositories** then
|
||||
**Create Repository**:
|
||||
|
|
@ -31,20 +31,26 @@ When creating a new repository:
|
|||
>
|
||||
> You can't rename a Docker Hub repository once it's created.
|
||||
|
||||
* The description can be up to 100 characters and is used in the search result.
|
||||
* The description can be up to 100 characters and used in the search result.
|
||||
* You can link a GitHub or Bitbucket account now, or choose to do it later in
|
||||
the repository settings.
|
||||
|
||||
|
||||
|
||||
After you hit the **Create** button, you can start using `docker push` to push
|
||||
After you select **Create**, you can start using `docker push` to push
|
||||
images to this repository.
|
||||
|
||||
## Creating a private repository
|
||||
|
||||
To create a private repository, navigate to Docker Hub and select **Repositories** and **Private**.
|
||||
|
||||
{: style="max-width: 60%"}
|
||||
|
||||
## Deleting a repository
|
||||
|
||||
1. Sign into [Docker Hub](https://hub.docker.com){: target="_blank" rel="noopener" class="_"} and select **Repositories**.
|
||||
1. Navigate to [Docker Hub](https://hub.docker.com){: target="_blank" rel="noopener" class="_"} and select **Repositories**.
|
||||
|
||||
2. Select a repository from the list, select **Settings** and then Delete Repository.
|
||||
2. Select a repository from the list, select **Settings**, and then Delete Repository.
|
||||
|
||||
> **Note:**
|
||||
>
|
||||
|
|
|
|||
Loading…
Reference in New Issue