Create a team
Many Tilt Cloud features are based on the concept of a Tilt team. Once you’ve signed in to Tilt Cloud, create a team by selecting the option at the top right, entering a team name, and clicking Create My Team. This will bring you to the team page of your new team. You are the team owner as a result. To navigate to an existing team that you own, hover over the Teams dropdown at the top right of the screen.
You can also change the team name on this page.
Associate team with multiple projects
Tilt is designed to have a single team be associated with one or more Tiltfiles in potentially multiple projects. As the team owner, after you’ve created a team, copy the team id (which is the string of text after
/team in the URL, e.g.
27d7ad9c-53f8-4700-80b8-b217eeb8effg), and enter it into each Tiltfile with the
set_team( ) function, for example:
Commit the changes to source control.
It’s a best practice to add the same team_id to as many Tiltfiles in your organization as possible, especially if you as a DevEx engineer, want to see all information aggregated across all those projects, together in one place.
Last seen versions
You’ll now see all folks who run Tilt across all projects with the updated Tiltfiles, appear on the team page, including when they last ran Tilt and the version they are using. Ask users to sign in to Tilt Cloud in Tilt for their name to appear on the team page. Otherwise, they will appear as anonymous.
Canary Tilt releases before your team upgrades
Tilt’s web UI will nudge users to upgrade when a new release is available, at the bottom right of the screen.
When running Tilt with a Tiltfile that specifies a team id, the default behavior is that users are only notified about Tilt releases once they’re one week old*.
However, the team’s owners are notified of Tilt releases as soon as they come out, giving them an opportunity to canary the new version before the rest of their team. If no action is taken, Tilt will begin notifying non-
Owners of a release once it’s a week old. (If
version_settings(check_updates=False) is set in the Tiltfile, users don’t get notified, regardless of their role.)
A team owner can choose to prompt their teammates to upgrade to new Tilt release sooner than a week. If they visit their team’s page on Tilt Cloud, they will find a button to “promote” the new version to their team. If they promote, all users (not just
Owners) will now start getting the version nudge corresponding to that latest Tilt version (the next time their Tilt checks for updates, which is on startup and hourly).
Add users to your team
New users on the team page will appear with the role
None as they run Tilt. A team owner (
Owner) can change any other user’s role to
Owner cannot change their own role. Only
Owners can change the team name. Both
Owners can view the team page.