diff --git a/docker-hub/builds/automated-build.md b/docker-hub/builds/automated-build.md index 2cdd20df81..a233869978 100644 --- a/docker-hub/builds/automated-build.md +++ b/docker-hub/builds/automated-build.md @@ -1,12 +1,14 @@ --- -description: Automated builds +description: Set up Automated builds keywords: automated, build, images redirect_from: - /docker-cloud/feature-reference/automated-build/ - /docker-cloud/builds/automated-build/ -title: Automated builds +title: Set up Automated builds --- +## How Automated Builds work + Docker Hub can automatically build images from source code in an external repository and automatically push the built image to your Docker repositories. @@ -23,8 +25,8 @@ pushing to the registry. You can use these tests to create a continuous integration workflow where a build that fails its tests does not push the built image. Automated tests do not push images to the registry on their own. [Learn more about automated image testing here.](automated-testing.md) -You can also just use `docker push` to push pre-built images to these -repositories, even if you have automatic builds set up. +> **Note**: You can still use `docker push` to push pre-built images to +repositories with Automated Builds configured. ![An automated build dashboard](images/build-dashboard.png) diff --git a/docker-hub/builds/index.md b/docker-hub/builds/index.md index 41393535af..4b22634498 100644 --- a/docker-hub/builds/index.md +++ b/docker-hub/builds/index.md @@ -1,7 +1,7 @@ --- -description: Getting Started with Builds +description: Overview keywords: builds, images, Hub -title: Getting Started with Builds +title: Overview notoc: true redirect_from: - /docker-cloud/builds/ @@ -15,14 +15,10 @@ repositories directly, or link to your source code and build them in Docker Hub. You can build images manually, or set up automated builds to rebuild your Docker -image on each `git push` to the source code. You can also create automated -tests, and when the tests pass use autoredeploy to automatically update your -running services when a build passes its tests. +image on each `git push` to the source code. For more information, see: -* [Automated builds](automated-build.md) -* [Automated repository tests](automated-testing.md) +* [Automated Builds](automated-build.md) +* [Automated Repository tests](automated-testing.md) * [Advanced options for Autobuild and Autotest](advanced.md) - -![Docker Hub repository General view](images/repo-general.png){:width="650px"} diff --git a/docker-hub/images/repo-create-private.png b/docker-hub/images/repo-create-private.png new file mode 100644 index 0000000000..74e32b5388 Binary files /dev/null and b/docker-hub/images/repo-create-private.png differ diff --git a/docker-hub/images/repo-make-private.png b/docker-hub/images/repo-make-private.png new file mode 100644 index 0000000000..00f58b9521 Binary files /dev/null and b/docker-hub/images/repo-make-private.png differ diff --git a/docker-hub/images/repos-create.png b/docker-hub/images/repos-create.png new file mode 100644 index 0000000000..3586fad217 Binary files /dev/null and b/docker-hub/images/repos-create.png differ diff --git a/docker-hub/repos.md b/docker-hub/repos.md index 23811e6c9b..96d164703c 100644 --- a/docker-hub/repos.md +++ b/docker-hub/repos.md @@ -4,26 +4,40 @@ keywords: Docker, docker, trusted, registry, accounts, plans, Dockerfile, Docker title: Repositories --- -Docker Hub repositories let 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. -- Repositories hold Docker container images: -- One Docker Hub repository can hold many Docker images -- Docker images are pushed to Docker Hub via the [`docker push`](https://docs.docker.com/engine/reference/commandline/push/) command. -- Each image pushed to Docker Hub must have a **tag** -- Tags are named when images are pushed to Docker Hub (e.g. `latest`, `v1.0.0`, `1.0.0`) +Docker images are pushed to Docker Hub via 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 +To create a repository, sign into Docker Hub, click on **Repositories** then **Create Repo**: + +![Create repo](images/repos-create.png) + +When creating a new repository, you can choose to put it in your Docker ID +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 +to 255 characters, and can only contain lowercase letters, numbers or `-` and +`_`. + +The "Short Description" of 100 characters is used in the search results, +while the "Full Description" can be used as the Readme for the repository, and +can use Markdown to add simple formatting. + +After you hit the "Create" button, you then need to `docker push` images to that +Hub based repository. ## Pushing a Docker container image to Docker Hub -To push a repository to the Docker Hub, you need to +To push a repository to the Docker Hub, you must to name your local image using your Docker Hub username, and the -repository name that you created in the previous step. +repository name that you created via Docker Hub on the web. + You can add multiple images to a repository, by adding a specific `:` to it (for example `docs/base:testing`). If it's not specified, the tag defaults to `latest`. + You can name your local images either when you build it, using `docker build -t /[:]`, by re-tagging an existing local image `docker tag /[:]`, @@ -39,13 +53,18 @@ the community. ## Private Repositories -Private repositories allow you to have repositories that contain images that you -want to keep private, either to your own account or within an organization or +Private repositories allow you keep container images private, either to your own account or within an organization or team. -To work with a private repository on [Docker Hub](https://hub.docker.com), you -need to add one using the [Add Repository](https://hub.docker.com/add/repository/) button. You get one private -repository for free with your Docker Hub user account (not usable for +To create a private repo select **Private** when creating a private repo: + +![Create Private Repo](images/repo-create-private.png) + +You can also make an existing repository private by going to the repo's **Settings** tab: + +![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 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/account/billing-plans/) page. @@ -55,9 +74,8 @@ from it using Docker. > **Note**: You need to be signed in and have access to work with a > private repository. -Private repositories are just like public ones. However, it isn't possible to -browse them or search their content on the public registry. They do not get -cached the same way as a public repository either. +> **Note**: Private repositories are not currently available to search via the +top-level search or `docker search` You can designate collaborators and manage their access to a private repository from that repository's *Settings* page. You can also toggle the @@ -65,10 +83,6 @@ 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/) plan. -## Public Repositories - -## Editing Repository information - ## Collaborators and their role A collaborator is someone you want to give access to a private repository. Once @@ -94,28 +108,7 @@ 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. -![images/busybox-image-tags.png](/docker-hub/images/busybox-image-tags.png) - -## Creating a new repository on Docker Hub - -When you first create a Docker Hub user, you see a "Get started with -Docker Hub." screen, from which you can click directly into "Create Repository". -You can also use the "Create ▼" menu to "Create Repository". - -When creating a new repository, you can choose to put it in your Docker ID -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 -to 255 characters, and can only contain lowercase letters, numbers or `-` and -`_`. - -The "Short Description" of 100 characters is used in the search results, -while the "Full Description" can be used as the Readme for the repository, and -can use Markdown to add simple formatting. - -After you hit the "Create" button, you then need to `docker push` images to that -Hub based repository. - - +![images/busybox-image-tags.png](images/busybox-image-tags.png) ## Searching for Repositories