Skip to content

docs: rename runbook covers nested teams (child_team address) #85

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
pavlovic-ivan merged 1 commit into from
Sep 28, 2026
Merged

docs: rename runbook covers nested teams (child_team address) #85

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
8 changes: 6 additions & 2 deletions docs/renaming-teams-and-members.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -73,14 +73,18 @@ Prepare them now; merge neither yet.
### 2. Find every affected state address

```bash
terraform state list | grep -E 'github_team\.team|github_team_membership\.membership'
terraform state list | grep -E 'github_team\.(team|child_team)|github_team_membership\.membership'
```

You are looking for `github_team.team["Old Name"]` plus one `github_team_membership.membership["<username>/Old Name"]` for every member who lists the team in `organisation/members.yaml`.
You are looking for the team resource plus one `github_team_membership.membership["<username>/Old Name"]` for every member who lists the team in `organisation/members.yaml`.

> [!IMPORTANT]
> A **nested** team (one with a `parent`) lives at `github_team.child_team["Old Name"]`, not `github_team.team["Old Name"]` — top-level teams are `github_team.team`, nested teams are `github_team.child_team`. Use the address the team actually has in the move commands below. Everything else about the rename is identical.

### 3. Move them to the new key

```bash
# use github_team.child_team[...] on both sides for a nested team
terraform state mv 'github_team.team["Old Name"]' 'github_team.team["New Name"]'
```

Expand Down
Loading