Built-in tools (original) (raw)

Gordon comes with an integrated toolbox providing access to various system tools and capabilities. These tools extend Gordon's functionality by allowing it to interact with the Docker Engine, Kubernetes, Docker Scout's security scanning, and other developer utilities. This documentation covers the available tools, their configuration, and usage patterns.

Tools can be configured globally in the toolbox, making them accessible throughout the Gordon interfaces, including both Docker Desktop and the CLI.

To configure:

  1. On the Ask Gordon view in Docker Desktop, select the Toolbox button in the bottom left of the input area.
    Gordon page with the toolbox button
    Gordon page with the toolbox button
  2. Choose the tools you want to make available. Selecting a card lets you view extra information regarding each tool and what it does.
    Gordon's Toolbox
    Gordon's Toolbox
    For more information on the possible tools, seeReference.

This section provides task-oriented examples for common operations with Gordon tools.

Managing Docker containers

List and monitor containers

Manage container lifecycle

Working with Docker images

Managing Docker volumes

Kubernetes operations

Security analysis

Development workflows

This section provides a comprehensive listing of the built-in tools you can find in Gordon's toolbox.

Docker tools

Tools to interact with your Docker containers, images, and volumes.

Container management

Name Description
list_containers List all Docker containers
remove_containers Remove one or more Docker containers
stop_container Stop a running Docker container
fetch_container_logs Retrieve logs from a Docker container
run_container Run a new Docker container

Volume management

Tool Description
list_volumes List all Docker volumes
remove_volume Remove a Docker volume
create_volume Create a new Docker volume

Image management

Tool Description
list_images List all Docker images
remove_images Remove Docker images
pull_image Pull an image from a registry
push_image Push an image to a registry
build_image Build a Docker image
tag_image Tag a Docker image
inspect Inspect a Docker object

Kubernetes tools

Tools to interact with your Kubernetes cluster

Pods

Tool Description
list_pods List all pods in the cluster
get_pod_logs Get logs from a specific pod

Deployment management

Tool Description
list_deployments List all deployments
create_deployment Create a new deployment
expose_deployment Expose a deployment as a service
remove_deployment Remove a deployment

Service management

Tool Description
list_services List all services
remove_service Remove a service

Cluster information

Tool Description
list_namespaces List all namespaces
list_nodes List all nodes in the cluster

Docker Scout tools

Security analysis tools powered by Docker Scout.

Tool Description
search_for_cves Analyze a Docker image, a project directory, or other artifacts for vulnerabilities using Docker Scout CVEs.search for cves
get_security_recommendations Analyze a Docker image, a project directory, or other artifacts for base image update recommendations using Docker Scout.

Developer tools

General-purpose development utilities.

Tool Description
fetch Retrieve content from a URL
get_command_help Get help for CLI commands
run_command Execute shell commands
filesystem Perform filesystem operations
git Execute git commands

AI model tools

Tool Description
list_models List all available AI models
pull_model Download an AI model
run_model Query a model with a prompt
remove_model Remove an AI model

AI Tool Catalog

When theAI Tool CatalogDocker Desktop extension is installed, all the tools enabled in the catalog are available for Gordon to use. After installation, you can enable the usage of the AI Tool Catalog tools in the toolbox section of Gordon.