The Repo File

The repo file is used to configure global settings for a Git repository.

It should be placed in the root of the repository and should have the name repo.ocu.star.

The repo file can currently be used to configure:

• The id of the repository. This is used to reference the repository within Ocuroot state and from other repositories. It should be unique within your organization.
• Environments to be included in your Ocuroot organization.

As an example, the below repo file will define a single repository named my_repo and four environments: dev, staging, prod-us-east and prod-us-west:

load("github.com/ocuroot/sdk/v0/repo.star", "repo")
load("github.com/ocuroot/sdk/v0/environments.star", "environment")

repo(id="my_repo")

environment("dev", attributes={ "type": "dev" })
environment("staging", attributes={ "type": "staging" })
environment("prod-us-east", attributes={ "type": "prod" })
environment("prod-us-west", attributes={ "type": "prod" })

The environments defined in the repo file will be applied to the Ocuroot organization upon the next deliver operation containing the code change.