Tiltfile v1alpha1

apiVersion: tilt.dev/v1alpha1

import "github.com/tilt-dev/tilt/pkg/apis/core/v1alpha1"

Tiltfile

Tiltfile is the main way users add services to Tilt.

The Tiltfile evaluator executes the Tiltfile, then adds all the objects it creates as children of the Tiltfile object.


TiltfileSpec

TiltfileSpec defines the desired state of Tiltfile


  • path (string), required

    The path to the Tiltfile on disk.

  • args ([]string)

    Arguments to the Tiltfile.

    Arguments can be positional ([‘a’, ‘b’, ‘c’]) or flag-based (‘–to-edit=a’). By default, a list of arguments indicates the list of services in the tiltfile that should be enabled.

  • labels (map[string]string)

    A set of labels to apply to all objects owned by this Tiltfile.

  • restartOn (RestartOnSpec)

    Objects that can trigger a re-execution of this Tiltfile.

    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.

  • stopOn (StopOnSpec)

    Objects that can stop execution of this Tiltfile.

    **

    • stopOn.uiButtons ([]string), required

      UIButtons that can trigger a stop.

TiltfileStatus

TiltfileStatus defines the observed state of Tiltfile


  • running (TiltfileStateRunning)

    Details about a running tiltfile.

    TiltfileStateRunning is a running state of a tiltfile execution.

    • running.reasons ([]string)

      The reason why this tiltfile was built. May contain more than one reason.

    • running.startedAt (MicroTime)

      Time at which previous execution of the command started.

      MicroTime is version of Time with microsecond level precision.

  • terminated (TiltfileStateTerminated)

    Details about a terminated tiltfile.

    TiltfileStateTerminated is a terminated state of a tiltfile execution.

    • terminated.error (string)

      Error message if this tiltfile execution failed.

    • terminated.finishedAt (MicroTime)

      Time at which the command last terminated.

      MicroTime is version of Time with microsecond level precision.

    • terminated.reasons ([]string)

      The reasons why this tiltfile was built. May contain more than one reason.

    • terminated.startedAt (MicroTime)

      Time at which previous execution of the command started.

      MicroTime is version of Time with microsecond level precision.

    • terminated.warningCount (int32)

      Number of warnings generated by this Tiltfile. (brief) reason the process is terminated

  • waiting (TiltfileStateWaiting)

    Details about a waiting tiltfile.

    TiltfileStateWaiting is a waiting state of a tiltfile execution.

    • waiting.reason (string)

      (brief) reason the tiltfile is waiting.

TiltfileList

TiltfileList


  • apiVersion: tilt.dev/v1alpha1

  • kind: TiltfileList

  • metadata (ListMeta)

  • items ([]Tiltfile), required