docker · craig-osterhout · Nov 21, 2024
diff --git a/_vale/Docker/Acronyms.yml b/_vale/Docker/Acronyms.yml
@@ -9,6 +9,7 @@ second: '(?:\b[A-Z][a-z]+ )+\(([A-Z]{2,5})\)'
 # ... with the exception of these:
 exceptions:
   - AGPL
+  - AI
   - API
   - ARM
   - ASP

diff --git a/content/includes/hub-categories.md b/content/includes/hub-categories.md
@@ -0,0 +1,34 @@
+The categories include:
+
+- **API Management**: Tools for creating, publishing, analyzing, and securing
+  APIs.
+- **Content Management System:** Software applications to create and manage
+  digital content through templates, procedures, and standard formats.
+- **Data Science:** Tools and software to support analyzing data and generating
+  actionable insights.
+- **Databases & Storage:** Systems for storing, retrieving, and managing data.
+- **Languages & Frameworks:** Programming language runtimes and frameworks.
+- **Integrations & Delivery:** Tools for Continuous Integration (CI) and
+  Continuous Delivery (CD).
+- **Internet of Things:** Tools supporting Internet of Things (IoT)
+  applications.
+- **Machine Learning & AI:** Tools and frameworks optimized for artificial
+  intelligence and machine learning projects, such as pre-installed libraries
+  and frameworks for data analysis, model training, and deployment.
+- **Message Queues:** Message queuing systems optimized for reliable, scalable,
+  and efficient message handling.
+- **Monitoring & Observability:** Tools to track software and system performance
+  through metrics, logs, and traces, as well as observability to explore the
+  system’s state and diagnose issues.
+- **Networking:** Repositories that support data exchange and connecting
+  computers and other devices to share resources.
+- **Operating Systems:** Software that manages all other programs on a computer
+  and serves as an intermediary between users and the computer hardware, while
+  overseeing applications and system resources.
+- **Security:** Tools to protect a computer system or network from theft,
+  unauthorized access, or damage to their hardware, software, or electronic
+  data, as well as from service disruption.
+- **Web Servers:** Software to serve web pages, HTML files, and other assets to
+  users or other systems.
+- **Web Analytics:** Tools to collect, measure, analyze, and report on web data
+  and website visitor engagement.
@@ -8,6 +8,10 @@ grid:
   description: Step-by-step instructions on getting started on Docker Hub.
   icon: explore
   link: /docker-hub/quickstart
+- title: Library
+  description: Explore the container image library, featuring millions of images for operating systems, frameworks, databases, and more.
+  icon: book
+  link: /docker-hub/image-library/
 - title: Repositories
   description: Create a repository to share your images with your team, customers,
     or the Docker community.

