Cmd v1alpha1
apiVersion: tilt.dev/v1alpha1
import "github.com/tilt-dev/tilt/pkg/apis/core/v1alpha1"
Cmd
Cmd represents a process on the host machine.
When the process exits, we will make a best-effort attempt (within OS limitations) to kill any spawned descendant processes.
-
apiVersion: tilt.dev/v1alpha1
-
kind: Cmd
-
metadata (ObjectMeta)
-
spec (CmdSpec)
-
status (CmdStatus)
CmdSpec
CmdSpec defines how to run a local command.
-
args ([]string)
Command-line arguments. Must have length at least 1.
-
dir (string)
Process working directory.
If the working directory is not specified, the command is run in the default Tilt working directory.
-
disableSource (DisableSource)
Specifies how to disable this.
Points at a thing that can control whether something is disabled
-
disableSource.configMap (ConfigMapDisableSource)
Disabled by single ConfigMap value.
-
disableSource.configMap.key (string), required
The key where the enable/disable state is stored.
-
disableSource.configMap.name (string), required
The name of the ConfigMap
-
disableSource.everyConfigMap ([]ConfigMapDisableSource)
Disabled by multiple ConfigMap values, which must all be set to disabled to disable the object.
-
disableSource.everyConfigMap.key (string), required
The key where the enable/disable state is stored.
-
disableSource.everyConfigMap.name (string), required
The name of the ConfigMap
-
-
env ([]string)
Additional variables process environment.
Expressed as a C-style array of strings of the form [“KEY1=VALUE1”, “KEY2=VALUE2”, …].
Environment variables are layered on top of the environment variables that Tilt runs with.
-
readinessProbe (Probe)
Periodic probe of service readiness.
-
restartOn (RestartOnSpec)
Indicates objects that can trigger a restart of this command.
When a restart is triggered, Tilt will try to gracefully shutdown any currently running process, waiting for it to exit before starting a new process. If the process doesn’t shutdown within the allotted time, Tilt will kill the process abruptly.
Restarts can happen even if the command is already done.
Logs of the current process after the restart are discarded.
RestartOnSpec indicates the set of objects that can trigger a restart of this object.
-
restartOn.fileWatches ([]string)
FileWatches that can trigger a restart.
-
restartOn.uiButtons ([]string)
UIButtons that can trigger a restart.
-
-
startOn (StartOnSpec)
Indicates objects that can trigger a start/restart of this command.
Restarts behave the same as RestartOn. The key difference is that a Cmd with any StartOn triggers will not have its command run until its StartOn is satisfied.
StartOnSpec indicates the set of objects that can trigger a start/restart of this object.
-
startOn.uiButtons ([]string), required
UIButtons that can trigger a start/restart.
-
startOn.startAfter (Time)
StartAfter indicates that events before this time should be ignored.
Time is a wrapper around time.Time which supports correct marshaling to YAML and JSON. Wrappers are provided for many of the factory methods that the time package offers.
-
CmdStatus
CmdStatus defines the observed state of Cmd
Based loosely on ContainerStatus in Kubernetes
-
disableStatus (DisableStatus)
Details about whether/why this is disabled.
-
disableStatus.disabled (boolean), required
Whether this is currently disabled. Deprecated in favor of
State. -
disableStatus.lastUpdateTime (Time), required
The last time this status was updated.
Time is a wrapper around time.Time which supports correct marshaling to YAML and JSON. Wrappers are provided for many of the factory methods that the time package offers.
-
disableStatus.reason (string), required
The reason this status was updated.
-
disableStatus.state (string), required
Whether this is currently disabled (if known)
-
-
ready (boolean)
Specifies whether the command has passed its readiness probe.
Terminating the command does not change its Ready state.
Is always true when no readiness probe is defined.
-
running (CmdStateRunning)
Details about a running process.
-
terminated (CmdStateTerminated)
Details about a terminated process.
CmdStateTerminated is a terminated state of a local command.
-
terminated.exitCode (int32), required
Exit status from the last termination of the command
-
terminated.pid (int32), required
The process id of the command.
-
terminated.finishedAt (MicroTime)
Time at which the command last terminated
MicroTime is version of Time with microsecond level precision.
-
terminated.reason (string)
(brief) reason the process is terminated
-
terminated.startedAt (MicroTime)
Time at which previous execution of the command started
MicroTime is version of Time with microsecond level precision.
-
-
waiting (CmdStateWaiting)
Details about a waiting process.
CmdStateWaiting is a waiting state of a local command.
-
waiting.reason (string)
(brief) reason the process is not yet running.
-
CmdList
CmdList