Files
docker-cli/cli/command/node/cmd.go
Alano Terblanche ab3fcf9f9b Unexport node commands
This patch deprecates exported node commands and moves the implementation
details to an unexported function.

Commands that are affected include:

- node.NewNodeCommand

Signed-off-by: Alano Terblanche <18033717+Benehiko@users.noreply.github.com>
2025-08-20 12:34:49 +02:00

68 lines
1.8 KiB
Go

package node
import (
"context"
"errors"
"github.com/docker/cli/cli"
"github.com/docker/cli/cli/command"
"github.com/moby/moby/api/types/swarm"
"github.com/moby/moby/client"
"github.com/spf13/cobra"
)
// NewNodeCommand returns a cobra command for `node` subcommands
//
// Deprecated: Do not import commands directly. They will be removed in a future release.
func NewNodeCommand(dockerCLI command.Cli) *cobra.Command {
return newNodeCommand(dockerCLI)
}
// newNodeCommand returns a cobra command for `node` subcommands
func newNodeCommand(dockerCLI command.Cli) *cobra.Command {
cmd := &cobra.Command{
Use: "node",
Short: "Manage Swarm nodes",
Args: cli.NoArgs,
RunE: command.ShowHelp(dockerCLI.Err()),
Annotations: map[string]string{
"version": "1.24",
"swarm": "manager",
},
}
cmd.AddCommand(
newDemoteCommand(dockerCLI),
newInspectCommand(dockerCLI),
newListCommand(dockerCLI),
newPromoteCommand(dockerCLI),
newRemoveCommand(dockerCLI),
newPsCommand(dockerCLI),
newUpdateCommand(dockerCLI),
)
return cmd
}
// Reference returns the reference of a node. The special value "self" for a node
// reference is mapped to the current node, hence the node ID is retrieved using
// the `/info` endpoint.
func Reference(ctx context.Context, apiClient client.APIClient, ref string) (string, error) {
if ref == "self" {
info, err := apiClient.Info(ctx)
if err != nil {
return "", err
}
if info.Swarm.NodeID == "" {
// If there's no node ID in /info, the node probably
// isn't a manager. Call a swarm-specific endpoint to
// get a more specific error message.
_, err = apiClient.NodeList(ctx, swarm.NodeListOptions{})
if err != nil {
return "", err
}
return "", errors.New("node ID not found in /info")
}
return info.Swarm.NodeID, nil
}
return ref, nil
}