github.com/containerd/nerdctl/v2@v2.0.0-beta.5.0.20240520001846-b5758f54fa28/pkg/cmd/container/start.go (about)

     1  /*
     2     Copyright The containerd Authors.
     3  
     4     Licensed under the Apache License, Version 2.0 (the "License");
     5     you may not use this file except in compliance with the License.
     6     You may obtain a copy of the License at
     7  
     8         http://www.apache.org/licenses/LICENSE-2.0
     9  
    10     Unless required by applicable law or agreed to in writing, software
    11     distributed under the License is distributed on an "AS IS" BASIS,
    12     WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
    13     See the License for the specific language governing permissions and
    14     limitations under the License.
    15  */
    16  
    17  package container
    18  
    19  import (
    20  	"context"
    21  	"fmt"
    22  
    23  	"github.com/containerd/containerd"
    24  	"github.com/containerd/nerdctl/v2/pkg/api/types"
    25  	"github.com/containerd/nerdctl/v2/pkg/containerutil"
    26  	"github.com/containerd/nerdctl/v2/pkg/idutil/containerwalker"
    27  )
    28  
    29  // Start starts a list of `containers`. If attach is true, it only starts a single container.
    30  func Start(ctx context.Context, client *containerd.Client, reqs []string, options types.ContainerStartOptions) error {
    31  	if options.Attach && len(reqs) > 1 {
    32  		return fmt.Errorf("you cannot start and attach multiple containers at once")
    33  	}
    34  
    35  	walker := &containerwalker.ContainerWalker{
    36  		Client: client,
    37  		OnFound: func(ctx context.Context, found containerwalker.Found) error {
    38  			var err error
    39  			if found.MatchCount > 1 {
    40  				return fmt.Errorf("multiple IDs found with provided prefix: %s", found.Req)
    41  			}
    42  			if err := containerutil.Start(ctx, found.Container, options.Attach, client, options.DetachKeys); err != nil {
    43  				return err
    44  			}
    45  			if !options.Attach {
    46  				_, err := fmt.Fprintln(options.Stdout, found.Req)
    47  				if err != nil {
    48  					return err
    49  				}
    50  			}
    51  			return err
    52  		},
    53  	}
    54  
    55  	return walker.WalkAll(ctx, reqs, true)
    56  }