compose/pkg/api/errors.go
Guillaume Lours 0aff61809c run: trigger a job through the engine like a service
`docker compose run <job>` triggers a run of the job on the engine,
starts its dependencies first, streams its logs and returns its exit
code like a one-off service; a job accepts manual triggering unless it
declares manual: false. A scheduled job runs as up registered it: an
override, or a job up never registered, is refused. A manual job is
removed from the engine after its run, so the next run can differ. When
the engine cannot run jobs, run falls back to a one-off service with a
warning. --detach is refused, an interrupted run is cancelled, a dry run
only reports it. A job named by create, start, build, pull or push gets
an error naming run instead.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
Signed-off-by: Guillaume Lours <glours@users.noreply.github.com>
2026-11-17 13:48:57 +01:00

158 lines
5.8 KiB
Go

/*
Copyright 2020 Docker Compose CLI authors
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
*/
package api
import (
"errors"
"fmt"
)
const (
// ExitCodeLoginRequired exit code when command cannot execute because it requires cloud login
// This will be used by VSCode to detect when creating context if the user needs to login first
//
// Deprecated: Compose has no cloud login anymore and never exits with this code, it will be removed.
ExitCodeLoginRequired = 5
)
var (
// ErrNotFound is returned when an object is not found
ErrNotFound = errors.New("not found")
// ErrAlreadyExists is returned when an object already exists
//
// Deprecated: Compose never returns it, it will be removed.
ErrAlreadyExists = errors.New("already exists")
// ErrForbidden is returned when an operation is not permitted
//
// Deprecated: Compose never returns it, it will be removed.
ErrForbidden = errors.New("forbidden")
// ErrUnknown is returned when the error type is unmapped
//
// Deprecated: Compose never returns it, it will be removed.
ErrUnknown = errors.New("unknown")
// ErrNotImplemented is returned when a backend doesn't implement an action
ErrNotImplemented = errors.New("not implemented")
// ErrUnsupportedFlag is returned when a backend doesn't support a flag
//
// Deprecated: Compose never returns it, it will be removed.
ErrUnsupportedFlag = errors.New("unsupported flag")
// ErrCanceled is returned when the command was canceled by user
ErrCanceled = errors.New("canceled")
// ErrParsingFailed is returned when a string cannot be parsed
ErrParsingFailed = errors.New("parsing failed")
// ErrNoResources is returned when operation didn't selected any resource
ErrNoResources = errors.New("no resources")
// ErrIncompatibleOptions is returned when a set of options that cannot be
// honored together is requested. See IncompatibleOptionsError.
ErrIncompatibleOptions = errors.New("incompatible options")
// ErrNotRunning is returned when an operation targets a service, or a
// replica of it, that has no running container. See ServiceNotRunningError.
ErrNotRunning = errors.New("not running")
// ErrInvalidOption is returned when an option is set to a value it does
// not accept. See InvalidOptionError.
ErrInvalidOption = errors.New("invalid option")
// ErrJobsNotSupported is returned when a job operation requires an engine with usable jobs support (the jobs API and its extension enabled)
ErrJobsNotSupported = errors.New("jobs are not supported by the engine")
)
// IsNotFoundError returns true if the unwrapped error is ErrNotFound
func IsNotFoundError(err error) bool {
return errors.Is(err, ErrNotFound)
}
// IsAlreadyExistsError returns true if the unwrapped error is ErrAlreadyExists
//
// Deprecated: ErrAlreadyExists is never returned, it will be removed.
func IsAlreadyExistsError(err error) bool {
return errors.Is(err, ErrAlreadyExists)
}
// IsForbiddenError returns true if the unwrapped error is ErrForbidden
//
// Deprecated: ErrForbidden is never returned, it will be removed.
func IsForbiddenError(err error) bool {
return errors.Is(err, ErrForbidden)
}
// IsUnknownError returns true if the unwrapped error is ErrUnknown
//
// Deprecated: ErrUnknown is never returned, it will be removed.
func IsUnknownError(err error) bool {
return errors.Is(err, ErrUnknown)
}
// IsErrUnsupportedFlag returns true if the unwrapped error is ErrUnsupportedFlag
//
// Deprecated: ErrUnsupportedFlag is never returned, it will be removed.
func IsErrUnsupportedFlag(err error) bool {
return errors.Is(err, ErrUnsupportedFlag)
}
// IsErrNotImplemented returns true if the unwrapped error is ErrNotImplemented
func IsErrNotImplemented(err error) bool {
return errors.Is(err, ErrNotImplemented)
}
// IsErrParsingFailed returns true if the unwrapped error is ErrParsingFailed
func IsErrParsingFailed(err error) bool {
return errors.Is(err, ErrParsingFailed)
}
// IsErrCanceled returns true if the unwrapped error is ErrCanceled
func IsErrCanceled(err error) bool {
return errors.Is(err, ErrCanceled)
}
// IsErrIncompatibleOptions returns true if the unwrapped error is ErrIncompatibleOptions
func IsErrIncompatibleOptions(err error) bool {
return errors.Is(err, ErrIncompatibleOptions)
}
// ServiceNotRunningError reports that an operation which acts on one container
// of a service (exec, port, export, commit, attach…) found no matching
// container, that is no running one for most of them. It
// matches ErrNotRunning with errors.Is, and callers needing the details can
// retrieve it with errors.As.
type ServiceNotRunningError struct {
// Service is the name of the service that was targeted.
Service string
// Index is the replica that was asked for, 0 when none in particular was.
Index int
}
func (e *ServiceNotRunningError) Error() string {
if e.Index > 0 {
return fmt.Sprintf("service %q is not running container #%d", e.Service, e.Index)
}
return fmt.Sprintf("service %q is not running", e.Service)
}
// Unwrap makes errors.Is(err, ErrNotRunning) hold.
func (e *ServiceNotRunningError) Unwrap() error {
return ErrNotRunning
}
// IsErrNotRunning returns true if the unwrapped error is ErrNotRunning
func IsErrNotRunning(err error) bool {
return errors.Is(err, ErrNotRunning)
}
// IsErrInvalidOption returns true if the unwrapped error is ErrInvalidOption
func IsErrInvalidOption(err error) bool {
return errors.Is(err, ErrInvalidOption)
}