Skip to content

Gordon DHI migration #22885

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 5 commits into from
Jul 3, 2025
Merged
Show file tree
Hide file tree
Changes from 2 commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
15 changes: 11 additions & 4 deletions content/manuals/ai/gordon/_index.md
Original file line number Diff line number Diff line change
Expand Up @@ -20,7 +20,8 @@

## What is Ask Gordon?

Ask Gordon provides AI-powered assistance in Docker tools. It offers contextual help for tasks like:
Ask Gordon provides AI-powered assistance in Docker tools and can act as a DevSecOps agent.
It offers contextual help for tasks like:

- Improving Dockerfiles
- Running and troubleshooting containers
Expand Down Expand Up @@ -101,9 +102,10 @@

## Using Ask Gordon

The primary interfaces to Docker's AI capabilities are through the **Ask
Gordon** view in Docker Desktop, or if you prefer to use the CLI: the `docker
ai` CLI command.
You can access Gordon:

- In Docker Desktop, in the **Ask Gordon** view.
- Via the Docker CLI, with the `docker ai` CLI command.

Once you've enabled the Docker AI features, you'll also find references to **Ask
Gordon** in various other places throughout the Docker Desktop user interface.
Expand All @@ -119,6 +121,7 @@
- [Troubleshoot a crashed container](#troubleshoot-a-crashed-container)
- [Get help with running a container](#get-help-with-running-a-container)
- [Improve a Dockerfile](#improve-a-dockerfile)
- [Migrate a Dockerfile to DHI](#migrate-a-dockerfile-to-dhi)

Check warning on line 124 in content/manuals/ai/gordon/_index.md

View workflow job for this annotation

GitHub Actions / vale

[vale] reported by reviewdog 🐶 [Docker.Acronyms] 'DHI' has no definition. Raw Output: {"message": "[Docker.Acronyms] 'DHI' has no definition.", "location": {"path": "content/manuals/ai/gordon/_index.md", "range": {"start": {"line": 124, "column": 28}}}, "severity": "WARNING"}

For more examples, try asking Gordon directly. For example:

Expand Down Expand Up @@ -194,6 +197,10 @@
- Portability
- Resource efficiency

### Migrate a Dockerfile to DHI

Check warning on line 200 in content/manuals/ai/gordon/_index.md

View workflow job for this annotation

GitHub Actions / vale

[vale] reported by reviewdog 🐶 [Docker.Acronyms] 'DHI' has no definition. Raw Output: {"message": "[Docker.Acronyms] 'DHI' has no definition.", "location": {"path": "content/manuals/ai/gordon/_index.md", "range": {"start": {"line": 200, "column": 29}}}, "severity": "WARNING"}

See [Use Gordon AI](/manuals/dhi/how-to/migrate.md#use-gordon-ai) in the DHI section.

Check warning on line 202 in content/manuals/ai/gordon/_index.md

View workflow job for this annotation

GitHub Actions / vale

[vale] reported by reviewdog 🐶 [Docker.Acronyms] 'DHI' has no definition. Raw Output: {"message": "[Docker.Acronyms] 'DHI' has no definition.", "location": {"path": "content/manuals/ai/gordon/_index.md", "range": {"start": {"line": 202, "column": 74}}}, "severity": "WARNING"}

## Disable Ask Gordon

### For individual users
Expand Down
19 changes: 19 additions & 0 deletions content/manuals/dhi/how-to/migrate.md
Original file line number Diff line number Diff line change
Expand Up @@ -240,3 +240,22 @@

{{< /tab >}}
{{< /tabs >}}

### Use Gordon AI

Check warning on line 244 in content/manuals/dhi/how-to/migrate.md

View workflow job for this annotation

GitHub Actions / vale

[vale] reported by reviewdog 🐶 [Docker.HeadingSentenceCase] Use sentence case for headings: 'Use Gordon AI'. Raw Output: {"message": "[Docker.HeadingSentenceCase] Use sentence case for headings: 'Use Gordon AI'.", "location": {"path": "content/manuals/dhi/how-to/migrate.md", "range": {"start": {"line": 244, "column": 5}}}, "severity": "WARNING"}

Alternatively, you can request assistance to
[Gordon](/manuals/ai/gordon/_index.md), Docker's AI feature, to act as a DevSecOps Agent
and migrate your Dockerfile:

1. In the terminal, navigate to the directory containing your Dockerfile.
1. Run:

```bash
docker ai "Migrate my dockerfile to DHI"
```

1. Follow the conversation with Gordon. When it requests access to the filesystem,
type `yes` to enable it to update the file.

> [!IMPORTANT]
> As with any AI tool, you must verify Gordon's edits and test your image.