new Disabling Resources Through Tilt
💡 This feature is available in Tilt v0.24.0+.
For many developers, it’s not practical or feasible to run all your resources all the time. It shouldn’t interrupt your flow to change what resources you’re running, or disable a troublesome resource on the fly.
With the Tilt UI and
tilt args, you can enable and disable resources at any time and more seamlessly manage your resource catalog.
Disabling a resource will stop the running process (if any) and delete any objects owned by that resource. It’s the equivalent of running
tilt down on a specific resource. Enabling a resource will create, build, deploy, and start any processes for that resource.
How to enable and disable resources
You can use
tilt args to run a specific set of resources, as well as define groups of resources through the config API. Any resources defined through args will be enabled, while the rest of resources defined in your Tiltfile will be disabled and display in the Tilt UI. (See the Tiltfile config guide for more detail.)
From the Tilt UI, you can also enable and disable resources, but doing so won’t change value of
Here’s an example taken from Tilt’s pixeltilt project:
# enable only the resources named 'frontend' and 'glitch', # all other resources will be disabled and visible in the UI $ tilt up frontend glitch
To edit the args, you can run
tilt args with a new set of arguments that will replace the existing ones, or without a new set of arguments to open the current args for editing. See the args CLI reference for details.
# edit the current arts to enable only 'bounding-box,' # 'muxer,' and 'max-object-detector' $ tilt args bounding-box muxer max-object-detector
💡 Note: if your args don’t change between edits, Tilt will consider that a no-opt, even if you’ve enabled or disabled a different set of resources through the UI.
With the Tilt UI
In Detail View, look for the “Disable Resource” button on an individual resource near its logs. Logs will remain visible for disabled resources, along with an “Enable Resource” button.
In Table View, you can select multiple resources by clicking on the checkbox column and enable or disable them at once. The bulk action buttons will appear when any resource is selected.
Disabled resources will be listed at the bottom of resource groups (if you’re using labels to group resources) or the whole resource list in both Table View and Detail View.
💡 Note: Disabling and enabling a resource through the Tilt UI doesn’t take into account any of its resource dependencies. For example, if resource B depends on resource A, disabling resource A will not disable resource B.
With the Tilt CLI
# enable the resources named 'frontend' and 'storage' $ tilt enable frontend storage
# enable 'frontend' and 'storage', and disables all others $ tilt enable --only frontend storage
# enable all resources $ tilt enable --all
# disable the resources named 'frontend' and 'storage' $ tilt disable frontend storage
# disable all resources $ tilt disable --all
With your Tiltfile
To define a default or programmatic list of enabled resources, you can use the config built-ins from your Tiltfile. The Tiltfile config guide walks through detailed examples of enabling and configuring groups of resources.
To disable all resources by default, you can call
config.clear_enabled_resources() in your Tiltfile. This starts Tilt with all resources disabled and visible in the UI, where you can selectively enable what you need.
# from your Tiltfile config.clear_enabled_resources()
Does this feature work for you? We want to reduce the cognitive load of finding and running the right resources. Please reach out: