mirror of https://github.com/docker/docs.git
chore: summary bar cleanup (#21887)
## Description - Updated "Contribute" guide to reference summary bars, added instructions for using them - Removed `introduced` partial, this is now replaced by the summary bar `requires` value - Updated all files using `introduced` partial to use summary bar, updated YAML file w/ feature name and info ## Related issues or tickets [ENGDOCS-2392](https://docker.atlassian.net/browse/ENGDOCS-2392) ## Reviews - [ ] Technical review - [ ] Editorial review [ENGDOCS-2392]: https://docker.atlassian.net/browse/ENGDOCS-2392?atlOrigin=eyJpIjoiNWRkNTljNzYxNjVmNDY3MDlhMDU5Y2ZhYzA5YTRkZjUiLCJwIjoiZ2l0aHViLWNvbS1KU1cifQ
This commit is contained in:
Sarah Sanders
GitHub
parent
04d0957128
commit
9f56d945a7
|
|
@ -6,18 +6,25 @@ toc_max: 3
|
|||
|
||||
We support these broad categories of callouts:
|
||||
|
||||
- Alerts (Note, Tip, Important, Warning, Caution)
|
||||
- Version callouts
|
||||
- Experimental, which use the `{{%/* experimental */%}}` shortcode
|
||||
- Restricted, which use the `{{%/* restricted */%}}` shortcode
|
||||
- Alerts: Note, Tip, Important, Warning, Caution
|
||||
|
||||
The experimental and restricted shortcodes take a title as an argument. The
|
||||
title is optional, defaults to "Experimental" or "Restricted" respectively, and
|
||||
is displayed in the callout.
|
||||
We also support summary bars, which represent a feature's required subscription, version, or Adminstrator role.
|
||||
To add a summary bar:
|
||||
|
||||
Add the feature name to the `/data/summary.yaml` file. Use the following attributes:
|
||||
|
||||
| Attribute | Description | Possible values |
|
||||
|----------------|--------------------------------------------------------|---------------------------------------------------------|
|
||||
| `subscription` | Notes the subscription required to use the feature | All, Personal, Pro, Team, Business |
|
||||
| `availability` | Notes what product development stage the feature is in | Experimental, Beta, Early access, GA, Retired |
|
||||
| `requires` | Notes what minimum version is required for the feature | No specific value, use a string to describe the version and link to relevant release notes |
|
||||
| `for` | Notes if the feature is intended for IT Administrators | Administrators |
|
||||
|
||||
Then, add the `summary-bar` shortcode on the page you want to add the summary bar to. Note, the feature name is case sensitive. The icons that appear in the summary bar are automatically rendered.
|
||||
|
||||
## Examples
|
||||
|
||||
{{< introduced buildx 0.16.0 >}}
|
||||
{{< summary-bar feature_name="PKG installer" >}}
|
||||
|
||||
> [!NOTE]
|
||||
>
|
||||
|
|
@ -54,18 +61,10 @@ is displayed in the callout.
|
|||
|
||||
For both of the following callouts, consult [the Docker release lifecycle](/release-lifecycle) for more information on when to use them.
|
||||
|
||||
{{% experimental title="Beta feature" %}}
|
||||
The Builds view is currently in Beta. This feature may change or be removed from future releases.
|
||||
{{% /experimental %}}
|
||||
|
||||
{{% restricted %}}
|
||||
Docker Scout is an [early access](/release-lifecycle/#early-access-ea) product.
|
||||
{{% /restricted %}}
|
||||
|
||||
## Formatting
|
||||
|
||||
```go
|
||||
{{</* introduced buildx 0.10.4 "../../release-notes.md#0104" */>}}
|
||||
> {{< summary-bar feature_name="PKG installer" >}}
|
||||
```
|
||||
|
||||
```html
|
||||
|
|
@ -102,13 +101,3 @@ Docker Scout is an [early access](/release-lifecycle/#early-access-ea) product.
|
|||
>
|
||||
> Here be dragons.
|
||||
```
|
||||
|
||||
```go
|
||||
{{%/* experimental title="Beta feature" */%}}
|
||||
The Builds view is currently in Beta. This feature may change or be removed from future releases.
|
||||
{{%/* /experimental */%}}
|
||||
|
||||
{{%/* restricted */%}}
|
||||
Docker Scout is an [early access](/release-lifecycle/#early-access-ea) product.
|
||||
{{%/* /restricted */%}}
|
||||
```
|
||||
|
|
|
|||
|
|
@ -66,7 +66,7 @@ To build an image using a non-default driver and load it to the image store,
|
|||
|
||||
### Load by default
|
||||
|
||||
{{< introduced buildx 0.14.0 >}}
|
||||
{{< summary-bar feature_name="Load by default" >}}
|
||||
|
||||
You can configure the custom build drivers to behave in a similar way to the
|
||||
default `docker` driver, and load images to the local image store by default.
|
||||
|
|
|
|||
|
|
@ -352,7 +352,7 @@ Setting `NO_COLOR` to anything turns off colorized output, as recommended by
|
|||
|
||||
### BUILDKIT_HOST
|
||||
|
||||
{{< introduced buildx 0.9.0 "../release-notes.md#090" >}}
|
||||
{{< summary-bar feature_name="Buildkit host" >}}
|
||||
|
||||
You use the `BUILDKIT_HOST` to specify the address of a BuildKit daemon to use
|
||||
as a remote builder. This is the same as specifying the address as a positional
|
||||
|
|
@ -438,7 +438,7 @@ Example:
|
|||
|
||||
### BUILDX_BAKE_GIT_AUTH_HEADER
|
||||
|
||||
{{< introduced buildx 0.14.0 >}}
|
||||
{{< summary-bar feature_name="Buildx bake Git auth token" >}}
|
||||
|
||||
Sets the HTTP authentication scheme when using a remote Bake definition in a private Git repository.
|
||||
This is equivalent to the [`GIT_AUTH_HEADER` secret](./secrets#http-authentication-scheme),
|
||||
|
|
@ -453,7 +453,7 @@ $ export BUILDX_BAKE_GIT_AUTH_HEADER=basic
|
|||
|
||||
### BUILDX_BAKE_GIT_AUTH_TOKEN
|
||||
|
||||
{{< introduced buildx 0.14.0 >}}
|
||||
{{< summary-bar feature_name="Buildx bake Git auth token" >}}
|
||||
|
||||
Sets the HTTP authentication token when using a remote Bake definition in a private Git repository.
|
||||
This is equivalent to the [`GIT_AUTH_TOKEN` secret](./secrets#git-authentication-for-remote-contexts),
|
||||
|
|
@ -467,7 +467,7 @@ $ export BUILDX_BAKE_GIT_AUTH_TOKEN=$(cat git-token.txt)
|
|||
|
||||
### BUILDX_BAKE_GIT_SSH
|
||||
|
||||
{{< introduced buildx 0.14.0 >}}
|
||||
{{< summary-bar feature_name="Buildx bake Git SSH" >}}
|
||||
|
||||
Lets you specify a list of SSH agent socket filepaths to forward to Bake
|
||||
for authenticating to a Git server when using a remote Bake definition in a private repository.
|
||||
|
|
@ -512,7 +512,7 @@ $ export BUILDX_CONFIG=/usr/local/etc
|
|||
|
||||
### BUILDX_CPU_PROFILE
|
||||
|
||||
{{< introduced buildx 0.18.0 >}}
|
||||
{{< summary-bar feature_name="Buildx CPU profile" >}}
|
||||
|
||||
If specified, Buildx generates a `pprof` CPU profile at the specified location.
|
||||
|
||||
|
|
@ -538,7 +538,7 @@ $ export BUILDX_EXPERIMENTAL=1
|
|||
|
||||
### BUILDX_GIT_CHECK_DIRTY
|
||||
|
||||
{{< introduced buildx 0.10.4 "../release-notes.md#0104" >}}
|
||||
{{< summary-bar feature_name="Buildx Git check dirty" >}}
|
||||
|
||||
When set to true, checks for dirty state in source control information for
|
||||
[provenance attestations](/manuals/build/metadata/attestations/slsa-provenance.md).
|
||||
|
|
@ -551,7 +551,7 @@ $ export BUILDX_GIT_CHECK_DIRTY=1
|
|||
|
||||
### BUILDX_GIT_INFO
|
||||
|
||||
{{< introduced buildx 0.10.0 "../release-notes.md#0100" >}}
|
||||
{{< summary-bar feature_name="Buildx Git info" >}}
|
||||
|
||||
When set to false, removes source control information from
|
||||
[provenance attestations](/manuals/build/metadata/attestations/slsa-provenance.md).
|
||||
|
|
@ -564,7 +564,7 @@ $ export BUILDX_GIT_INFO=0
|
|||
|
||||
### BUILDX_GIT_LABELS
|
||||
|
||||
{{< introduced buildx 0.10.0 "../release-notes.md#0100" >}}
|
||||
{{< summary-bar feature_name="Buildx Git labels" >}}
|
||||
|
||||
Adds provenance labels, based on Git information, to images that you build. The
|
||||
labels are:
|
||||
|
|
@ -593,7 +593,7 @@ If the repository is in a dirty state, the `revision` gets a `-dirty` suffix.
|
|||
|
||||
### BUILDX_MEM_PROFILE
|
||||
|
||||
{{< introduced buildx 0.18.0 >}}
|
||||
{{< summary-bar feature_name="Buildx mem profile" >}}
|
||||
|
||||
If specified, Buildx generates a `pprof` memory profile at the specified
|
||||
location.
|
||||
|
|
@ -610,7 +610,7 @@ $ export BUILDX_MEM_PROFILE=buildx_mem.prof
|
|||
|
||||
### BUILDX_NO_DEFAULT_ATTESTATIONS
|
||||
|
||||
{{< introduced buildx 0.10.4 "../release-notes.md#0104" >}}
|
||||
{{< summary-bar feature_name="Buildx no default" >}}
|
||||
|
||||
By default, BuildKit v0.11 and later adds
|
||||
[provenance attestations](/manuals/build/metadata/attestations/slsa-provenance.md) to images you
|
||||
|
|
|
|||
|
|
@ -184,7 +184,7 @@ WARNING: No output specified with docker-container driver.
|
|||
|
||||
## Multiple exporters
|
||||
|
||||
{{< introduced buildx 0.13.0 >}}
|
||||
{{< summary-bar feature_name="Build multiple exporters" >}}
|
||||
|
||||
You can use multiple exporters for any given build by specifying the `--output`
|
||||
flag multiple times. This requires **both Buildx and BuildKit** version 0.13.0
|
||||
|
|
|
|||
|
|
@ -172,7 +172,7 @@ If `COMPOSE_ENV_FILES` is not set, and you don't provide `--env-file` in the CLI
|
|||
|
||||
### COMPOSE\_MENU
|
||||
|
||||
{{< introduced compose 2.26.0 "/manuals/compose/releases/release-notes.md#2260" >}}
|
||||
{{< summary-bar feature_name="Compose menu" >}}
|
||||
|
||||
When enabled, Compose displays a navigation menu where you can choose to open the Compose stack in Docker Desktop, switch on [`watch` mode](../file-watch.md), or use [Docker Debug](/reference/cli/docker/debug.md).
|
||||
|
||||
|
|
@ -183,7 +183,7 @@ When enabled, Compose displays a navigation menu where you can choose to open th
|
|||
|
||||
### COMPOSE\_EXPERIMENTAL
|
||||
|
||||
{{< introduced compose 2.26.0 "/manuals/compose/releases/release-notes.md#2260" >}}
|
||||
{{< summary-bar feature_name="Compose experimental" >}}
|
||||
|
||||
This is an opt-out variable. When turned off it deactivates the experimental features such as the navigation menu or [Synchronized file shares](/manuals/desktop/features/synchronized-file-sharing.md).
|
||||
|
||||
|
|
|
|||
|
|
@ -7,7 +7,7 @@ aliases:
|
|||
- /compose/file-watch/
|
||||
---
|
||||
|
||||
{{< introduced compose 2.22.0 "/manuals/compose/releases/release-notes.md#2220" >}}
|
||||
{{< summary-bar feature_name="Compose file watch" >}}
|
||||
|
||||
{{% include "compose/watch.md" %}}
|
||||
|
||||
|
|
|
|||
|
|
@ -6,7 +6,7 @@ desription: How to use lifecycle hooks with Docker Compose
|
|||
keywords: cli, compose, lifecycle, hooks reference
|
||||
---
|
||||
|
||||
{{< introduced compose 2.30.0 "../releases/release-notes.md#2300" >}}
|
||||
{{< summary-bar feature_name="Compose lifecycle hooks" >}}
|
||||
|
||||
## Services lifecycle hooks
|
||||
|
||||
|
|
|
|||
|
|
@ -6,7 +6,7 @@ aliases:
|
|||
- /compose/multiple-compose-files/include/
|
||||
---
|
||||
|
||||
{{< introduced compose 2.20.3 "/manuals/compose/releases/release-notes.md#2203" >}}
|
||||
{{< summary-bar feature_name="Compose include" >}}
|
||||
|
||||
{{% include "compose/include.md" %}}
|
||||
|
||||
|
|
|
|||
|
|
@ -13,7 +13,7 @@ params:
|
|||
|
||||
{{< summary-bar feature_name="Docker Desktop CLI" >}}
|
||||
|
||||
The Docker Desktop CLI lets you perform key operations such as starting, stopping, restarting, and checking the status of Docker Desktop directly from the command line. It is available with Docker Desktop version 4.37 and later.
|
||||
The Docker Desktop CLI lets you perform key operations such as starting, stopping, restarting, and checking the status of Docker Desktop directly from the command line.
|
||||
|
||||
The Docker Desktop CLI provides:
|
||||
|
||||
|
|
|
|||
|
|
@ -51,7 +51,7 @@ See [Proxies](/manuals/desktop/settings-and-maintenance/settings.md#proxies)
|
|||
|
||||
### SOCKS5 proxy support
|
||||
|
||||
{{< introduced desktop 4.28.0 "../release-notes.md#4280" >}}
|
||||
{{< summary-bar feature_name="SOCKS5 proxy support" >}}
|
||||
|
||||
> [!NOTE]
|
||||
>
|
||||
|
|
|
|||
|
|
@ -9,9 +9,7 @@ aliases:
|
|||
- /desktop/setup/install/msi/install-and-configure/
|
||||
---
|
||||
|
||||
> [!NOTE]
|
||||
>
|
||||
> The MSI installer is available to all company and organization owners with a Business subscription and Docker Desktop version 4.32 and later.
|
||||
{{< summary-bar feature_name="MSI installer" >}}
|
||||
|
||||
The MSI package supports various MDM (Mobile Device Management) solutions, making it ideal for bulk installations and eliminating the need for manual setups by individual users. With this package, IT administrators can ensure standardized, policy-driven installations of Docker Desktop, enhancing efficiency and software management across their organizations.
|
||||
|
||||
|
|
|
|||
|
|
@ -6,6 +6,8 @@ tags: [admin]
|
|||
weight: 40
|
||||
---
|
||||
|
||||
{{< summary-bar feature_name="Jamf Pro" >}}
|
||||
|
||||
Learn how to deploy Docker Desktop for Mac using Jamf Pro.
|
||||
|
||||
First, upload the package:
|
||||
|
|
|
|||
|
|
@ -6,7 +6,7 @@ aliases:
|
|||
- /config/otel/
|
||||
---
|
||||
|
||||
{{< introduced engine 26.1.0 >}}
|
||||
{{< summary-bar feature_name="Docker CLI OpenTelemetry" >}}
|
||||
|
||||
The Docker CLI supports [OpenTelemetry](https://opentelemetry.io/docs/) instrumentation
|
||||
for emitting metrics about command invocations. This is disabled by default.
|
||||
|
|
|
|||
|
|
@ -138,7 +138,7 @@ ones in the repository.
|
|||
|
||||
### Docker Socket Mount Permissions for derived images
|
||||
|
||||
{{< introduced desktop 4.34.0 "../../../../desktop/release-notes.md#4340" >}}
|
||||
{{< summary-bar feature_name="Docker Scout Mount Permissions" >}}
|
||||
|
||||
As described in the prior section, administrators can configure the list of container
|
||||
images that are allowed to mount the Docker socket via the `imageList`.
|
||||
|
|
|
|||
|
|
@ -83,7 +83,7 @@ Alternatively `build` can be an object with fields defined as follows:
|
|||
|
||||
### `additional_contexts`
|
||||
|
||||
{{< introduced compose 2.17.0 "/manuals/compose/releases/release-notes.md#2170" >}}
|
||||
{{< summary-bar feature_name="Build additional contexts" >}}
|
||||
|
||||
`additional_contexts` defines a list of named contexts the image builder should use during image build.
|
||||
|
||||
|
|
@ -229,7 +229,7 @@ build:
|
|||
|
||||
### `dockerfile_inline`
|
||||
|
||||
{{< introduced compose 2.17.0 "/manuals/compose/releases/release-notes.md#2170" >}}
|
||||
{{< summary-bar feature_name="Build dockerfile inline" >}}
|
||||
|
||||
`dockerfile_inline` defines the Dockerfile content as an inlined string in a Compose file. When set, the `dockerfile`
|
||||
attribute is not allowed and Compose rejects any Compose file having both set.
|
||||
|
|
@ -246,7 +246,7 @@ build:
|
|||
|
||||
### `entitlements`
|
||||
|
||||
{{< introduced compose 2.27.1 "/manuals/compose/releases/release-notes.md#2271" >}}
|
||||
{{< summary-bar feature_name="Build entitlements" >}}
|
||||
|
||||
`entitlements` defines extra privileged entitlements to be allowed during the build.
|
||||
|
||||
|
|
@ -392,7 +392,7 @@ Composes reports an error in the following cases:
|
|||
|
||||
### `privileged`
|
||||
|
||||
{{< introduced compose 2.15.0 "/manuals/compose/releases/release-notes.md#2" >}}
|
||||
{{< summary-bar feature_name="Build privileged" >}}
|
||||
|
||||
`privileged` configures the service image to build with elevated privileges. Support and actual impacts are platform specific.
|
||||
|
||||
|
|
@ -555,7 +555,7 @@ build:
|
|||
|
||||
### `ulimits`
|
||||
|
||||
{{< introduced compose 2.23.1 "/manuals/compose/releases/release-notes.md#2231" >}}
|
||||
{{< summary-bar feature_name="Build ulimits" >}}
|
||||
|
||||
`ulimits` overrides the default `ulimits` for a container. It's specified either as an integer for a single limit
|
||||
or as mapping for soft/hard limits.
|
||||
|
|
|
|||
|
|
@ -64,7 +64,7 @@ Compose to monitor source code for changes. For more information, see [Use Compo
|
|||
|
||||
#### `exec`
|
||||
|
||||
{{< introduced compose 2.23.2 "/manuals/compose/releases/release-notes.md#2232" >}}
|
||||
{{< summary-bar feature_name="Compose exec" >}}
|
||||
|
||||
`exec` is only relevant when `action` is set to `sync+exec`. Like [service hooks](services.md#post_start), `exec` is used to define the command to be run inside the container once it has started.
|
||||
|
||||
|
|
|
|||
|
|
@ -7,7 +7,7 @@ aliases:
|
|||
weight: 110
|
||||
---
|
||||
|
||||
{{< introduced compose 2.20.0 "/manuals/compose/releases/release-notes.md#2200" >}}
|
||||
{{< summary-bar feature_name="Composefile include" >}}
|
||||
|
||||
A Compose application can declare dependency on another Compose application. This is useful if:
|
||||
- You want to reuse other Compose files.
|
||||
|
|
|
|||
|
|
@ -182,7 +182,7 @@ services:
|
|||
|
||||
### Replace value
|
||||
|
||||
{{< introduced compose 2.24.4 "/manuals/compose/releases/release-notes.md#2244" >}}
|
||||
{{< summary-bar feature_name="Compose replace file" >}}
|
||||
|
||||
While `!reset` can be used to remove a declaration from a Compose file using an override file, `!override` allows you
|
||||
to fully replace an attribute, bypassing the standard merge rules. A typical example is to fully replace a resource definition, to rely on a distinct model but using the same name.
|
||||
|
|
|
|||
|
|
@ -91,7 +91,7 @@ annotations:
|
|||
|
||||
### `attach`
|
||||
|
||||
{{< introduced compose 2.20.0 "/manuals/compose/releases/release-notes.md#2200" >}}
|
||||
{{< summary-bar feature_name="Compose attach" >}}
|
||||
|
||||
When `attach` is defined and set to `false` Compose does not collect service logs,
|
||||
until you explicitly request it to.
|
||||
|
|
@ -233,7 +233,7 @@ cap_drop:
|
|||
|
||||
### `cgroup`
|
||||
|
||||
{{< introduced compose 2.15.0 "/manuals/compose/releases/release-notes.md#2150" >}}
|
||||
{{< summary-bar feature_name="Compose cgroup" >}}
|
||||
|
||||
`cgroup` specifies the cgroup namespace to join. When unset, it is the container runtime's decision to
|
||||
select which cgroup namespace to use, if supported.
|
||||
|
|
@ -496,7 +496,7 @@ Compose guarantees dependency services marked with
|
|||
|
||||
### `develop`
|
||||
|
||||
{{< introduced compose 2.22.0 "/manuals/compose/releases/release-notes.md#2220" >}}
|
||||
{{< summary-bar feature_name="Compose develop" >}}
|
||||
|
||||
`develop` specifies the development configuration for maintaining a container in sync with source, as defined in the [Development Section](develop.md).
|
||||
|
||||
|
|
@ -567,7 +567,7 @@ dns_search:
|
|||
|
||||
### `driver_opts`
|
||||
|
||||
{{< introduced compose 2.27.1 "/manuals/compose/releases/release-notes.md#2271" >}}
|
||||
{{< summary-bar feature_name="Compose driver opts" >}}
|
||||
|
||||
`driver_opts` specifies a list of options as key-value pairs to pass to the driver. These options are
|
||||
driver-dependent.
|
||||
|
|
@ -643,7 +643,7 @@ attributes.
|
|||
|
||||
#### `required`
|
||||
|
||||
{{< introduced compose 2.24.0 "/manuals/compose/releases/release-notes.md#2240" >}}
|
||||
{{< summary-bar feature_name="Compose required" >}}
|
||||
|
||||
The `required` attribute defaults to `true`. When `required` is set to `false` and the `.env` file is missing, Compose silently ignores the entry.
|
||||
|
||||
|
|
@ -657,7 +657,7 @@ env_file:
|
|||
|
||||
#### `format`
|
||||
|
||||
{{< introduced compose 2.30.0 "/manuals/compose/releases/release-notes.md#2300" >}}
|
||||
{{< summary-bar feature_name="Compose format" >}}
|
||||
|
||||
The `format` attribute lets you use an alternative file format for the `env_file`. When not set, `env_file` is parsed according to the Compose rules outlined in [`Env_file` format](#env_file-format).
|
||||
|
||||
|
|
@ -1158,7 +1158,7 @@ results in a runtime error.
|
|||
|
||||
### `label_file`
|
||||
|
||||
{{< introduced compose 2.23.2 "/manuals/compose/releases/release-notes.md#2232" >}}
|
||||
{{< summary-bar feature_name="Compose label file" >}}
|
||||
|
||||
The `label_file` attribute lets you load labels for a service from an external file or a list of files. This provides a convenient way to manage multiple labels without cluttering the Compose file.
|
||||
|
||||
|
|
@ -1398,7 +1398,7 @@ networks:
|
|||
|
||||
#### `mac_address`
|
||||
|
||||
{{< introduced compose 2.23.2 "/manuals/compose/releases/release-notes.md#2232" >}}
|
||||
{{< summary-bar feature_name="Compose mac address" >}}
|
||||
|
||||
`mac_address` sets the Mac address used by the service container when connecting to this particular network.
|
||||
|
||||
|
|
@ -1552,7 +1552,7 @@ ports:
|
|||
|
||||
### `post_start`
|
||||
|
||||
{{< introduced compose 2.30.0 "../../manuals/compose/releases/release-notes.md#2300" >}}
|
||||
{{< summary-bar feature_name="Compose post start" >}}
|
||||
|
||||
`post_start` defines a sequence of lifecycle hooks to run after a container has started. The exact timing of when the command is run is not guaranteed.
|
||||
|
||||
|
|
@ -1577,7 +1577,7 @@ For more information, see [Use lifecycle hooks](/manuals/compose/how-tos/lifecyc
|
|||
|
||||
### `pre_stop`
|
||||
|
||||
{{< introduced compose 2.30.0 "../../manuals/compose/releases/release-notes.md#2300" >}}
|
||||
{{< summary-bar feature_name="Compose pre stop" >}}
|
||||
|
||||
`pre_stop` defines a sequence of lifecycle hooks to run before the container is stopped. These hooks won't run if the container stops by itself or is terminated suddenly.
|
||||
|
||||
|
|
@ -1874,7 +1874,7 @@ userns_mode: "host"
|
|||
|
||||
### `uts`
|
||||
|
||||
{{< introduced compose 2.15.1 "/manuals/compose/releases/release-notes.md#2151" >}}
|
||||
{{< summary-bar feature_name="Compose uts" >}}
|
||||
|
||||
`uts` configures the UTS namespace mode set for the service container. When unspecified
|
||||
it is the runtime's decision to assign a UTS namespace, if supported. Available values are:
|
||||
|
|
|
|||
|
|
@ -9,7 +9,7 @@ Admin orgs:
|
|||
subscription: [Team, Business]
|
||||
for: Administrators
|
||||
Air-gapped containers:
|
||||
requires: Docker Desktop 4.29.0 and later
|
||||
requires: Docker Desktop [4.29.0](/manuals/desktop/release-notes.md#4290) and later
|
||||
Allow list:
|
||||
for: Administrators
|
||||
Amazon S3 cache:
|
||||
|
|
@ -20,41 +20,113 @@ Automated builds:
|
|||
subscription: [Pro, Team, Business]
|
||||
Azure blob:
|
||||
availability: Experimental
|
||||
Build additional contexts:
|
||||
requires: Docker Compose [2.17.0](/manuals/compose/releases/release-notes.md#2170) and later
|
||||
Build bake:
|
||||
availability: Experimental
|
||||
Build checks:
|
||||
availability: Beta
|
||||
requires: Buildx v0.15.0 and later
|
||||
requires: Docker Buildx [0.15.0](/manuals/compose/releases/release-notes.md#0150) and later
|
||||
Build dockerfile inline:
|
||||
requires: Docker Compose [2.17.0](/manuals/compose/releases/release-notes.md#2170) and later
|
||||
Build entitlements:
|
||||
requires: Docker Compose [2.27.1](/manuals/compose/releases/release-notes.md#2271) and later
|
||||
Build multiple exporters:
|
||||
requires: Docker Buildx [0.13.0]((/manuals/build/release-notes.md#0130) and later
|
||||
Buildkit host:
|
||||
requires: Docker Buildx [0.9.0](/manuals/build/release-notes.md#090) and later
|
||||
Build privileged:
|
||||
requires: Docker Compose [2.15.0](/manuals/compose/releases/release-notes.md#2) and later
|
||||
Build ulimits:
|
||||
requires: Docker Compose [2.23.1](/manuals/compose/releases/release-notes.md#2231) and later
|
||||
Buildx bake Git auth token:
|
||||
requires: Docker Buildx [0.14.0](/manuals/build/release-notes.md#0140) and later
|
||||
Buildx bake Git SSH:
|
||||
requires: Docker Buildx [0.14.0](/manuals/build/release-notes.md#0140) and later
|
||||
Buildx CPU profile:
|
||||
requires: Docker Buildx [0.18.0](/manuals/build/release-notes.md#0180) and later
|
||||
Buildx Git check dirty:
|
||||
requires: Docker Buildx [0.10.4](/manuals/build/release-notes.md#0104) and later
|
||||
Buildx Git info:
|
||||
requires: Docker Buildx [0.10.0](/manuals/build/release-notes.md#0100) and later
|
||||
Buildx Git labels:
|
||||
requires: Docker Buildx [0.10.0](/manuals/build/release-notes.md#0100) and later
|
||||
Buildx mem profile:
|
||||
requires: Docker Buildx [0.18.0](/manuals/build/release-notes.md#0180) and later
|
||||
Buildx no default:
|
||||
requires: Docker Buildx [0.10.4](/manuals/build/release-notes.md#0104) and later
|
||||
Cache backend API:
|
||||
availability: Experimental
|
||||
Company:
|
||||
subscription: [Business]
|
||||
for: Administrators
|
||||
Compose attach:
|
||||
requires: Docker Compose [2.20.0](/manuals/compose/releases/release-notes.md#2200) and later
|
||||
Compose bridge:
|
||||
availability: Experimental
|
||||
Compose cgroup:
|
||||
requires: Docker Compose [2.15.0](/manuals/compose/releases/release-notes.md#2200) and later
|
||||
Compose develop:
|
||||
requires: Docker Compose [2.22.0](/manuals/compose/releases/release-notes.md#2220) and later
|
||||
Compose driver opts:
|
||||
requires: Docker Compose [2.27.1](/manuals/compose/releases/release-notes.md#2271) and later
|
||||
Compose exec:
|
||||
requires: Docker Compose [2.32.2](/manuals/compose/releases/release-notes.md#2232) and later
|
||||
Compose experimental:
|
||||
requires: Docker Compose [2.26.0](/manuals/compose/releases/release-notes.md#2260) and later
|
||||
Compose file watch:
|
||||
requires: Docker Compose [2.22.0](/manuals/compose/releases/release-notes.md#2220) and later
|
||||
Compose format:
|
||||
requires: Docker Compose [2.30.0](/manuals/compose/releases/release-notes.md#2300) and later
|
||||
Compose include:
|
||||
requires: Docker Compose [2.20.3](/manuals/compose/releases/release-notes.md#2203) and later
|
||||
Compose label file:
|
||||
requires: Docker Compose [2.32.2](/manuals/compose/releases/release-notes.md#2232) and later
|
||||
Compose lifecycle hooks:
|
||||
requires: Docker Compose [2.30.0](/manuals/compose/releases/release-notes.md#2300) and later
|
||||
Compose mac address:
|
||||
requires: Docker Compose [2.23.2](/manuals/compose/releases/release-notes.md#2232) and later
|
||||
Compose menu:
|
||||
requires: Docker Compose [2.26.0](/manuals/compose/releases/release-notes.md#2260) and later
|
||||
Compose replace file:
|
||||
requires: Docker Compose [2.24.4](/manuals/compose/releases/release-notes.md#2244) and later
|
||||
Compose required:
|
||||
requires: Docker Compose [2.24.0](/manuals/compose/releases/release-notes.md#2271) and later
|
||||
Compose post start:
|
||||
requires: Docker Compose [2.30.0](/manuals/compose/releases/release-notes.md#2300) and later
|
||||
Compose pre stop:
|
||||
requires: Docker Compose [2.30.0](/manuals/compose/releases/release-notes.md#2300) and later
|
||||
Compose uts:
|
||||
requires: Docker Compose [2.15.1](/manuals/compose/releases/release-notes.md#2151) and later
|
||||
Composefile include:
|
||||
requires: Docker Compose [2.20.0](/manuals/compose/releases/release-notes.md#2200) and later
|
||||
containerd:
|
||||
availability: Experimental
|
||||
Dev Environments:
|
||||
availability: Beta
|
||||
Docker Build Cloud:
|
||||
subscription: [Pro, Team, Business]
|
||||
Docker CLI OpenTelemetry:
|
||||
requires: Docker Engine [26.1.0](/manuals/engine/release-notes/26.1.md#2610) and later
|
||||
docker compose alpha:
|
||||
availability: Experimental
|
||||
Docker Desktop Archlinux:
|
||||
availability: Experimental
|
||||
Docker Desktop CLI:
|
||||
availability: Beta
|
||||
requires: Docker Desktop 4.37 and later
|
||||
requires: Docker Desktop [4.37](/manuals/desktop/release-notes.md#4370) and later
|
||||
Docker GitHub Copilot:
|
||||
availability: Early access
|
||||
Docker Scout exceptions:
|
||||
availability: Experimental
|
||||
requires: Docker Scout CLI 1.15.0 and later
|
||||
requires: Docker Scout CLI [1.15.0](/manuals/scout/release-notes/cli.md#1150) and later
|
||||
Docker Scout GitHub:
|
||||
availability: Beta
|
||||
Docker Scout health scores:
|
||||
subscription: [Pro, Team, Business]
|
||||
availability: Beta
|
||||
Docker Scout Mount Permissions:
|
||||
requires: Docker Desktop [4.34.0](/manuals/desktop/release-notes.md#4340) and later
|
||||
Domain audit:
|
||||
subscription: [Business]
|
||||
for: Administrators
|
||||
|
|
@ -70,7 +142,7 @@ Hardened Docker Desktop:
|
|||
for: Administrators
|
||||
Import builds:
|
||||
availability: Beta
|
||||
requires: Docker Desktop 4.31 and later
|
||||
requires: Docker Desktop [4.31](/manuals/desktop/release-notes.md#4310) and later
|
||||
Insights:
|
||||
subscription: [Business]
|
||||
for: Administrators
|
||||
|
|
@ -78,8 +150,10 @@ Intune:
|
|||
for: Administrators
|
||||
Jamf Pro:
|
||||
for: Administrators
|
||||
MSI Installer:
|
||||
availability: Docker Desktop 4.32 and later
|
||||
Load by default:
|
||||
requires: Docker Buildx [0.14.0](/manuals/build/release-notes.md#0140) and later
|
||||
MSI installer:
|
||||
requires: Docker Desktop [4.32](/manuals/desktop/release-notes.md#4320) and later
|
||||
for: Administrators
|
||||
OATs:
|
||||
subscription: [Team, Business]
|
||||
|
|
@ -87,7 +161,7 @@ OATs:
|
|||
PKG installer:
|
||||
subscription: [Business]
|
||||
availability: Early access
|
||||
requires: Docker Desktop 4.36 and later
|
||||
requires: Docker Desktop [4.36](/manuals/desktop/release-notes.md#4360) and later
|
||||
for: Administrators
|
||||
Private marketplace:
|
||||
availability: Beta
|
||||
|
|
@ -97,17 +171,19 @@ Remediation with Docker Scout:
|
|||
Registry access management:
|
||||
subscription: [Business]
|
||||
for: Administrators
|
||||
SOCKS5 proxy support:
|
||||
requires: Docker Desktop [4.28.0](/manuals/desktop/release-notes.md#4280) and later
|
||||
SSO:
|
||||
subscription: [Business]
|
||||
for: Administrators
|
||||
Synchronized file sharing:
|
||||
subscription: [Pro, Team, Business]
|
||||
requires: Docker Desktop 4.27 and later
|
||||
requires: Docker Desktop [4.27](/manuals/desktop/release-notes.md#4270) and later
|
||||
USB/IP support:
|
||||
requires: Docker Desktop 4.35.0 and later
|
||||
requires: Docker Desktop [4.35.0](/manuals/desktop/release-notes.md#4350) and later
|
||||
VMM:
|
||||
availability: Beta
|
||||
requires: Docker Desktop 4.35.0 and later
|
||||
requires: Docker Desktop [4.35.0](/manuals/desktop/release-notes.md#4350) and later
|
||||
Wasm workloads:
|
||||
availability: Beta
|
||||
Wasmtime:
|
||||
|
|
|
|||
11
hugo.yaml
11
hugo.yaml
|
|
@ -127,17 +127,6 @@ params:
|
|||
example_alpine_version: "3.21"
|
||||
example_node_version: "20"
|
||||
|
||||
# Minimum version thresholds (used together with the "introduced" shortcode
|
||||
# See layouts/shortcodes/introduced.html
|
||||
min_version_thresholds:
|
||||
buildx: "0.10.0"
|
||||
buildkit: "0.11.0"
|
||||
engine: "24.0.0"
|
||||
api: "1.41"
|
||||
desktop: "4.20.0"
|
||||
compose: "2.14.0"
|
||||
scout: "1.0.0"
|
||||
|
||||
menus:
|
||||
# Site header menu
|
||||
main:
|
||||
|
|
|
|||
17
i18n/en.yaml
17
i18n/en.yaml
|
|
@ -35,20 +35,3 @@ apiPropReq:
|
|||
other: Required
|
||||
apiPropDesc:
|
||||
other: Description
|
||||
|
||||
## component names
|
||||
|
||||
buildx:
|
||||
other: Buildx
|
||||
buildkit:
|
||||
other: BuildKit
|
||||
engine:
|
||||
other: Docker Engine
|
||||
api:
|
||||
other: Engine API
|
||||
desktop:
|
||||
other: Docker Desktop
|
||||
compose:
|
||||
other: Docker Compose
|
||||
scout:
|
||||
other: Docker Scout
|
||||
|
|
|
|||
|
|
@ -1,57 +0,0 @@
|
|||
{{- /*
|
||||
Renders a version callout for when a feature was introduced in a component.
|
||||
|
||||
Accepts positional parameters.
|
||||
Depends on site.Params.min_version_thresholds and i18n strings for component IDs
|
||||
|
||||
@param {string} component The ID of the component as defined in site config.
|
||||
@param {string} version The version of the component in which the thing was introduced.
|
||||
@param {string} [link] A relevant link to e.g. release note.
|
||||
|
||||
@returns {template.HTML}
|
||||
|
||||
@examples
|
||||
|
||||
{{< introduced buildx 0.12.0 "../release-notes.md#0120" >}}
|
||||
|
||||
{{< introduced desktop "4.28" "https://example.com/" >}}
|
||||
|
||||
*/ -}}
|
||||
|
||||
{{- $component := .Get 0 }}
|
||||
{{- $v := .Get 1 }}
|
||||
{{- $link := .Get 2 }}
|
||||
{{- $pos := .Position }}
|
||||
{{- with (index site.Params.min_version_thresholds $component) }}
|
||||
{{- /*
|
||||
Hacky semver comparison.
|
||||
|
||||
- Split the input version and threshold version strings
|
||||
- Range over the input version []string
|
||||
- Cast to ints and compare input with same index threshold []string
|
||||
- Set threshold false if input is lower than config, and break
|
||||
*/ -}}
|
||||
{{ $vslice := strings.Split $v "." }}
|
||||
{{ $tslice := strings.Split . "." }}
|
||||
{{ $versionAboveThreshold := true }}
|
||||
{{ range $i, $e := $vslice }}
|
||||
{{ if compare.Lt (cast.ToInt $e) (cast.ToInt (index $tslice $i)) }}
|
||||
{{ $versionAboveThreshold = false }}
|
||||
{{ break }}
|
||||
{{ end }}
|
||||
{{ end }}
|
||||
{{- if $versionAboveThreshold }}
|
||||
<div class="text-gray-light dark:text-gray-dark flex items-center gap-2">
|
||||
<span class="icon-svg flex items-center">{{ partialCached "icon.html" "chevron_right" "chevron_right" }}</span>
|
||||
<span>Introduced in {{ T $component }} version
|
||||
{{- if $link }}
|
||||
{{ page.RenderString (fmt.Printf `[%s](%s)` $v $link) }}
|
||||
{{- else }}
|
||||
{{ $v }}
|
||||
{{- end }}
|
||||
</span>
|
||||
</div>
|
||||
{{- end }}
|
||||
{{- else }}
|
||||
{{ errorf "[introduced] invalid component: %s %v" $component $pos }}
|
||||
{{- end }}
|
||||
|
|
@ -57,7 +57,7 @@
|
|||
{{ with $feature.requires }}
|
||||
<div class="flex items-center gap-1">
|
||||
<span class="font-bold">Requires:</span>
|
||||
<span>{{ . }}</span>
|
||||
<span>{{ . | markdownify }}</span>
|
||||
<span class="icon-svg">
|
||||
{{ partial "icon" $requiresIcon }}
|
||||
</span>
|
||||
|
|
|
|||
Loading…
Reference in New Issue