github.1git.de/docker/cli@v26.1.3+incompatible/cli/command/swarm/init.go (about)

     1  package swarm
     2  
     3  import (
     4  	"context"
     5  	"fmt"
     6  	"net"
     7  	"strings"
     8  
     9  	"github.com/docker/cli/cli"
    10  	"github.com/docker/cli/cli/command"
    11  	"github.com/docker/cli/cli/command/completion"
    12  	"github.com/docker/docker/api/types/swarm"
    13  	"github.com/pkg/errors"
    14  	"github.com/spf13/cobra"
    15  	"github.com/spf13/pflag"
    16  )
    17  
    18  type initOptions struct {
    19  	swarmOptions
    20  	listenAddr NodeAddrOption
    21  	// Not a NodeAddrOption because it has no default port.
    22  	advertiseAddr             string
    23  	dataPathAddr              string
    24  	dataPathPort              uint32
    25  	forceNewCluster           bool
    26  	availability              string
    27  	defaultAddrPools          []net.IPNet
    28  	DefaultAddrPoolMaskLength uint32
    29  }
    30  
    31  func newInitCommand(dockerCli command.Cli) *cobra.Command {
    32  	opts := initOptions{
    33  		listenAddr: NewListenAddrOption(),
    34  	}
    35  
    36  	cmd := &cobra.Command{
    37  		Use:   "init [OPTIONS]",
    38  		Short: "Initialize a swarm",
    39  		Args:  cli.NoArgs,
    40  		RunE: func(cmd *cobra.Command, args []string) error {
    41  			return runInit(cmd.Context(), dockerCli, cmd.Flags(), opts)
    42  		},
    43  		Annotations: map[string]string{
    44  			"version": "1.24",
    45  			"swarm":   "", // swarm init does not require swarm to be active, and is always available on API 1.24 and up
    46  		},
    47  		ValidArgsFunction: completion.NoComplete,
    48  	}
    49  
    50  	flags := cmd.Flags()
    51  	flags.Var(&opts.listenAddr, flagListenAddr, `Listen address (format: "<ip|interface>[:port]")`)
    52  	flags.StringVar(&opts.advertiseAddr, flagAdvertiseAddr, "", `Advertised address (format: "<ip|interface>[:port]")`)
    53  	flags.StringVar(&opts.dataPathAddr, flagDataPathAddr, "", `Address or interface to use for data path traffic (format: "<ip|interface>")`)
    54  	flags.SetAnnotation(flagDataPathAddr, "version", []string{"1.31"})
    55  	flags.Uint32Var(&opts.dataPathPort, flagDataPathPort, 0, "Port number to use for data path traffic (1024 - 49151). If no value is set or is set to 0, the default port (4789) is used.")
    56  	flags.SetAnnotation(flagDataPathPort, "version", []string{"1.40"})
    57  	flags.BoolVar(&opts.forceNewCluster, "force-new-cluster", false, "Force create a new cluster from current state")
    58  	flags.BoolVar(&opts.autolock, flagAutolock, false, "Enable manager autolocking (requiring an unlock key to start a stopped manager)")
    59  	flags.StringVar(&opts.availability, flagAvailability, "active", `Availability of the node ("active", "pause", "drain")`)
    60  	flags.Var(newIPNetSliceValue([]net.IPNet{}, &opts.defaultAddrPools), flagDefaultAddrPool, "default address pool in CIDR format")
    61  	flags.SetAnnotation(flagDefaultAddrPool, "version", []string{"1.39"})
    62  	flags.Uint32Var(&opts.DefaultAddrPoolMaskLength, flagDefaultAddrPoolMaskLength, 24, "default address pool subnet mask length")
    63  	flags.SetAnnotation(flagDefaultAddrPoolMaskLength, "version", []string{"1.39"})
    64  	addSwarmFlags(flags, &opts.swarmOptions)
    65  	return cmd
    66  }
    67  
    68  func runInit(ctx context.Context, dockerCli command.Cli, flags *pflag.FlagSet, opts initOptions) error {
    69  	client := dockerCli.Client()
    70  
    71  	defaultAddrPool := make([]string, 0, len(opts.defaultAddrPools))
    72  	for _, p := range opts.defaultAddrPools {
    73  		defaultAddrPool = append(defaultAddrPool, p.String())
    74  	}
    75  	req := swarm.InitRequest{
    76  		ListenAddr:       opts.listenAddr.String(),
    77  		AdvertiseAddr:    opts.advertiseAddr,
    78  		DataPathAddr:     opts.dataPathAddr,
    79  		DataPathPort:     opts.dataPathPort,
    80  		DefaultAddrPool:  defaultAddrPool,
    81  		ForceNewCluster:  opts.forceNewCluster,
    82  		Spec:             opts.swarmOptions.ToSpec(flags),
    83  		AutoLockManagers: opts.swarmOptions.autolock,
    84  		SubnetSize:       opts.DefaultAddrPoolMaskLength,
    85  	}
    86  	if flags.Changed(flagAvailability) {
    87  		availability := swarm.NodeAvailability(strings.ToLower(opts.availability))
    88  		switch availability {
    89  		case swarm.NodeAvailabilityActive, swarm.NodeAvailabilityPause, swarm.NodeAvailabilityDrain:
    90  			req.Availability = availability
    91  		default:
    92  			return errors.Errorf("invalid availability %q, only active, pause and drain are supported", opts.availability)
    93  		}
    94  	}
    95  
    96  	nodeID, err := client.SwarmInit(ctx, req)
    97  	if err != nil {
    98  		if strings.Contains(err.Error(), "could not choose an IP address to advertise") || strings.Contains(err.Error(), "could not find the system's IP address") {
    99  			return errors.New(err.Error() + " - specify one with --advertise-addr")
   100  		}
   101  		return err
   102  	}
   103  
   104  	fmt.Fprintf(dockerCli.Out(), "Swarm initialized: current node (%s) is now a manager.\n\n", nodeID)
   105  
   106  	if err := printJoinCommand(ctx, dockerCli, nodeID, true, false); err != nil {
   107  		return err
   108  	}
   109  
   110  	fmt.Fprint(dockerCli.Out(), "To add a manager to this swarm, run 'docker swarm join-token manager' and follow the instructions.\n\n")
   111  
   112  	if req.AutoLockManagers {
   113  		unlockKeyResp, err := client.SwarmGetUnlockKey(ctx)
   114  		if err != nil {
   115  			return errors.Wrap(err, "could not fetch unlock key")
   116  		}
   117  		printUnlockCommand(dockerCli.Out(), unlockKeyResp.UnlockKey)
   118  	}
   119  
   120  	return nil
   121  }