On macOS:

1. Install Homebrew
2. Install GitHub CLI: brew install gh
3. Install Terraform:
4. brew tap hashicorp/tap
5. brew install hashicorp/tap/terraform

 export TF_VAR_GITHUB_TOKEN=<GITHUB_TOKEN>
terraform import "github_repository.terraform-playground" "name-of-github-repository-resource"

• Repository:
  • Administration: read and write
  • Issues: read and write (voor labels)
  • Metadata: read only
  • Pages: read and write
• Organization:
  • Administration: read only
  • Members: read and write

You can login in to Terraform on app.terraform.io.

When you configure Terraform Cloud, you must configure use the user interface to configure the sensitive variables defined in variables.tf.

The following code is responsible for storing the Terraform state in the cloud:

  cloud {
    organization = "nl-design-system"

    workspaces {
      name = "github"
    }
  }

Removing this code should allow you to switch back to storing state in terraform.tfstate.

• provider: github
  • data source: github_organization
  • data source: github_user
  • resource: github_repository
  • resource: github_branch_protection
  • resource: github_repository_collaborators
  • resource: github_team
  • resource: github_team_members
• provider: vercel
  • resource: vercel_project

Most communities within the NL Design System use a standard structure for their permissions and teams.

An organisation (or repository) usually has three teams: Triage, Committer, Maintainer (also see the Github Documentation on permissions)

• organisation-triage
• organisation-committer
• organisation-maintainer

• Can create issues
• Can label issues

• All triage permissions
• Can push to repository
• Can merge pull requests (if conditions such as approvals are met)

• All committer permissions
• Add users (⚠️ Note: do not use this permission, always modify users through terraform)
• Review pull requests
• Work with the NL Design System Kernteam to add new members
• Create Github Milestones and modify labels

1. Add the github_user to user.tf.
2. Add the github_user as one of the members to the existing team in team-members.tf.

1. Create the github_team in team.tf.
2. Create a subteam github_team in team.tf, with people who should be able to make pull requests. Follow the team name pattern: organization-committer or organization-repository-committer. Specify parent_team_id to extend the organization team.
3. Create a subteam for maintainers the github_team in team.tf. Follow the team name pattern: organization-maintainer. Specify parent_team_id to extend the committer team.
4. Add each user as github_user to user.tf.
5. Add github_team_members for the new team in team-members.tf, and specify all users as members. Decide which users go into the committer team, and which users are in the maintainer team.
6. Add the organization-maintainer team to the terraform github_repository in terraform.tf, so the maintainers are able to make and review Pull Requests.