Skip to content

Commit

Permalink
hub: add content library section
Browse files Browse the repository at this point in the history
Signed-off-by: Craig <[email protected]>
  • Loading branch information
craig-osterhout committed Dec 3, 2024
1 parent 868ef67 commit 79e1e17
Show file tree
Hide file tree
Showing 42 changed files with 397 additions and 184 deletions.
1 change: 1 addition & 0 deletions _vale/Docker/Acronyms.yml
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down
11 changes: 0 additions & 11 deletions content/_index.md
Original file line number Diff line number Diff line change
Expand Up @@ -80,17 +80,6 @@ grid:
url: "/scout/quickstart/"
- text: "Image analysis"
url: "/scout/image-analysis/"
- title: Trusted content
icon: verified
description: |
High-quality, secure images from Docker and verified partners.
links:
- text: "Overview"
url: "/trusted-content/"
- text: "Official images"
url: "/trusted-content/official-images/"
- text: "Verified publisher program"
url: "/trusted-content/dvp-program/"
- title: Subscription
icon: card_membership
description: |
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -188,10 +188,7 @@ In this walkthrough, you searched and pulled a Docker image. In addition to pull

The following resources will help you learn more about exploring, finding, and building images:

- [Docker Trusted Content](/manuals/trusted-content/_index.md)
- [Docker Official Images docs](/manuals/trusted-content/official-images/_index.md)
- [Docker Verified Publisher docs](/manuals/trusted-content/dvp-program.md)
- [Docker-Sponsored Open Source Program docs](/manuals/trusted-content/dsos-program.md)
- [Docker trusted content](/manuals/docker-hub/image-library/trusted-content.md)
- [Explore the Image view in Docker Desktop](/manuals/desktop/use-desktop/images.md)
- [Docker Build overview](/manuals/build/concepts/overview.md)
- [Docker Hub](https://hub.docker.com)
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -33,7 +33,7 @@ If you’re new to container images, think of them as a standardized package tha

To share your Docker images, you need a place to store them. This is where registries come in. While there are many registries, Docker Hub is the default and go-to registry for images. Docker Hub provides both a place for you to store your own images and to find images from others to either run or use as the bases for your own images.

In [Develop with containers](develop-with-containers.md), you used the following images that came from Docker Hub, each of which are [Docker Official Images](/trusted-content/official-images/):
In [Develop with containers](develop-with-containers.md), you used the following images that came from Docker Hub, each of which are [Docker Official Images](/manuals/docker-hub/image-library/trusted-content.md#docker-official-images):

- [node](https://hub.docker.com/_/node) - provides a Node environment and is used as the base of your development efforts. This image is also used as the base for the final application image.
- [mysql](https://hub.docker.com/_/mysql) - provides a MySQL database to store the to-do list items
Expand Down
34 changes: 34 additions & 0 deletions content/includes/hub-categories.md
Original file line number Diff line number Diff line change
@@ -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.
4 changes: 0 additions & 4 deletions content/manuals/_index.md
Original file line number Diff line number Diff line change
Expand Up @@ -76,10 +76,6 @@ params:
description: Commercial use licenses for Docker products.
icon: card_membership
link: /subscription/
- title: Trusted content
description: Curated, high-quality content from trusted sources.
icon: verified
link: /trusted-content/
---

This section contains user guides on how to install, set up, configure, and use
Expand Down
8 changes: 5 additions & 3 deletions content/manuals/build/building/base-images.md
Original file line number Diff line number Diff line change
Expand Up @@ -20,10 +20,12 @@ FROM debian

For most cases, you don't need to create your own base image. Docker Hub
contains a vast library of Docker images that are suitable for use as a base
image in your build. [Docker Official Images](../../trusted-content/official-images/_index.md)
image in your build. [Docker Official
Images](../../docker-hub/image-library/trusted-content.md#docker-official-images)
are specifically designed as a set of hardened, battle-tested images that
support a wide variety of platforms, languages, and frameworks. There are also
[Docker Verified Publisher](https://hub.docker.com/search?q=&image_filter=store)
[Docker Verified
Publisher](../../docker-hub/image-library/trusted-content.md#verified-publisher-images)
images, created by trusted publishing partners, verified by Docker.

## Create a base image
Expand Down Expand Up @@ -123,4 +125,4 @@ For more information about building images and writing Dockerfiles, see:

* [Dockerfile reference](/reference/dockerfile.md)
* [Dockerfile best practices](/manuals/build/building/best-practices.md)
* [Docker Official Images](../../trusted-content/official-images/_index.md)
* [Docker Official Images](../../docker-hub/image-library/trusted-content.md#docker-official-images)
2 changes: 1 addition & 1 deletion content/manuals/build/building/best-practices.md
Original file line number Diff line number Diff line change
Expand Up @@ -57,7 +57,7 @@ it small.

- [Docker-Sponsored Open Source](https://hub.docker.com/search?image_filter=open_source)
are published and maintained by open source projects sponsored by Docker
through an [open source program](../../trusted-content/dsos-program).
through an [open source program](../../docker-hub/image-library/trusted-content.md#docker-sponsored-open-source-software-images).

When you pick your base image, look out for the badges indicating that the
image is part of these programs.
Expand Down
4 changes: 4 additions & 0 deletions content/manuals/docker-hub/_index.md
Original file line number Diff line number Diff line change
Expand Up @@ -11,6 +11,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.
Expand Down
22 changes: 22 additions & 0 deletions content/manuals/docker-hub/image-library/_index.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,22 @@
---
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.
- [Trusted content](./trusted-content.md): Dive into Docker Official Images,
Verified Publisher content, and Sponsored Open Source images, all vetted for
security and reliability to streamline your workflows.
- [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.
58 changes: 58 additions & 0 deletions content/manuals/docker-hub/image-library/catalogs.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,58 @@
---
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](https://hub.docker.com/catalogs/gen-ai) makes it
easy to explore and 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

Check warning on line 40 in content/manuals/docker-hub/image-library/catalogs.md

View workflow job for this annotation

GitHub Actions / vale

[vale] reported by reviewdog 🐶 [Docker.Acronyms] 'NLP' has no definition. Raw Output: {"message": "[Docker.Acronyms] 'NLP' has no definition.", "location": {"path": "content/manuals/docker-hub/image-library/catalogs.md", "range": {"start": {"line": 40, "column": 15}}}, "severity": "WARNING"}
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)

Check warning on line 44 in content/manuals/docker-hub/image-library/catalogs.md

View workflow job for this annotation

GitHub Actions / vale

[vale] reported by reviewdog 🐶 [Docker.Acronyms] 'RAG' has no definition. Raw Output: {"message": "[Docker.Acronyms] 'RAG' has no definition.", "location": {"path": "content/manuals/docker-hub/image-library/catalogs.md", "range": {"start": {"line": 44, "column": 75}}}, "severity": "WARNING"}
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

Check warning on line 51 in content/manuals/docker-hub/image-library/catalogs.md

View workflow job for this annotation

GitHub Actions / vale

[vale] reported by reviewdog 🐶 [Docker.Acronyms] 'LLM' has no definition. Raw Output: {"message": "[Docker.Acronyms] 'LLM' has no definition.", "location": {"path": "content/manuals/docker-hub/image-library/catalogs.md", "range": {"start": {"line": 51, "column": 12}}}, "severity": "WARNING"}
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.
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down Expand Up @@ -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

Expand Down
152 changes: 152 additions & 0 deletions content/manuals/docker-hub/image-library/search.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,152 @@
---
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](https://hub.docker.com/search) 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.

## 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.

For more details, see [Trusted content](./trusted-content.md).

### 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.

Check warning on line 111 in content/manuals/docker-hub/image-library/search.md

View workflow job for this annotation

GitHub Actions / vale

[vale] reported by reviewdog 🐶 [Docker.RecommendedWords] Consider using 'lets' instead of 'allows' Raw Output: {"message": "[Docker.RecommendedWords] Consider using 'lets' instead of 'allows'", "location": {"path": "content/manuals/docker-hub/image-library/search.md", "range": {"start": {"line": 111, "column": 34}}}, "severity": "INFO"}

- **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.

Check failure on line 114 in content/manuals/docker-hub/image-library/search.md

View workflow job for this annotation

GitHub Actions / vale

[vale] reported by reviewdog 🐶 [Vale.Spelling] Did you really mean 'Nano'? Raw Output: {"message": "[Vale.Spelling] Did you really mean 'Nano'?", "location": {"path": "content/manuals/docker-hub/image-library/search.md", "range": {"start": {"line": 114, "column": 81}}}, "severity": "ERROR"}

> [!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

Check warning on line 131 in content/manuals/docker-hub/image-library/search.md

View workflow job for this annotation

GitHub Actions / vale

[vale] reported by reviewdog 🐶 [Docker.Acronyms] 'IBM' has no definition. Raw Output: {"message": "[Docker.Acronyms] 'IBM' has no definition.", "location": {"path": "content/manuals/docker-hub/image-library/search.md", "range": {"start": {"line": 131, "column": 5}}}, "severity": "WARNING"}

Check warning on line 131 in content/manuals/docker-hub/image-library/search.md

View workflow job for this annotation

GitHub Actions / vale

[vale] reported by reviewdog 🐶 [Docker.Acronyms] 'POWER' has no definition. Raw Output: {"message": "[Docker.Acronyms] 'POWER' has no definition.", "location": {"path": "content/manuals/docker-hub/image-library/search.md", "range": {"start": {"line": 131, "column": 9}}}, "severity": "WARNING"}

Check warning on line 131 in content/manuals/docker-hub/image-library/search.md

View workflow job for this annotation

GitHub Actions / vale

[vale] reported by reviewdog 🐶 [Docker.Acronyms] 'IBM' has no definition. Raw Output: {"message": "[Docker.Acronyms] 'IBM' has no definition.", "location": {"path": "content/manuals/docker-hub/image-library/search.md", "range": {"start": {"line": 131, "column": 44}}}, "severity": "WARNING"}
performance and reliability for enterprise workloads.
- **PowerPC 64 LE**: Access images designed for the little-endian PowerPC 64-bit

Check warning on line 133 in content/manuals/docker-hub/image-library/search.md

View workflow job for this annotation

GitHub Actions / vale

[vale] reported by reviewdog 🐶 [Docker.Acronyms] 'LE' has no definition. Raw Output: {"message": "[Docker.Acronyms] 'LE' has no definition.", "location": {"path": "content/manuals/docker-hub/image-library/search.md", "range": {"start": {"line": 133, "column": 16}}}, "severity": "WARNING"}
architecture.
- **IBM Z**: Discover images tailored for IBM Z mainframes, ensuring compatibility with enterprise-grade hardware.

Check warning on line 135 in content/manuals/docker-hub/image-library/search.md

View workflow job for this annotation

GitHub Actions / vale

[vale] reported by reviewdog 🐶 [Docker.Acronyms] 'IBM' has no definition. Raw Output: {"message": "[Docker.Acronyms] 'IBM' has no definition.", "location": {"path": "content/manuals/docker-hub/image-library/search.md", "range": {"start": {"line": 135, "column": 5}}}, "severity": "WARNING"}

Check warning on line 135 in content/manuals/docker-hub/image-library/search.md

View workflow job for this annotation

GitHub Actions / vale

[vale] reported by reviewdog 🐶 [Docker.Acronyms] 'IBM' has no definition. Raw Output: {"message": "[Docker.Acronyms] 'IBM' has no definition.", "location": {"path": "content/manuals/docker-hub/image-library/search.md", "range": {"start": {"line": 135, "column": 43}}}, "severity": "WARNING"}
- **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.
Loading

0 comments on commit 79e1e17

Please sign in to comment.