Skip to content

docs: clarify relationship between this repo and the Seed Project #1019

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

Open
wants to merge 5 commits into
base: main
Choose a base branch
from
Open

docs: clarify relationship between this repo and the Seed Project #1019

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
5 commits
Select commit Hold shift + click to select a range
50b0a86
docs: add example commands for creating a seed project in GLOSSARY.md
sambilbow Nov 27, 2025
173c22f
docs: clarify instructions for enabling APIs in Seed Project
sambilbow Nov 27, 2025
acf7ef2
docs: update README to specify enabling APIs in existing Seed Project
sambilbow Nov 27, 2025
1f62b96
fix: pre-fill variables
sambilbow Nov 27, 2025
aad0c85
fix: grammar in existing documentation
sambilbow Nov 27, 2025
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
2 changes: 1 addition & 1 deletion README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -229,7 +229,7 @@ following roles:
A [helper script](./helpers/setup-sa.sh) is included to create the Seed Service
Account in the [Seed Project](https://github.com/terraform-google-modules/terraform-google-project-factory/blob/master/docs/GLOSSARY.md#seed-project),
grant the necessary roles to the [Seed Service Account](https://github.com/terraform-google-modules/terraform-google-project-factory/blob/master/docs/GLOSSARY.md#seed-service-account),
and enable the necessary API's in the Seed Project. Run it as follows:
and enable the necessary APIs in your existing Seed Project. Run it as follows:

```sh
./helpers/setup-sa.sh -o <organization id> -p <project id> [-b <billing account id>] [-f <folder id>] [-n <service account name>]
Expand Down
14 changes: 14 additions & 0 deletions docs/GLOSSARY.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -8,6 +8,20 @@ specific meaning within the domain of knowledge.
An existing GCP project with resources, services, and service accounts needed to
create projects with the project factory.

For a minimal working example of a seed project, create a project using the following command in the [Cloud Console](https://console.cloud.google.com/) or the [gcloud CLI](https://cloud.google.com/sdk/gcloud):
```bash
export FOLDER_ID="<YOUR_FOLDER_ID>"
export BILLING_ACCOUNT_ID="<YOUR_BILLING_ACCOUNT_ID>"
export SEED_PROJECT_ID="<YOUR_SEED_PROJECT_ID>"

gcloud projects create "$SEED_PROJECT_ID" \
--name="$SEED_PROJECT_ID" \
--folder="$FOLDER_ID"

gcloud billing projects link "$SEED_PROJECT_ID" \
--billing-account="$BILLING_ACCOUNT_ID"
```

## Seed Service Account

A service account in the **Seed Project** used to create **Target Projects**.
Expand Down