SDK exceptions

See Handle failures and unexpected state for recovery scenarios. Client API errors, transport errors, InterruptedError, and validation errors can also propagate. A nonzero process exit code is returned in InstanceResult by command execution. write_file() raises FileWriteError if its write command does not confirm success.

exception contree_sdk.exceptions.FailedOperationError(operation_uuid, error)

An operation reached a terminal non-SUCCESS status with no result at all.

A nonzero exit code is a normal InstanceResult, not an error - this is only raised for an operation-level failure (e.g. the VM couldn’t start).

add_note()

Exception.add_note(note) – add a note to the exception

args

with_traceback()

Exception.with_traceback(tb) – set self.__traceback__ to tb and return self.

exception contree_sdk.exceptions.DockerBuildError

A Dockerfile build step failed (nonzero RUN exit code, unresolvable stage/image reference, etc.).

add_note()

Exception.add_note(note) – add a note to the exception

args

with_traceback()

Exception.with_traceback(tb) – set self.__traceback__ to tb and return self.

exception contree_sdk.exceptions.FileWriteError(path, message)

A file could not be written to the executor’s filesystem.

add_note()

Exception.add_note(note) – add a note to the exception

args

with_traceback()

Exception.with_traceback(tb) – set self.__traceback__ to tb and return self.