1
0
mirror of https://github.com/docker/docs.git synced 2026-10-25 06:09:46 +03:00
Files
docs/content/guides/lab-dhi-node.md
David Karlsson f02e2a5633 Revamp the guides section: taxonomy, single-page structure, and new landing/filter UX (#25338)
## What

A full revamp of the `/guides` section — taxonomy, structure, and UX.

Preview: https://deploy-preview-25338--docsdocker.netlify.app/guides/

### Taxonomy & structure
- Replaces the sprawling 24-tag set with a focused 9-tag taxonomy
aligned to use case / SDLC: **Languages & frameworks, AI, Testing,
CI/CD, Security, Databases, Deployment, Admin, Hands-on labs**.
- Removes the languages taxonomy entirely (`data/languages.yaml` and all
`languages:` front matter).
- Collapses all multi-page guide series into single pages, with aliases
so old sub-page URLs continue to resolve.
- Deletes redirect-only shim pages and flattens directory-wrapped single
pages.

### Landing page (`/guides/`)
- A clean index: hero, then category sections listing each guide as a
plain **title / summary** row.
- **Browse rail** (sticky, left): click a topic to filter the page to
just that topic's guides; "All guides" resets. A count + Clear bar
appears while filtering.
- **Text filter**: instant client-side search over title, summary, and
tags. Topic filter and text search are mutually exclusive and share the
same flat-list view.
- No more "Featured guides" section.

### Guide content pages
- Removes the left sidebar for the guides section (mobile drawer kept).
- Centered reading column (`92ch`) with the TOC taking the remaining
width.
- Summary rendered as a lead paragraph under the h1.
- TOC scrollbar auto-hides until hover; breadcrumbs render at a
consistent size inside and outside `prose`.

## Notes
- Deep full-text search across guide bodies is still handled by the
existing site-wide Pagefind (⌘K); the landing filter is the fast
metadata-narrowing surface.
- `series.html` is retained — it's still used by `get-started` pages.

## Validation
- Site builds clean locally (Hugo dev server, no errors / broken refs).
- All collapsed sub-page URLs redirect via aliases.

## Follow-ups

- Prune guides that we no longer need/want
- Tighten the guides that span too many concepts (e.g. language guides;
remove cicd/deploy/sscs)

🤖 Generated with [Claude Code](https://claude.com/claude-code)

---------

Co-authored-by: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-07-01 10:47:10 +02:00

2.5 KiB

title, linkTitle, description, summary, keywords, params
title linkTitle description summary keywords params
Lab: Migrating a Node App to Docker Hardened Images Lab: Migrating to DHI (Node) Migrate a Node.js application from a standard base image to Docker Hardened Images. Use Docker Scout to analyze CVEs, compare images, and inspect supply chain attestations. Hands-on lab: Replace a Node.js base image with a Docker Hardened Image. Analyze CVEs with Docker Scout, rewrite the Dockerfile to use multi-stage builds with DHI, and explore SBOMs, VEX, and compliance attestations. Docker, Hardened Images, DHI, Node.js, Docker Scout, CVE, security, SBOM, lab, labspace
tags time
labs
30 minutes

Migrate a Node.js application from a standard node:24-trixie-slim base image to a Docker Hardened Image. You'll measure the before-and-after impact on CVE count, image size, and policy compliance using Docker Scout, then explore the supply chain attestations DHI ships with every image.

Launch the lab

{{< labspace-launch image="dockersamples/labspace-dhi-node" >}}

What you'll learn

By the end of this Labspace, you will have completed the following:

  • Analyze a Node.js container image with Docker Scout to identify CVE and policy failures
  • Rewrite a Dockerfile to use a multi-stage build with DHI dev and runtime variants
  • Compare image size and vulnerability counts before and after the migration
  • Inspect supply chain attestations included with Docker Hardened Images (SBOMs, SLSA, VEX)
  • Export VEX documents for integration with external scanners such as Grype or Trivy

Modules

# Module Description
1 Introduction Overview of Docker Hardened Images and their security benefits
2 Setup Perform setup tasks required for the lab.
3 Analyzing the Starting Image Build the app, scan it with Docker Scout, and review failing policies
4 Migrating to DHI Rewrite the Dockerfile with multi-stage DHI build and compare results
5 DHI Attestations and Scanner Integration Inspect SBOMs, FIPS attestations, STIG scans, and export VEX for external tools