Edit on GitHub

Teams

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.

New team

Associate team with a project

Tilt is designed to have a single team be associated with a single Tiltfile of a project. 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 your Tiltfile with the set_team( ) function, for example:

set_team('27d7ad9c-53f8-4700-80b8-b217eeb8effg')

Commit the change to source control.

Last seen versions

You’ll now see all folks who run Tilt with the updated Tiltfile, 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.

Last seen versions

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).

Promote Team Version

* For technical reasons, there is no 1-week waiting period on Tilt 0.13.5.

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 Member or Owner. An Owner cannot change their own role. Only Owners can change the team name. Both Members and Owners can view the team page.

 
 
 

Was this doc helpful?