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

docker-hub: formatting updates in repos.md 

Signed-off-by: Sebastiaan van Stijn <github@gone.nl>
This commit is contained in:
Sebastiaan van Stijn 2020-11-02 17:27:49 +01:00
parent 48e3c640e4
commit d389dffe42
No known key found for this signature in database
GPG Key ID: 76698F39D527CE8C
1 changed files with 24 additions and 24 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

48
docker-hub/repos.md
View File

@ -20,19 +20,14 @@ To create a repository, sign into Docker Hub, click on **Repositories** then
When creating a new repository:
* You can choose to put it in your Docker ID
namespace, or in any [organization](orgs.md) where you are an
[_owner_](orgs.md#the-owners-team).
* You can choose to put it in your Docker ID namespace, or in any
[organization](orgs.md) where you are an [_owner_](orgs.md#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
`_`.
* The description can be up to 100 characters and is used in the search
result.
* You can link a GitHub or Bitbucket account now, or choose to do it
later in the repository settings.
to 255 characters, and can only contain lowercase letters, numbers, hyphens (`-`),
and underscores (`_`).
* The description can be up to 100 characters and is used in the search result.
* You can link a GitHub or Bitbucket account now, or choose to do it later in
the repository settings.
![Setting page for creating a repo](images/repo-create-details.png)
@ -50,17 +45,17 @@ them (for example `docs/base:testing`). If it's not specified, the tag defaults
to `latest`.
Name your local images using one of these methods:
* When you build them, using
`docker build -t <hub-user>/<repo-name>[:<tag>]`
* When you build them, using `docker build -t <hub-user>/<repo-name>[:<tag>]`
* 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
to commit changes
Now you can push this repository to the registry designated by its name or tag.
$ docker push <hub-user>/<repo-name>:<tag>
```console
$ docker push <hub-user>/<repo-name>:<tag>
```
The image is then uploaded and available for use by your teammates and/or
the community.
@ -72,11 +67,11 @@ own account or within an organization or team.
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){: style="max-width: 60%"}
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){: 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
@ -105,7 +100,8 @@ designated, they can `push` and `pull` to your repositories. They are not
allowed to perform any administrative tasks such as deleting the repository or
changing its status from private to public.
> **Note**:
> **Note**
>
> A collaborator cannot add other collaborators. Only the owner of
> the repository has administrative access.
@ -142,8 +138,9 @@ You can search the [Docker Hub](https://hub.docker.com) registry through its
search interface or by using the command line interface. Searching can find
images by image name, username, or description:
```
```console
$ docker search centos
NAME DESCRIPTION STARS OFFICIAL AUTOMATED
centos The official build of CentOS. 1034 [OK]
ansible/centos7-ansible Ansible on Centos7 43 [OK]
@ -160,8 +157,9 @@ a user's repository from the image name.
Once you've found the image you want, you can download it with `docker pull <imagename>`:
```
```console
$ docker pull centos
latest: Pulling from centos
6941bfcbbfca: Pull complete
41459f052977: Pull complete
@ -181,9 +179,11 @@ bookmarking your favorites.
## Service accounts
A service account is a Docker ID used by a bot for automating the build pipeline for containerized applications. Service accounts are typically used in an automated workflow and do not share Docker IDs with the members in the Team plan.
A service account is a Docker ID used by a bot for automating the build pipeline
for containerized applications. Service accounts are typically used in automated
workflows, and do not share Docker IDs with the members in the Team plan.
To create a new service account for your Team account:
To create a new service account for your Team account:
1. Create a new Docker ID.
2. Create a [team](orgs.md#create-a-team) in your organization and grant it read-only access to your private repositories.