diff --git a/_data/toc.yaml b/_data/toc.yaml index 7d5c44e383..27cadfd8c6 100644 --- a/_data/toc.yaml +++ b/_data/toc.yaml @@ -1353,7 +1353,7 @@ manuals: - path: /docker-hub/service-accounts/ title: Service accounts - path: /docker-hub/official_images/ - title: Official images + title: Docker Official images - sectiontitle: Automated builds section: - path: /docker-hub/builds/ @@ -1399,7 +1399,7 @@ manuals: - path: /docker-hub/deactivate-account/ title: Deactivate an account or an organization - path: /docker-hub/publish/ - title: Verified Publisher Program + title: Docker Verified Publisher Program - path: /docker-hub/release-notes/ title: Release notes - sectiontitle: Docker subscription diff --git a/_includes/footer.html b/_includes/footer.html index 26527fdc8c..bf160a257c 100644 --- a/_includes/footer.html +++ b/_includes/footer.html @@ -45,7 +45,7 @@
diff --git a/desktop/multi-arch.md b/desktop/multi-arch.md index f2addc9264..92775e29e0 100644 --- a/desktop/multi-arch.md +++ b/desktop/multi-arch.md @@ -14,7 +14,7 @@ operating systems, such as Windows. When running an image with multi-architecture support, `docker` automatically selects the image variant that matches your OS and architecture. -Most of the official images on Docker Hub provide a [variety of architectures](https://github.com/docker-library/official-images#architectures-other-than-amd64){: target="_blank" rel="noopener" class="_" }. +Most of the Docker Official Images on Docker Hub provide a [variety of architectures](https://github.com/docker-library/official-images#architectures-other-than-amd64){: target="_blank" rel="noopener" class="_" }. For example, the `busybox` image supports `amd64`, `arm32v5`, `arm32v6`, `arm32v7`, `arm64v8`, `i386`, `ppc64le`, and `s390x`. When running this image on an `x86_64` / `amd64` machine, the `x86_64` variant is pulled and run. diff --git a/develop/develop-images/baseimages.md b/develop/develop-images/baseimages.md index b0f2e76703..aa55716b08 100644 --- a/develop/develop-images/baseimages.md +++ b/develop/develop-images/baseimages.md @@ -102,7 +102,6 @@ This example creates the hello-world image used in the tutorials. If you want to test it out, you can clone [the image repo](https://github.com/docker-library/hello-world). - ## More resources There are lots of resources available to help you write your `Dockerfile`. @@ -110,4 +109,4 @@ There are lots of resources available to help you write your `Dockerfile`. * There's a [complete guide to all the instructions](../../engine/reference/builder.md) available for use in a `Dockerfile` in the reference section. * To help you write a clear, readable, maintainable `Dockerfile`, we've also written a [`Dockerfile` best practices guide](dockerfile_best-practices.md). -* If your goal is to create a new Official Image, be sure to read up on Docker's [Official Images](../../docker-hub/official_images.md). +* If your goal is to create a new Docker Official Image, read [Docker Official Images](../../docker-hub/official_images.md). diff --git a/develop/develop-images/dockerfile_best-practices.md b/develop/develop-images/dockerfile_best-practices.md index ec5c8a1b87..13523564e5 100644 --- a/develop/develop-images/dockerfile_best-practices.md +++ b/develop/develop-images/dockerfile_best-practices.md @@ -908,7 +908,7 @@ fails catastrophically if the new build's context is missing the resource being added. Adding a separate tag, as recommended above, helps mitigate this by allowing the `Dockerfile` author to make a choice. -## Examples for Official Images +## Examples of Docker Official Images These Official Images have exemplary `Dockerfile`s: @@ -922,6 +922,6 @@ These Official Images have exemplary `Dockerfile`s: * [Dockerfile Reference](../../engine/reference/builder.md) * [More about Base Images](baseimages.md) * [More about Automated Builds](../../docker-hub/builds/index.md) -* [Guidelines for Creating Official Images](../../docker-hub/official_images.md) +* [Guidelines for Creating Docker Official Images](../../docker-hub/official_images.md) * [Best practices to containerize Node.js web applications with Docker](https://snyk.io/blog/10-best-practices-to-containerize-nodejs-web-applications-with-docker){:target="_blank" rel="noopener" class="_"} diff --git a/docker-hub/index.md b/docker-hub/index.md index 12668bc7a8..9b93cbe634 100644 --- a/docker-hub/index.md +++ b/docker-hub/index.md @@ -87,9 +87,9 @@ Docker Hub provides the following major features: * [Repositories](repos.md): Push and pull container images. * [Teams & Organizations](orgs.md): Manage access to private repositories of container images. -* [Official Images](official_images.md): Pull and use high-quality +* [Docker Official Images](official_images.md): Pull and use high-quality container images provided by Docker. -* [Publisher Images](publish/customer_faq.md): Pull and use high- +* [Docker Verified Publisher Images](publish/index.md): Pull and use high- quality container images provided by external vendors. * [Builds](builds/index.md): Automatically build container images from GitHub and Bitbucket and push them to Docker Hub. diff --git a/docker-hub/official_images.md b/docker-hub/official_images.md index 76a92d76f5..63bf51b032 100644 --- a/docker-hub/official_images.md +++ b/docker-hub/official_images.md @@ -1,18 +1,18 @@ --- description: Guidelines for Official Images on Docker Hub keywords: Docker, docker, registry, accounts, plans, Dockerfile, Docker Hub, docs, official,image, documentation -title: Official Images on Docker Hub +title: Docker Official Images redirect_from: - /docker-hub/official_repos/ --- -The Docker [Official Images](https://hub.docker.com/search?q=&type=image&image_filter=official) are a +The [Docker Official Images](https://hub.docker.com/search?q=&type=image&image_filter=official){:target="_blank" rel="noopener" class="_"} are a curated set of Docker repositories hosted on Docker Hub. They are designed to: * Provide essential base OS repositories (for example, - [ubuntu](https://hub.docker.com/_/ubuntu/), - [centos](https://hub.docker.com/_/centos/)) that serve as the + [ubuntu](https://hub.docker.com/_/ubuntu/){:target="_blank" rel="noopener" class="_"}, + [centos](https://hub.docker.com/_/centos/){:target="_blank" rel="noopener" class="_"}) that serve as the starting point for the majority of users. * Provide drop-in solutions for popular programming language runtimes, data @@ -24,17 +24,17 @@ designed to: authors. * Ensure that security updates are applied in a timely manner. This is - particularly important as Official Images are some of the most + particularly important as Docker Official Images are some of the most popular on Docker Hub. Docker, Inc. sponsors a dedicated team that is responsible for reviewing and -publishing all content in the Official Images. This team works in +publishing all content in the Docker Official Images. This team works in collaboration with upstream software maintainers, security experts, and the broader Docker community. While it is preferable to have upstream software authors maintaining their -corresponding Official Images, this is not a strict requirement. Creating -and maintaining images for Official Images is a collaborative process. It takes +corresponding Docker Official Images, this is not a strict requirement. Creating +and maintaining images for Docker Official Images is a collaborative process. It takes place openly on GitHub where participation is encouraged. Anyone can provide feedback, contribute code, suggest process changes, or even propose a new Official Image. @@ -43,14 +43,14 @@ Official Image. > > Docker Official Images are an intellectual property of Docker. Distributing Docker Official Images without a prior agreement can constitute a violation of [Docker Terms of Service](https://www.docker.com/legal/docker-terms-service){: target="blank" rel="noopener" class=“”}. -## When to use Official Images +## When to use Docker Official Images -If you are new to Docker, we recommend that you use the Official Images in your +If you are new to Docker, we recommend that you use the Docker Official Images in your projects. These images have clear documentation, promote best practices, and are designed for the most common use cases. Advanced users can -review the Official Images as part of your `Dockerfile` learning process. +review Docker Official Images as part of your `Dockerfile` learning process. -A common rationale for diverging from Official Images is to optimize for +A common rationale for diverging from Docker Official Images is to optimize for image size. For instance, many of the programming language stack images contain a complete build toolchain to support installation of modules that depend on optimized code. An advanced user could build a custom image with just the @@ -64,39 +64,36 @@ insufficient, it is still recommended to inherit from an Official Image base OS image to leverage the ongoing maintenance work, rather than duplicating these efforts. -## Submitting Feedback for Official Images +## Submitting Feedback for Docker Official Images -All Official Images contain a **User Feedback** section in their +All Docker Official Images contain a **User Feedback** section in their documentation which covers the details for that specific repository. In most cases, the GitHub repository which contains the Dockerfiles for an Official Repository also has an active issue tracker. General feedback and support questions should be directed to `#docker-library` on [Libera.Chat IRC](https://libera.chat). -## Creating an Official Image +## Creating a Docker Official Image From a high level, an Official Image starts out as a proposal in the form of a set of GitHub pull requests. Detailed and objective proposal requirements are documented in the following GitHub repositories: -* [docker-library/official-images](https://github.com/docker-library/official-images) +* [docker-library/official-images](https://github.com/docker-library/official-images){:target="_blank" rel="noopener" class="_"} -* [docker-library/docs](https://github.com/docker-library/docs) +* [docker-library/docs](https://github.com/docker-library/docs){:target="_blank" rel="noopener" class="_"} -The Official Images team, with help from community contributors, formally +The Docker Official Images team, with help from community contributors, formally review each proposal and provide feedback to the author. This initial review process may require a bit of back-and-forth before the proposal is accepted. There are also subjective considerations during the review process. These subjective concerns boil down to the basic question: "is this image generally -useful?" For example, the [python](https://hub.docker.com/_/python/) -Official Image is "generally useful" to the larger Python developer +useful?" For example, the [python](https://hub.docker.com/_/python/){:target="_blank" rel="noopener" class="_"} +Docker Official Image is "generally useful" to the larger Python developer community, whereas an obscure text adventure game written in Python last week is not. Once a new proposal is accepted, the author is responsible for keeping their images up-to-date and responding to user feedback. The Official Repositories team becomes responsible for publishing the images and -documentation on Docker Hub. Updates to the Official Image follow the same -pull request process, though with less review. The Official Images team -ultimately acts as a gatekeeper for all changes, which helps mitigate the risk -of quality and security issues from being introduced. +documentation on Docker Hub. Updates to the Docker Official Image follow the same pull request process, though with less review. The Docker Official Images team ultimately acts as a gatekeeper for all changes, which helps mitigate the risk of quality and security issues from being introduced. diff --git a/docker-hub/publish/index.md b/docker-hub/publish/index.md index a9bee17488..075cd45adf 100644 --- a/docker-hub/publish/index.md +++ b/docker-hub/publish/index.md @@ -13,10 +13,10 @@ redirect_from: The Docker Verified and Publisher Program enables Independent Software Vendors (ISVs), development tools vendors, and platform providers to distribute Dockerized content through Docker Hub. -Development teams rely on Docker Hub for application components to build new applications. The Docker differentiated content programs like the [Official Images](../official_images.md) and the Verified Publishers provide developers with validation that these images come from trusted sources, reducing the risk of pulling malicious images from the impostor repositories. +Development teams rely on Docker Hub for application components to build new applications. The Docker differentiated content programs like the [Docker Official Images](../official_images.md) and the Docker Verified Publishers provide developers with validation that these images come from trusted sources, reducing the risk of pulling malicious images from the impostor repositories. -The Verified Publisher badge included on the Docker Hub repositories indicates that these repositories are published by Docker partners that are part of the Verified Publisher program, and are qualified to be included in the developer secure supply chain. You can limit your repository search, when you use the Verified Publisher filter. +The **Verified Publisher** badge included on the Docker Hub repositories indicates that these repositories are published by Docker partners that are part of the Verified Publisher program, and are qualified to be included in the developer secure supply chain. You can limit your repository search, when you use the 'Verified Publisher' filter. -To find out more about the Docker Verified and Publisher Program and to sign up for a partnership with Docker, visit the [Verified Publisher Program](https://www.docker.com/partners/programs){:target="_blank" rel="noopener" class="_"} page. +To find out more about the Docker Verified and Publisher Program and to sign up for a partnership with Docker, visit the [Docker Verified Publisher Program](https://www.docker.com/partners/programs){:target="_blank" rel="noopener" class="_"} page. ![Verification Badge](images/VerifiedPublisherBadge.png) \ No newline at end of file diff --git a/docker-hub/repos.md b/docker-hub/repos.md index 1b918c3cb0..b0d58a547c 100644 --- a/docker-hub/repos.md +++ b/docker-hub/repos.md @@ -171,7 +171,7 @@ 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, 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 images](official_images.md). The `/` character separates +[Docker Official Images](official_images.md). The `/` character separates a user's repository from the image name. Once you've found the image you want, you can download it with `docker pull `: diff --git a/engine/swarm/secrets.md b/engine/swarm/secrets.md index c7aacb8328..cddbafb236 100644 --- a/engine/swarm/secrets.md +++ b/engine/swarm/secrets.md @@ -947,7 +947,7 @@ adapting your image to take advantage of Docker secrets. One way to do this is to ensure that each parameter you pass to the image when creating the container can also be read from a file. -Many of the official images in the +Many of the Docker Official Images in the [Docker library](https://github.com/docker-library/), such as the [wordpress](https://github.com/docker-library/wordpress/) image used in the above examples, have been updated in this way. @@ -1028,4 +1028,3 @@ for that secret data. More information on short and long syntax for secrets can be found at [Compose file version 3 reference](../../compose/compose-file/compose-file-v3.md#secrets). -