From d389dffe421d1715a494a239162f763a761d37db Mon Sep 17 00:00:00 2001 From: Sebastiaan van Stijn Date: Mon, 2 Nov 2020 17:27:49 +0100 Subject: [PATCH] docker-hub: formatting updates in repos.md Signed-off-by: Sebastiaan van Stijn --- docker-hub/repos.md | 48 ++++++++++++++++++++++----------------------- 1 file changed, 24 insertions(+), 24 deletions(-) diff --git a/docker-hub/repos.md b/docker-hub/repos.md index b11f5af01f..b44a6ae526 100644 --- a/docker-hub/repos.md +++ b/docker-hub/repos.md @@ -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 /[:]` +* When you build them, using `docker build -t /[:]` * By re-tagging an existing local image `docker tag /[:]` - * By using `docker commit /[:]` -to commit changes + to commit changes Now you can push this repository to the registry designated by its name or tag. - $ docker push /: +```console +$ docker push /: +``` 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 `: -``` +```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.