@@ -0,0 +1,19 @@
+---
+description: Learn about Docker Hub's library of images, extensions, and plugins.
+keywords: Docker Hub, Hub, content library
+title: Container image library
+linkTitle: Library
+weight: 20
+---
+
+Docker Hub's container image library is the world's largest collection of
+container images, extensions, and plugins. It provides a central location to
+discover pre-built images and tools designed to streamline your container
+workflows, making it easier to share and collaborate.
+
+In this section, learn about:
+
+- [Search](./search.md): Discover how to browse and search Docker Hub's extensive resources.
+- [Catalogs](./catalogs.md): Explore specialized collections like the generative AI catalog.
+- [Mirroring](./mirror.md): Learn how to create a mirror of Docker Hub's
+  container image library as a pull-through cache.
@@ -0,0 +1,60 @@
+---
+description: Explore specialized Docker Hub collections like the Generative AI catalog.
+keywords: Docker Hub, Hub, catalog
+title: Docker Hub catalogs
+linkTitle: Catalogs
+weight: 60
+---
+
+Docker Hub catalogs are your go-to collections of trusted, ready-to-use
+container images and resources, tailored to meet specific development needs.
+They make it easier to find high-quality, pre-verified content so you can
+quickly build, deploy, and manage your applications with confidence. Catalogs in
+Docker Hub:
+
+- Simplify content discovery: Organized and curated content makes it easy to
+  discover tools and resources tailored to your specific domain or technology.
+- Reduce complexity: Trusted resources, vetted by Docker and its partners,
+  ensure security, reliability, and adherence to best practices.
+- Accelerate development: Quickly integrate advanced capabilities into your
+  applications without the hassle of extensive research or setup.
+
+The generative AI catalog is the first catalog in Docker Hub, offering
+specialized content for AI development.
+
+## Generative AI catalog
+
+The Generative AI catalog makes it easy to add AI capabilities to your
+applications. With trusted, ready-to-use content and comprehensive
+documentation, you can skip the hassle of sorting through countless tools and
+configurations. Instead, focus your time and energy on creating innovative
+AI-powered applications.
+
+The generative AI catalog provides a wide range of trusted content, organized
+into key areas to support diverse AI development needs:
+
+- Demos: Ready-to-deploy examples showcasing generative AI capabilities. These
+  demos provide a hands-on way to explore AI tools and frameworks, making it
+  easier to understand how they can be integrated into real-world applications.
+- Models: Pre-trained AI models for tasks like text generation, natural language
+  processing (NLP), and conversational AI. These models provide a foundation for
+  AI applications without requiring developers to train models from scratch.
+- Applications and end-to-end platforms: Comprehensive platforms and tools that
+  simplify AI application development, including low-code solutions and
+  frameworks for building multi-agent and retrieval-augmented generation (RAG)
+  applications.
+- Model deployment and serving: Tools and frameworks that enable developers to
+  efficiently deploy and serve AI models in production environments. These
+  resources include pre-configured stacks for GPUs and other specialized
+  hardware, ensuring performance at scale.
+- Orchestration: Solutions for managing complex AI workflows, such as workflow
+  engines, LLM application frameworks, and lifecycle management
+  tools, to help streamline development and operations.
+- Machine learning frameworks: Popular frameworks like TensorFlow and PyTorch
+  that provide the building blocks for creating, training, and fine-tuning
+  machine learning models.
+- Databases: Databases optimized for AI workloads, including vector databases
+  for similarity search, time-series databases for analytics, and NoSQL
+  solutions for handling unstructured data.
+
+{{< button url="https://hub.docker.com/catalogs/gen-ai" text="Open Gen AI catalog" >}}
@@ -2,12 +2,13 @@
 description: Setting-up a local mirror for Docker Hub images
 keywords: registry, on-prem, images, tags, repository, distribution, mirror, Hub,
   recipe, advanced
-title: Registry as a pull through cache
-linkTitle: Mirroring
+title: Mirror the Docker Hub library
+linkTitle: Mirror
 weight: 80
 aliases:
 - /engine/admin/registry_mirror/
 - /registry/recipes/mirror/
+- /docker-hub/mirror/
 ---
 
 ## Use-case
@@ -37,7 +38,7 @@ Hub can be mirrored.
 
 > [!NOTE]
 >
-> Mirrors of Docker Hub are still subject to Docker's [fair use policy](./download-rate-limit.md#fair-use).
+> Mirrors of Docker Hub are still subject to Docker's [fair use policy](/manuals/docker-hub/download-rate-limit.md#fair-use).
 
 ### Solution
 

