Manifest Errors (M)

This section lists the error codes that are specific to Kubernetes manifest.

M001 Not a Kubernetes manifest

This error code is triggered when the input file does not look like a Kubernetes manifest.

M002 Unsupported manifest kind

The input manifest kind is not supported by the parser.

Tugboat is not designed to parse every possible Kubernetes resource. This error code is triggered when the parser encounters a manifest kind that is not supported by Tugboat.

M003 Malformed manifest

The input manifest does not conform to the expected format.

This error code is triggered when the parser encounters a general error in the manifest file. If the parser identifies a more specific issue, a more precise error code, such as M101 Missing required field, will be used instead.

M101 Missing required field

A mandatory field is missing from the resource.

For instance, the following manifest lacks the required source field within the script section:

apiVersion: argoproj.io/v1alpha1
kind: Workflow
metadata:
  generateName: hello-
spec:
  templates:
    - name: hello
      script:
        image: alpine:latest

M102 Found redundant field

The manifest contains an unexpected field.

For instance, the following manifest contains an extra field, extraField, within the root of the document:

apiVersion: argoproj.io/v1alpha1
kind: Workflow
metadata:
  generateName: hello-
spec:
  templates:
    - name: hello
      container:
        image: alpine:latest
extraField: value

M103 Type mismatch

The value of a field does not match the expected type.

The following manifest contains a number in entrypoint field, which is expected to be a string:

apiVersion: argoproj.io/v1alpha1
kind: Workflow
metadata:
  generateName: hello-
spec:
  entrypoint: 1234

M104 Invalid field value

The value of a field is not valid.

For instance, the following manifest contains an invalid value for the imagePullPolicy field:

apiVersion: argoproj.io/v1alpha1
kind: Workflow
metadata:
  generateName: hello-
spec:
  templates:
    - name: hello
      container:
        image: alpine:latest
        imagePullPolicy: InvalidValue

M201 Mutually exclusive fields

The manifest contains fields that are mutually exclusive.

For instance, the following manifest contains both script and container fields within the same template:

apiVersion: argoproj.io/v1alpha1
kind: Workflow
metadata:
  generateName: hello-
spec:
  templates:
    - name: hello
      script:
        image: alpine:latest
        source: |
          echo 'Hello, world!'
      container:
        image: alpine:latest

M202 Empty input

The field is empty while it is expected to have a value in current context.

For instance, the following manifest is missing the value in entrypoint field, which is required for a Workflow:

apiVersion: argoproj.io/v1alpha1
kind: Workflow
metadata:
  generateName: hello-
spec:
  entrypoint: ""
  templates:
    - name: hello
      script:
        image: alpine:latest

M301 Invalid resource name

The resource name contains invalid characters.

Kubernetes requires most resource names to comply with the RFC 1123 standard for DNS subdomain names [1]:

• Only lowercase alphanumeric characters, -, or .

• Must start with an alphanumeric character

• Must end with an alphanumeric character

apiVersion: argoproj.io/v1alpha1
kind: Workflow
metadata:
  name: invalid_name
spec:
  ...

In this example, the resource name invalid_name contains an underscore, which is not allowed.

[1]

Read Object Names and IDs for more details.

M302 Resource name length error

The resource name does not meet the required length criteria; it is either too long or too short.

For generated names, Kubernetes typically trims the user-provided name to fit within the length limit. However, tugboat requires that the user-provided name reserves 5 characters for the generated suffix to ensure it is not truncated.

For example, the following resource name is too long for a WorkflowTemplate, which has a maximum name length of 63 characters. This given name (59 characters) may cause the last character of the given name to be truncated:

apiVersion: argoproj.io/v1alpha1
kind: WorkflowTemplate
metadata:
  generateName: an-extreme-long-name-which-exceeds-the-maximum-name-length-
spec:
  ...