@@ -0,0 +1,210 @@
+---
+description: Discover how to browse and search Docker Hub's extensive resources.
+keywords: Docker Hub, Hub, explore, search, image library
+title: Docker Hub search
+linkTitle: Search
+weight: 10
+---
+
+The Docker Hub search interface lets you explore millions of resources. To help
+you find exactly what you need, it offers a variety of filters that let you narrow
+your results or discover different types of content.
+
+{{< button url="https://hub.docker.com/search" text="Open Docker Hub search" >}}
+
+## Filters
+
+The search functionality includes filters to narrow down
+results based on your requirements, such as products, categories, and trusted
+content. This ensures that you can quickly find and access the resources best
+suited to your project.
+
+### Products
+
+Docker Hub's content library features three products, each designed to meet
+specific needs of developers and organizations. These products include images,
+plugins, and extensions.
+
+#### Images
+
+Docker Hub hosts millions of container images, making it the go-to repository
+for containerized applications and solutions. These images include:
+
+- Operating system images: Foundational images for Linux distributions like
+  Ubuntu, Debian, and Alpine, or Windows Server images.
+- Database and storage images: Pre-configured databases such as MySQL, PostgreSQL, and
+  MongoDB to simplify application development.
+- Languages and frameworks-based images: Popular images for Java, Python,
+  Node.js, Ruby, .NET, and more, offering pre-built environments for faster
+  development.
+
+Images in Docker Hub simplify the development process by providing pre-built,
+reusable building blocks, reducing the need to start from scratch. Whether
+you're a beginner building your first container or an enterprise managing
+complex architectures, Docker Hub images provide a reliable foundation.
+
+#### Plugins
+
+Plugins in Docker Hub let you extend and customize Docker Engine to suit
+specialized requirements. Plugins integrate directly with the Docker Engine and
+provide capabilities such as:
+
+- Network plugins: Enhance networking functionality, enabling integration with
+  complex network infrastructures.
+- Volume plugins: Provide advanced storage options, supporting persistent and
+  distributed storage across various backends.
+- Authorization plugins: Offer fine-grained access control to secure Docker
+  environments.
+
+By leveraging Docker plugins, teams can tailor Docker Engine to meet their
+specific operational needs, ensuring compatibility with existing infrastructures
+and workflows.
+
+To learn more about plugins, see [Docker Engine managed plugin
+system](/manuals/engine/extend/_index.md).
+
+#### Extensions
+
+Docker Hub offers extensions for Docker Desktop, which enhance its core
+functionality. These extensions are purpose-built to streamline the software
+development lifecycle. Extensions provide tools for:
+
+- System optimization and monitoring: Manage resources and optimize Docker
+  Desktop’s performance.
+- Container management: Simplify container deployment and monitoring.
+- Database management: Facilitate efficient database operations within
+  containers.
+- Kubernetes and cloud integration: Bridge local environments with cloud-native
+  and Kubernetes workflows.
+- Visualization tools: Gain insights into container resource usage through
+  graphical representations.
+
+Extensions help developers and teams create a more efficient and unified
+workflow by reducing context switching and bringing essential tools into Docker
+Desktop's interface.
+
+To learn more about extensions, see [Docker
+Extensions](/manuals/extensions/_index.md).
+
+### Trusted content
+
+Docker Hub's trusted content provides a curated selection of high-quality,
+secure images designed to give developers confidence in the reliability and
+security of the resources they use. These images are stable, regularly updated,
+and adhere to industry best practices, making them a strong foundation for
+building and deploying applications. Docker Hub's trusted content includes,
+Docker Official Images, Verified Publisher images, and Docker Sponsored Open
+Source Software images.
+
+#### Docker Official Images
+
+The Docker Official Images are a curated set of Docker repositories hosted on
+Docker Hub.
+
+> [!NOTE]
+>
+> Use of Docker Official Images is subject to [Docker's Terms of Service](https://www.docker.com/legal/docker-terms-service/).
+
+These images provide essential base repositories that serve as the starting
+point for the majority of users.
+
+These include operating systems such as
+[Ubuntu](https://hub.docker.com/_/ubuntu/) and
+[Alpine](https://hub.docker.com/_/alpine/), programming language runtimes such as
+[Python](https://hub.docker.com/_/python) and
+[Node](https://hub.docker.com/_/node), and other essential tools such as
+[memcached](https://hub.docker.com/_/memcached) and
+[MySQL](https://hub.docker.com/_/mysql).
+
+The images are some of the [most secure images](https://www.docker.com/blog/enhancing-security-and-transparency-with-docker-official-images/)
+on Docker Hub. This is particularly important as Docker Official Images are
+some of the most popular on Docker Hub. Typically, Docker Official images have
+few or no packages containing CVEs.
+
+The images exemplify [Dockerfile best practices](/manuals/build/building/best-practices.md)
+and provide clear documentation to serve as a reference for other Dockerfile authors.
+
+Images that are part of this program have a special badge on Docker Hub making
+it easier for you to identify projects that are part of Docker Official Images.
+
+![Docker official image badge](../images/official-image-badge-iso.png)
+
+#### Verified Publisher images
+
+The Docker Verified Publisher program provides high-quality images from
+commercial publishers verified by Docker.
+
+These images help development teams build secure software supply chains,
+minimizing exposure to malicious content early in the process to save time and
+money later.
+
+Images that are part of this program have a special badge on Docker Hub making
+it easier for users to identify projects that Docker has verified as
+high-quality commercial publishers.
+
+![Docker-Sponsored Open Source badge](./images/verified-publisher-badge-iso.png)
+
+#### Docker Sponsored Open Source Software images
+
+The Docker Sponsored Open Source Software (OSS) program provides images that are
+published and maintained by open-source projects sponsored by Docker.
+
+Images that are part of this program have a special badge on Docker Hub making
+it easier for users to identify projects that Docker has verified as trusted,
+secure, and active open-source projects.
+
+![Docker-Sponsored Open Source badge](images/sponsored-badge-iso.png)
+
+### Categories
+
+Docker Hub makes it easy to find and explore container images with categories.
+Categories group images based on their primary use case, helping you quickly
+locate the tools and resources you need to build, deploy, and run your
+applications.
+
+{{< include "hub-categories.md" >}}
+
+### Operating systems
+
+The **Operating systems** filter allows you to narrow your search to container images compatible with specific host operating systems. This filter ensures that the images you use align with your target environment, whether you're developing for Linux-based systems, Windows, or both.
+
+- **Linux**: Access a wide range of images tailored for Linux environments. These images provide foundational environments for building and running Linux-based applications in containers.
+- **Windows**: Explore Windows container images, such as Windows Server Core or Nano Server, which enable containerized Windows workloads.
+
+> [!NOTE]
+>
+> The **Operating systems** filter is only available for images. If you select the **Extensions** or
+> **Plugins** filter, then the **Operating systems** filter isn't available.
+
+### Architectures
+
+The **Architectures** filter lets you find images built to support specific CPU
+architectures. This ensures compatibility with your hardware environment, from
+development machines to production servers.
+
+- **ARM**: Select images compatible with ARM processors, commonly used in IoT
+  devices and embedded systems.
+- **ARM 64**: Locate 64-bit ARM-compatible images for modern ARM processors,
+  such as those in AWS Graviton or Apple Silicon.
+- **IBM POWER**: Find images optimized for IBM Power Systems, offering
+  performance and reliability for enterprise workloads.
+- **PowerPC 64 LE**: Access images designed for the little-endian PowerPC 64-bit
+  architecture.
+- **IBM Z**: Discover images tailored for IBM Z mainframes, ensuring compatibility with enterprise-grade hardware.
+- **x86**: Choose images compatible with 32-bit x86 architectures, suitable for
+  older systems or lightweight environments.
+- **x86-64**: Filter images for modern 64-bit x86 systems, widely used in
+  desktops, servers, and cloud infrastructures.
+
+> [!NOTE]
+>
+> The **Architectures** filter is only available for images. If you select the **Extensions** or
+> **Plugins** filter, then the **Architectures** filter isn't available.
+
+### Reviewed by Docker
+
+The **Reviewed by Docker** filter provides an extra layer of assurance when selecting extensions. This filter helps you identify whether a Docker Desktop extension has been reviewed by Docker for quality and reliability.
+
+- **Reviewed**: Extensions that have undergone Docker's review process, ensuring
+  they meet high standards.
+- **Not Reviewed**: Extensions that have not been reviewed by Docker.